יומן 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). מידע נוסף זמין במאמר בנושא הפעלת שירותים.
הגדרת המחבר
החיבור ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:
- במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
- לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
- בקטע מיקום, מבצעים את הפעולות הבאות:
- אזור: בוחרים מיקום מהרשימה הנפתחת.
רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
- לוחצים על הבא.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
- בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
- מחבר: בוחרים באפשרות Google Calendar מתוך רשימת המחברים הזמינים.
- גרסת המחבר: בוחרים את גרסת המחבר מתוך רשימת הגרסאות הזמינות.
- בשדה Connection Name, מזינים שם למופע החיבור. שם החיבור יכול להכיל אותיות קטנות, מספרים או מקפים. השם צריך להתחיל באות ולהסתיים באות או במספר, והוא לא יכול להכיל יותר מ-49 תווים.
- תיאור: מזינים תיאור למופע החיבור.
- אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-
Error. - חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
- זמן קצוב לתפוגה של חיבור: אפשר להזין את הזמן הקצוב לתפוגה של החיבור בשניות.
- אופציונלי: מגדירים את ההגדרות של צומת החיבור:
- מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
- מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר טרנזקציות לחיבור מסוים, צריך יותר צמתים, ולהפך – כדי לעבד פחות טרנזקציות, צריך פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
- + הוספת תווית: לוחצים על האפשרות הזו כדי להוסיף תווית לחיבור בצורה של צמד מפתח/ערך.
- לוחצים על הבא.
-
בקטע אימות, מזינים את פרטי האימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
החיבור ליומן Google תומך בסוגי האימות הבאים:
- אימות באמצעות חשבון שירות
- OAuth 2.0 – JWT Bearer
- OAuth 2.0 – קוד הרשאה
כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.
- לוחצים על הבא.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
- בדיקה: בודקים את פרטי החיבור והאימות.
- לוחצים על יצירה.
הגדרת אימות
מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.
- אימות חשבון שירות: לא נדרש לבצע הגדרה נוספת לסוג האימות הזה. חשבון השירות שבחרתם בקטע פרטי החיבור ישמש לאימות.
-
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, אפשר לעיין במאמר בנושא משימת מחברים.
דוגמאות לפעולות על ישויות
בקטע הזה מוסבר איך לבצע חלק מ פעולות הישות במחבר הזה.
דוגמה – רשימת כל היומנים
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
CalendarsמהרשימהEntity. - בוחרים את הפעולה
Listולוחצים על סיום. - בקטע Task Input במשימה Connectors, אפשר להגדיר את filterClause בהתאם לדרישות הלקוח.
חובה להשתמש במירכאות בודדות (') כדי להקיף את הערך של filterClause.
אפשר להשתמש ב-filterClause כדי לסנן רשומות על סמך העמודות.
דוגמה – קבלת פרטים מהיומן
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
CalendarsמהרשימהEntity. - בוחרים את הפעולה
Getולוחצים על סיום. - מגדירים את
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 צריך להיות מועבר ישירות, למשל "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". כאן "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" הוא הערך הייחודי של המפתח הראשי, שחייב להיות מועבר.
במקרים מסוימים, העברת entityId עלולה להקפיץ הודעת שגיאה אם לישות יש שני מפתחות מורכבים. במקרים כאלה, אפשר להשתמש ב-filterClause כדי להעביר את הערך, כמו id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.
דוגמה – מחיקת יומן
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
CalendarsמהרשימהEntity. - בוחרים את הפעולה
Deleteולוחצים על סיום. - מגדירים את 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'.
דוגמה – יצירת יומן
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
CalendarsמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על
Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדהInput Valueומגדירים אתconnectorInputPayloadכמשתנה מקומי.{ "Summary": "New calendar" }אם השילוב יצליח, לפרמטר התגובה
connectorOutputPayloadשל המשימהcalendarיהיה ערך שדומה לזה:{ "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com" }
דוגמה – יצירת אירוע ביומן
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
AllCalendarsמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע 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 }
דוגמה – יצירת אירוע ביומן הראשי
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים את מזהה האימייל מהרשימה
Entity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע 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 }
דוגמה – יצירת סוג אירוע ביומן
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
AllCalendarsמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע 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 }
דוגמה – יצירת אירוע חוזר ביומן
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
AllCalendarsמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע 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 }
דוגמה – עדכון פרטי היומן
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
CalendarsמהרשימהEntity. - בוחרים את הפעולה
Updateולוחצים על סיום. - בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על
Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדהInput Valueומגדירים אתconnectorInputPayloadכמשתנה מקומי.{ "Summary": "Updated from Google Cloud" } - מגדירים את entityId בכלי למיפוי נתונים לישות של היומן.
- כדי להגדיר את 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" }
דוגמה – עדכון כל הפרטים ביומנים
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
AllCalendarsמהרשימהEntity. - בוחרים את הפעולה
Updateולוחצים על סיום. - בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על
Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדהInput Valueומגדירים את connectorInputPayload כמשתנה מקומי.{ "Summary": "Great event" } - מגדירים את entityId ב-Data Mapper לישות של AllCalendars.
- כדי להגדיר את entityId, לוחצים על
Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדהInput Valueומגדירים את entityId כמשתנה מקומי.במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך
Summary='New sep event'.הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט
connectorOutputPayloadשל משימת המחבר:{ "Id": "fnf0p7292pbm2buk59ubc1a37k", "CalendarId": null }