כדי לבצע עדכונים בזמן אמת, צריך לשלוח בקשות ל-Maps Booking API. כדי להשתמש ב- Maps Booking API, צריך לאמת את הבקשות דרך OAuth 2.0 באמצעות חשבון שירות של GCP, שיש לו גישה ל-API וקיבל את ה-QPS הדרוש. המדריך הזה כולל הוראות לביצוע הפעולות הבאות:
- הגדרת פרויקט ב-Google Cloud
- יצירה של חשבון שירות
- מפעילים את Maps Booking API בפרויקט GCP
- ניפוי באגים בבעיות נפוצות
למידע על שליחת בקשות ל-API, עיינו בקטע עדכוני API בזמן אמת במדריך מקצה לקצה של הזמנות.
הגדרת פרויקט Google Cloud דרך מרכז הפעולות
- מתחברים לחשבון Google Cloud Platform.
- אפשר
ליצור פרויקט חדש או להשתמש בפרויקט קיים למטרה הזו.
- רושמים את מספר הפרויקט בענן, כי תצטרכו אותו בשלבים הבאים. מספר הפרויקט בענן מופיע גם בדף הבית של Google Cloud Platform. מספר הפרויקט בענן תמיד יכול להיות מספרי.
- רושמים את מספר הפרויקט בענן, כי תצטרכו אותו בשלבים הבאים. מספר הפרויקט בענן מופיע גם בדף הבית של Google Cloud Platform. מספר הפרויקט בענן תמיד יכול להיות מספרי.
- מתחברים לפורטל השותפים.
- צריך להשלים את שלב 1 בדף ההדרכה למשתמשים חדשים בפורטל השותפים,
באמצעות שליחת מספר הפרויקט בענן וכתובת האימייל של הפרויקט בענן
(כתובת האימייל שמשמשת לניהול הפרויקט ב-Cloud).
יצירת חשבון שירות ופרטי כניסה ל-OAuth
- מתחברים שוב לחשבון Google Cloud Platform.
- נכנסים לקטע IAM & admin > חשבונות שירות.
- מחפשים את המזהה של הפרויקט הקיים או החדש שיצרתם בענן.
- יוצרים חשבון שירות.
- ממלאים את הפרטים של חשבון השירות.
- מקצים לחשבון השירות החדש את התפקיד המתאים ביותר לצורכי האפליקציה שלכם. בחירת התפקיד של חשבון השירות לא תשפיע על הקריאות שיישלחו ל-Google Maps Booking API, כי הקצאת מכסה מספקת לשימוש בהן נקבעת במקום זאת על ידי שיוך מספר הפרויקט בהגדרות של מרכז הפעולות. אם אתם לא בטוחים באיזה תפקיד לבחור, בחרו 'פרויקט' > 'צפייה'.
- לאחר הלחיצה על 'המשך' בשלב (6), תהיה לך אפשרות
ליצור מפתחות JSON.
- שומרים את פרטי הכניסה של ה-JSON. חשוב לשמור אותם במקום בטוח, כי לא ניתן יהיה לאחזר אותם מאוחר יותר.
- מתחברים שוב לפורטל השותפים ומשלימים את המשימות שנותרו בדף תהליך ההצטרפות בפורטל לשותפים.
הפעלה של MapsBooking API
- מתחברים לחשבון Google Cloud Platform.
- עוברים אל API ושירותים > מרכז בקרה.
- לוחצים על Enable APIs and services ומחפשים את
Google Maps Booking API.
- מפעילים את ממשקי ה-API הבאים:
- Google Maps Booking API
- Google Maps Booking API (Dev)
שגיאות נפוצות
יכולות להיות סיבות שונות לבעיות הרשאה כששולחים בקשות ל'עדכון בזמן אמת'. צריכים הנחיות כלליות לגבי שליחת בקשות ל'עדכונים בזמן אמת'? תוכלו לעיין בקטע עדכוני API בזמן אמת במדריך מקצה לקצה של הזמנות. בקטע Code Samples (דוגמאות קוד) אפשר גם למצוא לקוחות לדוגמה בכמה שפות.
אם נתקלתם בשגיאות 403, עליכם לוודא שאתם עומדים בכל הדרישות הבאות:
- משתמשים בספריית הלקוח של Google.
- יצירת פרטי כניסה ל-OAuth באמצעות אימות חשבון שירות
- הרשאה בהתאם להיקף המתאים.
- מבצעים קריאות אל נקודת הקצה המתאימה (מפורטת בהמשך).
מוודאים שאתם מבצעים קריאות לנקודת הקצה הנכונה:
- ארגז חול:
https://partnerdev-mapsbooking.googleapis.com/v1alpha/... - הפקה:
https://mapsbooking.googleapis.com/v1alpha/...
מוודאים שאתם מאשרים כראוי את הבקשות לפרטי הכניסה של OAuth:
- בחרת לתת הרשאה כנגד ההיקף "https://www.googleapis.com/auth/mapsbooking".
- אתם משתמשים במפתחות של חשבון השירות שנוצר במסגרת יצירת חשבון שירות ופרטי כניסה של OAuth.
עדיין מוצגות שגיאות?
אם עדיין מופיעות שגיאות לאחר ביצוע השלבים האלה, יש לפנות לאיש הקשר במרכז הפעולות ולצרף את הפרטים הבאים:
- מספר הפרויקט ומזהה הפרויקט בענן עם צילום מסך
- מספר חשבון שירות
- כתובת האימייל ששימשה ליצירת חשבון השירות
- פרטים של נקודות הקצה (endpoint) ניסו לשלוח בקשות אל
- מועד הניסיונות לשליחת הבקשה
- בקשות מלאות והודעות שגיאה שהתקבלו בעת שליחת בקשות.