יומן Google

גרסאות נתמכות

המחבר הזה תומך בממשקי REST API של יומן Google.

לפני שמתחילים

בפרויקט Google Cloud, מבצעים את המשימות הבאות:

  • מוודאים שהגדרתם חיבור לרשת. מידע נוסף זמין במאמר קישוריות לרשת.
  • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
  • מקצים את תפקידי ה-IAM‏ roles/secretmanager.viewer ו-roles/secretmanager.secretAccessor לחשבון השירות שבו רוצים להשתמש עבור המחבר.
  • מפעילים את secretmanager.googleapis.com (Secret Manager API) ואת connectors.googleapis.com (Connectors API). מידע נוסף זמין במאמר בנושא הפעלת שירותים.

הגדרת המחבר

החיבור ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, מבצעים את הפעולות הבאות:
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Google Calendar מתוך רשימת המחברים הזמינים.
    2. גרסת המחבר: בוחרים את גרסת המחבר מתוך רשימת הגרסאות הזמינות.
    3. בשדה Connection Name, מזינים שם למופע החיבור. שם החיבור יכול להכיל אותיות קטנות, מספרים או מקפים. השם צריך להתחיל באות ולהסתיים באות או במספר, והוא לא יכול להכיל יותר מ-49 תווים.
    4. תיאור: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. זמן קצוב לתפוגה של חיבור: אפשר להזין את הזמן הקצוב לתפוגה של החיבור בשניות.
    8. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

      צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר טרנזקציות לחיבור מסוים, צריך יותר צמתים, ולהפך – כדי לעבד פחות טרנזקציות, צריך פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.

    9. + הוספת תווית: לוחצים על האפשרות הזו כדי להוסיף תווית לחיבור בצורה של צמד מפתח/ערך.
    10. לוחצים על הבא.
  5. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ליומן Google תומך בסוגי האימות הבאים:

      • אימות באמצעות חשבון שירות
      • ‫OAuth 2.0 – JWT Bearer
      • ‫OAuth 2.0 – קוד הרשאה

      כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    2. לוחצים על הבא.
  6. בדיקה: בודקים את פרטי החיבור והאימות.
  7. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

  • אימות חשבון שירות: לא נדרש לבצע הגדרה נוספת לסוג האימות הזה. חשבון השירות שבחרתם בקטע פרטי החיבור ישמש לאימות.
  • OAuth 2.0 - JWT Bearer
    • אישור JWT: בוחרים את האישור שבו רוצים להשתמש לאימות JWT.
    • גרסת הסוד: מזינים את גרסת הסוד של אישור ה-JWT.
    • נושא ה-JWT: מזינים את נושא ה-JWT.
  • OAuth 2.0 – קוד הרשאה
    • מזהה לקוח: מזינים את מזהה הלקוח שבו רוצים להשתמש לאימות OAuth.
    • היקפים: מזינים רשימה של היקפים רצויים.
    • סוד הלקוח: מזינים את סוד הלקוח שבו רוצים להשתמש לאימות OAuth.
    • Secret version (גרסת הסוד): מזינים את גרסת הסוד של סוד הלקוח.

דוגמאות להגדרת חיבור

בקטע הזה מפורטים ערכים לדוגמה לשדות השונים שאתם מגדירים כשאתם יוצרים את החיבור.

סוג החיבור של חשבון השירות

שם השדה פרטים
מיקום us-central1
מחבר יומן Google
גרסת המחבר 1
שם החיבור service-account-auth
הפעלת Cloud Logging כן
חשבון השירות iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
אימות כן
אימות באמצעות חשבון שירות כן

סוג החיבור OAuth 2.0 – JWT bearer

שם השדה פרטים
מיקום us-central1
מחבר יומן Google
גרסת המחבר 1
שם החיבור jwt-bearer-auth
הפעלת Cloud Logging כן
חשבון השירות iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
אימות כן
‫OAuth 2.0 – JWT bearer כן
JWT Cert projects/google-cloud-project/secrets/jwt-cert/versions/1
גרסה של סוד 1

OAuth 2.0 – סוג החיבור 'קוד הרשאה'

שם השדה פרטים
מיקום us-central1
מחבר יומן Google
גרסת המחבר 1
שם החיבור gcpcloud-googlecalendar-rest-conn
הפעלת Cloud Logging כן
חשבון השירות iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
אימות כן
מספר לקוח 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
היקף https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
סוד לקוח ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
גרסה של סוד 1

מגבלות המערכת

המחבר של Google Calendar יכול לעבד עד 2 טרנזקציות בשנייה, לכל צומת, ומגביל את כל הטרנזקציות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

שימוש בחיבור ליומן Google בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור באינטגרציה באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימת מחברים ב-Apigee Integration, אפשר לעיין במאמר משימת מחברים.
  • כדי להבין איך ליצור ולהשתמש במשימת מחברים ב-Application Integration, אפשר לעיין במאמר בנושא משימת מחברים.

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מ פעולות הישות במחבר הזה.

דוגמה – רשימת כל היומנים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calendars מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. בקטע Task Input במשימה Connectors, אפשר להגדיר את filterClause בהתאם לדרישות הלקוח.
  5. חובה להשתמש במירכאות בודדות (') כדי להקיף את הערך של filterClause.

    אפשר להשתמש ב-filterClause כדי לסנן רשומות על סמך העמודות.

דוגמה – קבלת פרטים מהיומן

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calendars מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את entityId לערך "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", שהוא המפתח שיועבר.
  5. כדי להגדיר את entityId, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" בשדה Input Value (ערך קלט) ומגדירים את entityId כמשתנה מקומי.
  6. הערך של entityId צריך להיות מועבר ישירות, למשל "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". כאן "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" הוא הערך הייחודי של המפתח הראשי, שחייב להיות מועבר.

    במקרים מסוימים, העברת entityId עלולה להקפיץ הודעת שגיאה אם לישות יש שני מפתחות מורכבים. במקרים כאלה, אפשר להשתמש ב-filterClause כדי להעביר את הערך, כמו id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

דוגמה – מחיקת יומן

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calendars מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את entityId ל-"c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", שהוא המפתח שיועבר. כדי להגדיר את entityId, בקטע Data Mapper של Data Mapping, לוחצים על Open Data Mapping Editor, מזינים "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" בשדה Input Value ומגדירים את entityId כמשתנה מקומי.

    אם לישות יש שני מפתחות עסקיים מורכבים או שני מפתחות ראשיים במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

דוגמה – יצירת יומן

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calendars מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את connectorInputPayload כמשתנה מקומי.
    {
      "Summary": "New calendar"
    }
    

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה calendar יהיה ערך שדומה לזה:

    {
      "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
    }
    

דוגמה – יצירת אירוע ביומן

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות AllCalendars מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את connectorInputPayload כמשתנה מקומי.
    {
      "Summary": "New event",
      "CalendarId": "c_b4e891cebb19267bf5ac838f0c5f691bee164a7cec9dcc1a93e54625279baa80@group.calendar.altostrat.com",
      "StartDate": "2025-09-01",
      "EndDate": "2025-09-02"
    }
    

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה calendar יהיה ערך שדומה לזה:

    {
      "Id": "fnf0p7292pbm2buk59ubc1a37k",
      "CalendarId": null
    }
    

דוגמה – יצירת אירוע ביומן הראשי

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים את מזהה האימייל מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את connectorInputPayload כמשתנה מקומי.
    {
      "Summary": "new event for my calendar",
      "CalendarId": "xyz@xwf.altostrat.com",
      "StartDate": "2025-09-01",
      "EndDate": "2025-09-02"
    }
    

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה AllCalendars יהיה ערך שדומה לזה:

    {
      "Id": "fnf0p7292pbm2buk59ubc1a37k",
      "CalendarId": null
    }
    

דוגמה – יצירת סוג אירוע ביומן

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות AllCalendars מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את connectorInputPayload כמשתנה מקומי.
    {
      "EventType": "outOfOffice",
      "Summary": "outOfOffice",
      "CalendarId": "xyz@xwf.altostrat.com",
      "StartDateTime": "2025-09-03 14:00:00",
      "EndDateTime": "2025-09-03 15:00:00"
    }
    

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה AllCalendars יהיה ערך שדומה לזה:

    {
      "Id": "fnf0p7292pbm2buk59ubc1a37k",
      "CalendarId": null
    }
    

דוגמה – יצירת אירוע חוזר ביומן

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות AllCalendars מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את connectorInputPayload כמשתנה מקומי.
    {
      "Summary": "Google Cloud Recurring event",
      "CalendarId": "xyz@xwf.altostrat.com",
      "StartDateTime": "2025-11-2 14:00:00",
      "EndDateTime": "2025-11-2 14:30:00",
      "Recurrences": "RRULE:FREQ=WEEKLY;BYDAY=TH;COUNT=5",
      "StartDateTimeZone": "America/Los_Angeles",
      "EndDateTimeZone": "America/Los_Angeles"
    }
    

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה AllCalendars יהיה ערך שדומה לזה:

    {
      "Id": "fnf0p7292pbm2buk59ubc1a37k",
      "CalendarId": null
    }
    

דוגמה – עדכון פרטי היומן

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Calendars מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את connectorInputPayload כמשתנה מקומי.
    {
      "Summary": "Updated from Google Cloud"
    }
    
  5. מגדירים את entityId בכלי למיפוי נתונים לישות של היומן.
  6. כדי להגדיר את entityId, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את entityId כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
    }
    

דוגמה – עדכון כל הפרטים ביומנים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות AllCalendars מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את connectorInputPayload כמשתנה מקומי.
    {
      "Summary": "Great event"
    }
    
  5. מגדירים את entityId ב-Data Mapper לישות של AllCalendars.
  6. כדי להגדיר את entityId, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ומגדירים את entityId כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך Summary='New sep event'.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "Id": "fnf0p7292pbm2buk59ubc1a37k",
      "CalendarId": null
    }
    

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים