השרת מוכן להזמנות

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

במאמר הגדרת פרטי הכניסה של שרת ההזמנות מוסבר איך להגדיר את החיבור לשרתי ההזמנות בסביבת Sandbox ובסביבת הייצור.

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

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

הטמעה של ממשק REST API

הטמעה של ממשק API שמבוסס על REST. כך Google יכולה לשלוח בקשות לשרת ההזמנות באמצעות HTTPS.

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

כל הבקשות של שרת ההזמנות של Google הן יחסיות לכתובת ה-URL של שרת ההזמנות שמוגדרת בדף שרת ההזמנות. לדוגמה, אם כתובת ה-URL מוגדרת כ-api.example.com/google, כל הבקשות של HealthCheck נשלחות אל api.example.com/google/v3/HealthCheck.

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

אבטחה ואימות

כל התקשורת עם שרת ההזמנות מתבצעת באמצעות HTTPS עם אימות בסיסי. כדי להגדיר את השרת, מומלץ להשתמש בכלי אימות SSL או TLS שזמין לציבור, כמו בדיקת שרת SSL של Qualys.

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

יצירת שרת הזמנות

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

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

שיטה הגדרה תשובה בקשת HTTP
טעינת דף BatchAvailabilityLookup

כשמשתמש לוחץ על שמירת שולחן אצלכם, מתבצעת קריאה לבקשת BatchAvailabilityLookup בזמן טעינת הדף.

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

 התשובה צריכה לכלול כל בקשה למשבצת ואת הזמינות הנוכחית של המשבצת. כך לא יוצגו משבצות זמן לא זמינות. POST /v3/BatchAvailabilityLookup/
קליק אחד (BatchAvailabilityLookup) על משבצת כשמוצגים למשתמש משבצות זמן פנויות להזמנה והוא לוחץ על משבצת זמן, מתבצעת קריאה לבקשת BatchAvailabilityLookup של קליק על משבצת זמן. התשובה צריכה לשקף את הזמינות הנוכחית והממשית של משבצת הזמן. אם התור כבר מלא לפני שהמשתמש לוחץ על משבצת הזמן, מחזירים את התשובה שהתור לא זמין. POST /v3/BatchAvailabilityLookup/
CreateBooking כשמשתמש מאשר שהוא רוצה להזמין משבצת זמן שנבחרה בתיבת הדו-שיח להזמנה, נשלחת בקשת CreateBooking.

התשובה צריכה לייצג את ההצלחה או הכישלון של ההזמנה.

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

אם נוצרת הזמנה, התשובה כוללת booking_id ייחודי שאפשר להשתמש בו כדי להתייחס להזמנה בבקשות או בעדכונים עתידיים.

 POST /v3/CreateBooking/
UpdateBooking אחרי שהמשתמשים מבצעים הזמנה דרך 'הזמנת מקומות דרך Google', הם יכולים לשנות את ההזמנה. כשמשתמש מעדכן את ההזמנה או מבטל אותה, נשלחת בקשת UpdateBooking. בדומה לתגובה של CreateBooking, התגובה שלכם ל-UpdateBooking צריכה לייצג את הצלחת ההזמנה או להחזיר את הסיבה הספציפית לכישלון. POST /v3/UpdateBooking/
HealthCheck מרכז הפעולות מבצע שיחות קבועות לשרת ההזמנות כדי לוודא שהתשתית פעילה ופועלת.

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

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

 GET /v3/HealthCheck/

תהליך הזמנה בארגז חול

כדי לראות את תהליך ההזמנה בסביבת Sandbox, עוברים לתצוגה מלאי במרכז הפעולות. בעמודה RwG - E2E בתצוגת המלאי מוצג קישור Live (in Sandbox) לתהליך ההזמנה בארגז החול עבור מוכרים בארגז החול שהותאמו ויש להם זמינות עתידית.

אלה הפעולות בתהליך ההזמנה:

  • כשלוחצים על הקישור RwG - E2E, מופעלת בקשת BatchAvailabilityLookup במהלך טעינת הדף ומוצגת הזמינות הידועה של המוֹכר.
  • כשלוחצים על שעת הזמנה, מופעלת הבקשה BatchAvailabilityLookup on slot click ומוצג חלון ההזמנה.
  • משלימים את ההזמנה באמצעות חלון ההזמנה כדי לשלוח את בקשת CreateBooking.
  • אחרי שמשלימים הזמנה בסביבת ארגז החול, החשבון ששימש ליצירת ההזמנה מקבל אישור באימייל עם פרטי ההזמנה.
  • כדי להפעיל את השיטה UpdateBooking, משנים או מבטלים את ההזמנה מהאימייל.

HealthCheck

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

בקשה: אין

הערך המוחזר: אין

משתמשים בקוד סטטוס HTTP כדי לציין את סטטוס ההצגה של השרת.

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