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

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

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

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

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

הערה: אם כבר הגדרתם חשבון בפורטל לשותפים, עליכם להשתמש בפרויקט Google Cloud שהוזן כחלק מההגדרה. אם אין לך יותר גישה לפרויקט הזה ב-Google Cloud Platform, או אם דרושה לך עזרה בזיהוי הפרויקט, יש לפנות לאיש הקשר שלך ב-'Google הזמנת מקומות'.

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

יצירת חשבון שירות ואישורי OAuth

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

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

הפעלת ה-API של MapsBooking

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)

הערה: אם כבר השלמת את שלבי ההצטרפות וברצונך לעדכן את פרויקט הענן הקיים לפרויקט חדש, יש לפנות לאיש הקשר שלך ב-'Google הזמנת מקומות'.

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

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

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

אם לאחר ביצוע השלבים האלה עדיין מופיעות שגיאות, עליך לפנות לאיש הקשר שלך ב-'Google הזמנת מקומות' עם הפרטים הבאים:

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