תיעוד

Google

יומן, Sheets, Drive, Google Ads, Analytics 4, Search Console, Business Profile ואימות כתובת דואר — כל יכולת מתחברת באופן עצמאי, במודל BYO.

האינטגרציה Google מאגדת מספר יכולות: יומן, Sheets, Drive, Google Ads, Google Analytics 4, Search Console, Business Profile ואימות כתובת דואר. כל אחת מהן מתחברת באופן עצמאי (אתם מעניקים רק את ההיקפים הדרושים), עם «התחבר באמצעות Google» (OAuth מנוהל) או האפליקציה שלכם עצמכם.

יומן (Google Calendar)

  • רשימת האירועים ביומן בתקופה (google.calendar_list_events, הצומת google_calendar_list_events) — שימושי כדי שסוכן יכיר את הזמינויות שלכם.
  • יצירת אירוע (google.calendar_create_event, הצומת google_calendar_create_event) — לדוגמה קביעת פגישה מאושרת.
  • מחיקת אירוע (google.calendar_delete_event) — לפי המזהה שלו.
  • הפעלת pipeline לפני אירוע — ה-Receiver ‏google_calendar_inbound סורק את היומן מעת לעת ויכול להפעיל רק עבור אירועים שמתחילים בקרוב (תזכורת, הכנה לפגישה). תגובה מיידית לשינוי ביומן אינה זמינה.

שימוש טיפוסי: עוזר אישי שמעיין ביומן, מציע זמן פנוי, ואז יוצר את הפגישה.

Google Sheets

  • קריאת גיליון (google.sheets_read, הצומת google_sheets_read) — אחזור שורות כדי לעבד אותן ב-pipeline.
  • הוספת שורות באמצעות ה-tool ‏google.sheets_append או הצומת google_sheets_append (כתיבה exactly-once).
  • פרסום טבלה (google.sheets_publish, הצומת google_sheets_publish) — יוצר חוברת עבודה חדשה מרובת גיליונות ומחזיר את כתובת ה-URL שלה. שימו לב: החוברת ציבורית כברירת מחדל.

שימוש טיפוסי: לתעד כל הרצה של pipeline בגיליון מעקב, או להשתמש בגיליון כבסיס תצורה עסקי קטן.

Google Drive

  • חיפוש וקריאה של קבצים (google.drive_search, google.drive_read), העלאת מסמך (google.drive_upload), יצירת תיקייה, העברת קובץ, העברה לאשפה (הפיכה).
  • הצמתים google_drive_list / google_drive_download / google_drive_upload — הצגת רשימה, אחזור והפקדת קבצים (העלאה ב-exactly-once).
  • ניטור תיקייה — ה-Receiver ‏google_drive_changes מזהה קבצים חדשים בתיקייה (polling עם סמן) ומפעיל pipeline.

ההיקף (scope) של Drive רגיש: כברירת מחדל, betool מבקשת גישה רק לקבצים שהיא יוצרת או שאתם פותחים בפניה (drive.file).

  • דוח ביצועים — אחזור המדדים של הקמפיינים שלכם (google.ads_report).
  • ניהול קמפיין — שינוי התקציב היומי שלו (google.ads_update_budget) או השהייתו / הפעלתו מחדש (google.ads_update_campaign_status).
  • העלאת המרות — דיווח המרות לא מקוונות ל-Google Ads באמצעות הצומת google_ads_conversion_upload.

Google Analytics 4 ו-Search Console

  • Analytics 4 — דוח קהל של נכסי GA4 שלכם (google.analytics_report, הצומת google_analytics_report), בקריאה בלבד.
  • Search Console — ביצועי החיפוש של האתרים שלכם: שאילתות, דפים, קליקים, חשיפות (google.search_console_report, הצומת google_search_console_report), בקריאה בלבד.

Google Business Profile

  • ביקורות — רשימת הביקורות והדירוג הממוצע של כרטיס עסק (google.gbp_list_reviews, הצומת google_business_report), ומענה פומבי לביקורת (google.gbp_reply_review).
  • פוסטים — פרסום פוסט בכרטיס העסק (google.gbp_create_post, הצומת google_business_post).

אימות כתובת

ה-tool ‏google.verify_address מאמת ומנרמל כתובת דואר (שימושי לפני משלוח פיזי או כדי להפוך כרטיס לקוח לאמין יותר).

חיבור (BYO ‏+ fallback ספק)

  1. הגדרות → שירותים → Google, לשונית חשבונות.
  2. חברו כל יכולת שאתם צריכים: «התחבר באמצעות Google», או פרטי הגישה של אפליקציית ה-OAuth שלכם. אימות הכתובת משתמש במפתח API.
  3. לאימות כתובת בלבד: אם לא הגדרתם מפתח משלכם, betool יכולה לנתב את הקריאה דרך מפתח ספק משותף (פתרון המפתח שלכם > מפתח משותף).

כל יכולות ה-OAuth רצות על חשבון ה-Google שלכם, ללא metering וללא רווח של betool. רק אימות כתובת שעובר דרך מפתח הספק המשותף מחויב בקרדיטים.