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

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

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

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

הגדרת פרויקט בענן ב-Google Cloud באמצעות Actions Center

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

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

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

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

1. נכנסים מחדש לחשבון Google Cloud Platform.
2. עוברים אל IAM & admin > Service accounts.
3. מחפשים את מזהה פרויקט הענן הקיים או החדש שיצרתם.
4. יוצרים חשבון שירות.
5. ממלאים את פרטי חשבון השירות.
6. מקצים לחשבון השירות החדש את התפקיד שהכי מתאים לצרכים של האפליקציה. בחירת התפקיד לחשבון השירות לא תשפיע על סוגי הקריאות שאפשר לבצע ל-Google Maps Booking API, כי הקצאת מכסת השימוש נקבעת לפי שיוך מספר הפרויקט בהגדרות של Actions Center. אם אתם לא בטוחים איזה תפקיד לבחור, פשוט בוחרים באפשרות Project (פרויקט) > Viewer (בעל הרשאת צפייה).
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)

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

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

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

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