העדכונים בזמן אמת מוכנים

המלאי במערכת משתנה בגלל הזמנות חדשות, ביטולים ושינויים בלוחות הזמנים של המוכרים. ממשק ה-API לעדכון בזמן אמת (RTU) הוא מנגנון להודעה ל-Google על השינויים האלה ועל השינויים שבוצעו בהזמנות קיימות.

נדרשים רישיונות RTU במקרים הבאים:

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

לפני שאתם עוברים לבדיקה של ארגז החול, עליכם להשלים את משימת אבן הדרך הבאה של RTU:

כל משימה מסומנת כהושלמה והופכת לירוקה אם ב-20 הבקשות האחרונות לא היו שגיאות במשך 14 ימים. כדי שהאבן דרך תישאר ירוקה, צריך להמשיך לשלוח בקשות מוצלחות.

API RTU and Feeds

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

מידע נוסף זמין במשאבים הבאים:

גישה ל-API

הפרויקט שלכם ב-Google Cloud הוא הדרך שלכם לגשת ל-Maps Booking API של מרכז הפעולות, שדרכו אתם שולחים בקשות לשינוי זמינות. אתם צריכים להשתמש בחשבון Google במסוף Google למפתחים ולציין את מספר הפרויקט שלכם ב-Cloud באבן הדרך 'הגדרה' בתוכנית ההצטרפות. מידע נוסף על הפעלת Cloud APIs זמין במאמר הפעלת Cloud APIs.

שימוש בקריאות RESTful או הורדה של ספריית הלקוח

מומלץ לשלוח קריאות RESTful ישירות ל-Maps Booking API עם מטען ייעודי (payload) בפורמט JSON. מידע נוסף מופיע במאמרי העזרה של REST API.

אפשר גם להשתמש בספריות לקוח כדי להתחבר ל-API.

.
שפה קישור להורדה
Java ספריית לקוח Java. מידע נוסף זמין במאמר הוראות ללקוח Java

אפשר להוריד ספריות תמיכה נוספות שמטפלות בהרשאה ובמאפיינים אחרים של קריאות ל-Google APIs. מידע נוסף זמין במאמר בנושא דוגמאות קוד.

אחזור מסמך הגילוי

בספריות לקוח מסוימות, כמו Ruby, צריך לאחזר את מסמך ה-Discovery של ה-API שמתאר את השיטות והפרמטרים שלו.

כדי לאחזר את מסמך הגילוי, משתמשים בפקודה הבאה:

curl -s -o mapsbooking_rest

https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha

מידע נוסף על גישה ל-API מ-Ruby זמין במאמרים Ruby API Client ו-Ruby Auth Library.

ביצוע קריאות מורשות ל-API

כשמבצעים קריאות ל-API, צריך לעיין במאמר הכנה לביצוע קריאה ל-API עם הענקת גישה כדי לתת הרשאה לחשבון השירות באמצעות המפתח הפרטי והיקף ההרשאות הבא של OAuth:

https://www.googleapis.com/auth/mapsbooking

נקודות קצה (endpoints) של ארגז חול ושל סביבת ייצור

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

נקודת קצה (endpoint) של שלב הייצור: https://mapsbooking.googleapis.com/

נקודת קצה של ארגז חול: https://partnerdev-mapsbooking.googleapis.com/

הדוגמה הבאה ב-Java מראה איך להחליף נקודות קצה:

 // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()