Looker Action API מאפשר למפתחים להגדיר פעולות או יעדים מותאמים אישית שאליהם Looker יכול לשלוח תוצאות של שאילתות, תוצאות של לוחות בקרה או אינטראקציות של משתמשים.
אחרי שמפתחים פעולה, פורסים אותה כשירות אינטרנט ואז מוסיפים אותה למופע Looker, משתמשי Looker יכולים לשלוח נתונים באמצעות הפעולה הזו מתוך Looker. מידע נוסף מופיע בדף התיעוד בנושא שיתוף נתונים דרך מרכז פעולות.
שימוש בפעולות
Action API תומך במספר וריאציות של תרחישי שימוש:
- פעולות תומכות ברמות שונות של אינטראקטיביות עם המשתמשים. יכול להיות שהם מיועדים לאינטראקציות אד-הוק של משתמשים בזמן שהם צופים בלוח בקרה, או שהם מיועדים לפעול עם לוחות זמנים חוזרים או מופעלים.
- פעולות יכולות להנחות את Looker לאסוף נתוני טופס מהמשתמשים, כדי להגדיר פרמטרים לטיפול בנתונים.
- פעולות יכולות אפילו לבקש אימות משתמש בשירות של צד שלישי באמצעות OAuth, למשל כדי להעביר נתונים ליעדים ספציפיים למשתמש באופן מרומז.
- פעולות יכולות גם לקבל תוצאות של שאילתות בפורמטים שונים, החל מפורמטים מבוססי-נתונים כמו CSV ו-Excel, דרך פורמטים שונים של JSON לתרחישי שימוש פרוגרמטיים, ועד פורמטים מבוססי-ויזואליזציה כמו PNG או PDF.
תרחישי השימוש האלה מגוונים, אבל המשותף לכולם הוא שמשתמשי Looker יכולים להנחות את Looker ליצור קשר ולשלוח נתונים לפעולה.
לכן, הטמעה של פעולה כרוכה בפריסת שירות אינטרנט להאזנה לבקשות האלה.
אפשר לעשות את זה על ידי הוספה של כמה נקודות קצה חדשות לשרת אפליקציות קיים, פריסה של שרת אינטרנט למטרה הזו בלבד או אפילו שימוש בסביבה ללא שרת כמו פונקציות של Google Cloud Run. Action API לא מחייב את השירות לשמור על מצב כלשהו בין בקשות, כך ששרתי Action יכולים ליהנות מהגדרות פריסה גמישות וניתנות להרחבה ללא שמירת מצב.
לבסוף, מכיוון ש-Action API מורכב מבקשות HTTP POST בפורמט JSON, אפשר להשתמש בכל שפה בצד השרת כדי להטמיע פעולה. ב-Looker יש כמה דוגמאות ב-TypeScript, כולל הקוד בקוד פתוח של ActionHub.
רשימה של שירותים משולבים
ברשימה הבאה מפורטים השירותים שזמינים ב-Looker Action Hub.
כך משתמשים ברשימה:
- כתובות ה-URL שמופיעות בעמודה קישור לקובץ README מספקות הוראות להפעלה ולהגדרה של השירות המשולב כך שיפעל עם Looker.
- כתובות ה-URL שמוצגות בעמודה איך משתמשים בשילוב הזה מספקות הוראות לשליחת נתונים מ-Looker לשירות המשולב. חלק מהמאמרים האלה כוללים גם הוראות להפעלה.
- בקטע Required LookML tags (תגי LookML נדרשים) מפורטים כל התגים הנדרשים שצריך להשתמש בהם עם הפרמטר
tagsבמודל הבסיסי של התוכן. - סוג הפעולה מציין את רמת הנתונים שהשירות המשולב שולח: שדה, שאילתה או מרכז בקרה. פעולה ברמת השדה שולחת את הערך של תא יחיד שצוין בטבלת נתונים. פעולה ברמת השאילתה שולחת את התוצאות של שאילתה שלמה, כמו כל השורות ב-Explore או בטבלת Look. פעולה ברמת לוח הבקרה שולחת תמונה של לוח הבקרה.
- התוכן שזמין למשלוחים מתוזמנים מציין את סוג התוכן של Looker שהשירות המשולב הזה יכול לשלוח כמשלוח תוכן אד-הוק או מתוזמן.
- משתמש באימות Google OAuth: מציין אם השירות המשולב משתמש בפרטי כניסה של Google OAuth לצורך אימות. יכול להיות שלא תהיה אפשרות להפעיל מופעים באירוח בצד הלקוח מ-Looker Action Hub פעולות שמשתמשות ב-OAuth של Google. במאמר שיתוף נתונים דרך מרכז פעולות מפורטות הצעות לפתרון הבעיה הפוטנציאלית הזו.
- משתמש בהזרמת נתונים מציין אם השירות המשולב תומך בתוצאות שאילתה שמוזרמות. יכול להיות שלא תהיה אפשרות להפעיל במכונות באירוח בצד הלקוח פעולות מ-Looker Action Hub שמשדרות תוצאות. במאמר שיתוף נתונים דרך מרכז פעולות מפורטות הצעות לפתרון הבעיה הפוטנציאלית הזו.
- הגרסה המינימלית הנתמכת של Looker מציינת את הגרסה הכי מוקדמת של Looker שצריך להשתמש בה במופע כדי להשתמש באינטגרציה הזו.
| שירות משולב | תיאור | קישור לקובץ README | איך משתמשים בשילוב הזה | תגי LookML נדרשים | סוג הפעולה | תוכן שזמין למסירה מתוזמנת | האם נעשה שימוש באימות Google OAuth (כן/לא) | שימוש בסטרימינג של נתונים (כן/לא) | הגרסה המינימלית הנתמכת של Looker |
|---|---|---|---|---|---|---|---|---|---|
| Airtable | הוספת רשומות לטבלה ב-Airtable. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה | צפייה, חיפוש | לא | לא | 5.6 |
| Amazon SageMaker Infer | ביצוע הסקה באמצעות Amazon SageMaker. | אין קובץ README זמין | אין מאמר זמין | ללא | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| Amazon SageMaker Train: Linear Learner | מתחילים משימת אימון ב-Amazon SageMaker באמצעות אלגוריתם Linear Learner. | אין קובץ README זמין | אין מאמר זמין | ללא | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| Amazon SageMaker Train: Xgboost | מתחילים משימת אימון ב-Amazon SageMaker, באמצעות אלגוריתם Xgboost. | אין קובץ README זמין | אין מאמר זמין | ללא | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| Amazon Web Services EC2 Stop Instance | מפסיקים מכונת EC2 באמצעות Amazon EC2 API. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | aws_resource_id | שדה, שאילתה | צפייה, חיפוש | לא | לא | 5.6 |
| מקדח אוגר | שימוש בתוצאת שאילתה כדי לבנות מודל חיזוי. | צפייה בקובץ ה-README ב-GitHub | קובץ README | ללא | שאילתה | צפייה, חיפוש | לא | כן | 5.24 |
| Azure Storage | שליחה ואחסון של קובץ נתונים ב-Azure Storage. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | לא | כן (לשאילתות), לא (למרכזי בקרה) | 5.6 |
| Braze | הפעולה Braze מאפשרת לסמן משתמשים ב-Braze באמצעות נקודת קצה ל-API בארכיטקטורת REST מתוך Look. מוודאים שמופיע שדה braze_id עם תג בתוצאות. מקסימום ייצוא: 10,000. |
צפייה בקובץ ה-README ב-GitHub | קובץ README | braze_id | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| DigitalOcean — Stop Droplet | מפסיקים את התהליך של DigitalOcean באמצעות DigitalOcean API. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | digitalocean_droplet_id | שדה, שאילתה | צפייה, חיפוש | לא | לא | 5.6 |
| DigitalOcean Spaces | שליחה של קובץ נתונים לאחסון ב-DigitalOcean ושמירה שלו שם. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | לא | כן (בטבלאות Look וב-Explore), לא (בלוחות בקרה) | 5.6 |
| Dropbox | שליחה ואחסון של קובץ נתונים ב-Dropbox. | אין קובץ README זמין | לעיון במסמכי התיעוד | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | כן | לא | 6.8 |
| קהלים בהתאמה אישית ב-Facebook | העלאת נתונים אל Facebook Ads Custom Audiences מתוך רשימת לקוחות. | צפייה בקובץ ה-README ב-GitHub | קובץ README | ללא | שאילתה | צפייה, חיפוש | כן | כן | 6.10 |
| Firebase | שימוש ב-Firebase לשליחת הודעות פוש לנייד. | אין קובץ README זמין | אין מאמר זמין | ללא | שאילתה | צפייה, חיפוש | לא | לא | 22.4 |
| התאמה ללקוחות ב-Google Ads | העלאת נתונים ל'התאמה ללקוחות' ב-Google Ads. | צפייה בקובץ ה-README ב-GitHub | לעיון במסמכי התיעוד | ללא | שאילתה | צפייה, חיפוש | כן | כן | 6.10 |
| ייבוא נתונים ב-Google Analytics | מעלים נתונים למערך נתונים ב-Google Analytics. | צפייה בקובץ ה-README ב-GitHub | קובץ README | ללא | שאילתה | צפייה, חיפוש | כן | כן | 6.10 |
| Google Cloud Storage | כתיבת קובצי נתונים לקטגוריה של Google Cloud Storage. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | לא | כן (בטבלאות Look וב-Explore), לא (בלוחות בקרה) | 5.6 |
| Google Drive | שליחת נתונים ל-Google Drive. | אין קובץ README זמין | לעיון במסמכי התיעוד | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | כן | כן (בטבלאות Look וב-Explore), לא (בלוחות בקרה) | 7.4 |
| Google Sheets | שליחת נתונים בפורמט CSV לגיליון אלקטרוני ב-Google Sheets. | אין קובץ README זמין | לעיון במסמכי התיעוד | ללא | שאילתה | צפייה, חיפוש | כן | כן | 7.4 |
| Hubspot Companies | מוסיפים מאפיינים לחברות באמצעות Hubspot V3 API. | צפייה בקובץ ה-README ב-GitHub | קובץ README | hubspot_company_id | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| אנשי קשר ב-Hubspot | הוספת נכסים לאנשי הקשר באמצעות Hubspot V3 API. | צפייה בקובץ ה-README ב-GitHub | קובץ README | hubspot_contact_id | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| Kloudio | מוסיפים נתונים לגיליון אלקטרוני ב-Google Sheets. | צפייה בקובץ ה-README ב-GitHub | קובץ README | ללא | שאילתה | צפייה, חיפוש | לא | לא | 5.6 |
| mParticle | ייצוא בכמות גדולה של נתוני משתמשים או נתוני אירועים מ-Looker ל-mParticle. | צפייה בקובץ ה-README ב-GitHub | קובץ README | קובץ README | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| קמפיינים ב-Salesforce | הוספה של אנשי קשר או לידים לקמפיין ב-Salesforce. | צפייה בקובץ ה-README ב-GitHub | קובץ README | sfdc_contact_id או sfdc_lead_id | שאילתה | צפייה, חיפוש | כן | לא | 22.6 |
| קבוצת פלחים | מוסיפים מאפיינים או משתמשים לקבוצות הפלחים. | צפייה בקובץ ה-README ב-GitHub | לעיון במסמכי התיעוד | segment_group_id ו-user_id, או segment_group_id ו-segment_anonymous_id | שאילתה | צפייה, חיפוש | לא | כן | 4.20 |
| זיהוי פלח | מוסיפים מאפיינים למשתמשי Segment באמצעות Identify. | צפייה בקובץ ה-README ב-GitHub | לעיון במסמכי התיעוד | email או user_id או segment_anonymous_id או segment_group_id | שאילתה | צפייה, חיפוש | לא | כן | 4.20 |
| רצועת פלחים | אפשר להתחבר למספר שילובים ש-Segment מספקת כדי לזהות משתמשים ולטרגט אותם בתהליכי עבודה שיווקיים. | צפייה בקובץ ה-README ב-GitHub | לעיון במסמכי התיעוד | email או user_id או segment_anonymous_id או segment_group_id | שאילתה | צפייה, חיפוש | לא | כן | 4.20 |
| SendGrid | שליחת נתונים ותזמון שליחת תוצאות לכתובת אימייל באמצעות SendGrid API. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | לא | לא | 5.6 |
| Slack | שליחת תוכן מ-Looker בהודעות ישירות, בערוצים ציבוריים ובערוצים פרטיים ב-Slack באמצעות OAuth. היא זמינה לפריסות באירוח Looker ב-Looker 6.24 ואילך, כשהתכונה IP Allowlist מושבתת. | אין קובץ README זמין | לעיון במסמכי התיעוד | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | כן | כן (בטבלאות Look וב-Explore), לא (בלוחות בקרה) | 6.24 |
| Slack Attachment (API Token) | שליחת נתונים ישירות לערוץ Slack ביחד עם פרטי הכניסה של המשתמש. כדאי לעיין גם במאמרי העזרה בנושא Lookerbot כדי לקבל מידע על פונקציות נוספות של Slack. | צפייה בקובץ ה-README ב-GitHub | לעיון במסמכי התיעוד | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | לא | לא | 5.6 |
| Teams — Incoming Webhook | שליחת נתונים ל-Microsoft Teams באמצעות webhook נכנס. | צפייה בקובץ ה-README ב-GitHub | קובץ README | ללא | שאילתה, מרכז בקרה | Look, Explore, dashboard | לא | לא | 5.6 |
| מגש | אפשר להתחבר למספר שילובים ש-Tray.io מספקת כדי להפוך תהליכי עבודה לאוטומטיים. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |
| Twilio — Send Data | שליחת נתונים מ-Look או תזמון של שליחת תוצאות למספר טלפון באמצעות Twilio API. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה | צפייה, חיפוש | לא | לא | 5.6 |
| Twilio — שליחת הודעה | שליחת הודעה לסדרה של מספרי טלפון (עמודות נתונים שתויגו כמספרי טלפון) ב-Look. | צפייה בקובץ ה-README ב-GitHub | קובץ README | טלפון | שדה, שאילתה | צפייה, חיפוש | לא | לא | 5.6 |
| Zapier | אתם יכולים להתחבר למספר שילובים שסופקו על ידי Zapier כדי להפוך תהליכי עבודה לאוטומטיים. | צפייה בקובץ ה-README ב-GitHub | למאמר בקהילה | ללא | שאילתה | צפייה, חיפוש | לא | כן | 5.6 |