אימות באמצעות Maps Booking API

כדי לבצע עדכונים בזמן אמת, צריך לשלוח בקשות ל-Maps Booking API. כדי להשתמש ב-Maps Booking API, צריך לאמת את הבקשות באמצעות OAuth 2.0 באמצעות חשבון שירות ב-GCP שיש לו גישה ל-API והוקצה לו קצב הבקשות לשנייה הנדרש. המדריך הזה יסביר איך:

  1. הגדרת הפרויקט ב-Google Cloud
  2. יצירה של חשבון שירות
  3. הפעלת Maps Booking API בפרויקט ב-GCP
  4. ניפוי באגים של בעיות נפוצות

למידע על שליחת בקשות ל-API, תוכלו לעיין בקטע עדכוני API בזמן אמת במדריך המלא בנושא פגישות.

הגדרת פרויקט ב-Google Cloud באמצעות מרכז הפעולות

  1. מתחברים לחשבון Google Cloud Platform.
  2. אפשר ליצור פרויקט חדש או להשתמש בפרויקט קיים למטרה הזו.
    • חשוב לכתוב את מספר הפרויקט בענן כי תצטרכו אותו בשלבים הבאים. אפשר למצוא את מספר הפרויקט בענן גם בדף הבית של Google Cloud Platform. מספר הפרויקט ב-Cloud הוא תמיד מספר מספרי בלבד.
  3. מתחברים לפורטל השותפים.
  4. משלימים את שלב 1 בדף 'משימות קליטה' בפורטל השותפים, על ידי שליחת מספר הפרויקט בענן וכתובת האימייל של הפרויקט בענן (כתובת האימייל שמשמשת לניהול הפרויקט בענן).

יצירת חשבון שירות ופרטי כניסה ל-OAuth

  1. מתחברים שוב לחשבון Google Cloud Platform.
  2. עוברים אל IAM & admin > Service accounts.
  3. מחפשים את מזהה הפרויקט הקיים בענן או את המזהה של הפרויקט החדש שיצרתם.
  4. יוצרים חשבון שירות.
  5. ממלאים את פרטי חשבון השירות.
  6. מקצים לחשבון השירות החדש את התפקיד שמתאים ביותר לצרכים של האפליקציה. לבחירת התפקיד של חשבון השירות לא תהיה השפעה על הקריאות שאפשר לבצע ל-Google Maps Booking API, כי הקצאת המכסה הנדרשת לשימוש בהן נקבעת לפי השיוך של מספר הפרויקט בהגדרות של מרכז הפעולות. אם אתם לא בטוחים באיזה תפקיד לבחור, פשוט בוחרים באפשרות 'פרויקט' > 'צפייה'.
  7. אחרי שלוחצים על 'המשך' בשלב (6), תוצג אפשרות ליצור מפתחות JSON.
  8. שומרים את פרטי הכניסה בפורמט JSON. חשוב לשמור את הפרטים האלה במקום בטוח, כי לא תוכלו לאחזר אותם מאוחר יותר.
  9. מתחברים שוב לפורטל השותפים ומסיימים את המשימות שנותרו בדף Onboarding Tasks בפורטל השותפים.

הפעלת MapsBooking API

  1. מתחברים לחשבון Google Cloud Platform.
  2. עוברים אל API & Services‏ > Dashboard.
  3. לוחצים על Enable APIs and Services ומחפשים את Google Maps Booking API.
  4. מפעילים את ממשקי ה-API הבאים:
    • Google Maps Booking API
    • Google Maps Booking API (Dev)

שגיאות נפוצות

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

אם נתקלתם בשגיאות מסוג 403, עליכם לוודא שאתם עומדים בכל הדרישות הבאות:

  1. שימוש בספריית לקוח של Google.
  2. יוצרים פרטי כניסה ל-OAuth באמצעות אימות של חשבון שירות.
  3. נותנים הרשאה להיקף המתאים.
  4. מבצעים קריאות לנקודת הקצה המתאימה (המפורטת בהמשך).

חשוב לוודא שאתם מבצעים קריאות לנקודת הקצה הנכונה:

  1. ארגז חול: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. ייצור: https://mapsbooking.googleapis.com/v1alpha/...

מוודאים שמתבצעת הרשאה נכונה לבקשות של פרטי הכניסה ב-OAuth:

  1. אתם נותנים הרשאה ברמת ההיקף "https://www.googleapis.com/auth/mapsbooking".
  2. אתם משתמשים במפתח של חשבון השירות שנוצר במאמר יצירת חשבון שירות ופרטי כניסה ל-OAuth.

עדיין מופיעות שגיאות?

אם השגיאות ממשיכות להופיע אחרי ביצוע השלבים האלה, תוכלו לפנות לנציג שלכם ב-Actions Center ולציין את הפרטים הבאים:

  • מספר הפרויקט ב-Cloud ומזהה הפרויקט עם צילום מסך
  • מזהה חשבון השירות
  • כתובת האימייל ששימשה ליצירת חשבון השירות
  • פרטי נקודת הקצה שבה נעשו ניסיונות לשלוח בקשות
  • מועד הניסיונות לשלוח בקשה
  • הבקשה המלאה והודעות השגיאה שהתקבלו בזמן שליחת הבקשות.