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במודל הבסיסי של התוכן. - סוג הפעולה מציין את רמת הנתונים שהשירות המשולב שולח: שדה, שאילתה או מרכז בקרה. פעולה ברמת השדה שולחת את הערך של תא יחיד שצוין בטבלת נתונים. פעולה ברמת השאילתה שולחת את התוצאות של שאילתה שלמה, כמו כל השורות ב'ניתוח' או ב-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 | מוסיפים מאפיינים לחברות באמצעות 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 | מוסיפים מאפיינים למשתמשי 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 |