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

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

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

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

• טעינת דף BatchAvailabilityLookup מוכנה
• BatchAvailabilityLookup slot click Ready
• CreateBooking Ready
• UpdateBooking Ready
• מפעילים את הכלי לבדיקת זמינות בקטע 'תכונות החשבון' בהגדרות החשבון ב-Actions Center

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

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

הטמעה של ממשק API בארכיטקטורת REST

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

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

כל הבקשות של שרת ההזמנות של 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	Actions Center מבצע שיחות קבועות לשרת ההזמנות שלכם כדי לוודא שהתשתית פעילה ופועלת.	משתמשים בקוד סטטוס של HTTP כדי לציין את סטטוס ההצגה של השרת. מחזירים קוד סטטוס של HTTP 200 אם השרת פעיל ופועל בהצלחה. כדי לציין שגיאה או להשבית את השילוב באופן זמני, צריך להחזיר את קוד הסטטוס המתאים של HTTP שאינו 2xx.	GET /v3/HealthCheck/

קריטריונים של אבני דרך

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

שיטה	חובה מספר הבקשות (ארגז חול)	מספר הבקשות הנדרש (ייצור)	שיעור ההצלחה הנדרש
BatchAvailabilityLookup טעינת דף	20	20	90%
BatchAvailabilityLookup קליק על משבצת	20	20	90%
CreateBooking	10	3	90%
UpdateBooking	10	3	90%

הערה: המספרים האלה מבוססים על הגדרות האותות בסביבת ארגז החול ובסביבת הייצור.

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

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

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

• כשלוחצים על הקישור RwG - E2E, מופעלת בקשת BatchAvailabilityLookup במהלך טעינת הדף ומוצגת הזמינות הידועה של המוֹכר.

• כשלוחצים על שעת הזמנה, מופעלת בקשת BatchAvailabilityLookupon slot click ומוצג חלון ההזמנה.

• משלימים את ההזמנה באמצעות חלון ההזמנה כדי לשלוח את בקשת CreateBooking ההזמנה.

• אחרי שמשלימים הזמנה בסביבת Sandbox, החשבון ששימש ליצירת ההזמנה מקבל אישור באימייל עם פרטי ההזמנה.

• כדי להפעיל את השיטה UpdateBooking, משנים או מבטלים את ההזמנה מהאימייל.

HealthCheck

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

בקשה: אין

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

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

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

הערה: כשמחזירים קוד סטטוס שאינו 200, זה יכול להשפיע על סטטוס השילוב.