הסקירה הכללית הזו מסכמת את התהליך של 'הזמנה עם Google', ואת האינטראקציה שלה עם שירות המשלוחים באינטרנט.
סידור הסרטונים
ממשק המשתמש של Order with Google מטפל בכל האינטראקציות עם המשתמש כשהוא מוסיף פריטים לתפריט ההזמנה ומחליט לגבי איסוף או משלוח, בהתאם לשירותים שהמסעדה מציעה. חוויית השימוש הזו מופעלת באמצעות הישויות Restaurant, Service ו-Menu שנמצאות בפידים של נתונים.
השלב הבא הוא שלב האימות של עגלת הקניות, שבו שירות Cart שנוצר על ידי המשתמש יעובד על ידי שירות האינטרנט שלך.
פעולה בקופה
פעולת התשלום היא השיחה הראשונה ש-Google מבצעת בנקודת הקצה של שירות האינטרנט.
שירות האינטרנט שלך אחראי לאימות של Cart. עליכם לאמת את הזמינות והתמחור של פריטים, לחשב את המיסים ולהחזרים את העמלה והעמלות ולאמת את הכתובת למשלוח.
תהליך התשלום מתבצע לפי הרצף הבא:
- שירות Order with Google שולח
CheckoutRequestMessageעם הערךCartבנקודת הקצה של שירות האינטרנט של מילוי ההזמנות. - שירות האינטרנט צריך לאמת את הפריטים שב
Cartעל סמך המחירים הנוכחיים, הזמינות וספקי השירות. לאחר מכן צריך לחשב את המחיר הכולל, כולל הנחות, מיסים ועמלות משלוח. - נקודת הקצה (endpoint) שלך מגיבה עם
CheckoutResponseMessageשמכיל אתCart, ללא שינוי, עבור בקשות שהוגשו בהצלחה. אפשר לכלול אתFoodErrorExtensionב-CheckoutResponseMessageכדי להעלות שגיאת עיבוד או להציע שינויים קלים, אם צריך.
אחרי שה-Cart מאומת, המשתמש יכול לבחור להמשיך לשלב שליחת ההזמנה בתהליך.
שליחת פעולה בהזמנה
פעולת שליחת ההזמנה מופעלת כאשר המשתמש מבצע את ההזמנה. שירות האינטרנט צריך לאמת מחדש את עגלת הקניות, לעבד את אסימון הכרטיס אם אפשרות התשלומים באינטרנט מופעלת ובסופו של דבר לעדכן את סטטוס ההזמנה.
תהליך שליחת ההזמנה מתבצע לפי הסדר הזה:
- השירות Order with Google שולח
SubmitOrderRequestMessageעם הערךOrderבנקודת הקצה של שירות האינטרנט של מילוי ההזמנות. בקצה העורפי צריך לבצע אימותCartנוסף לפני שממשיכים. שירות האינטרנט מעבד את פרטי התשלום שמופיעים ב
Order, בדרך כלל:- ביצוע אימות אסימונים, הונאות ובדיקות זכאות אחרות.
- מאשרים את הכרטיס, ואם רוצים, טוענים אותו.
נקודת הקצה (endpoint) שלך מגיבה ל-
SubmitOrderResponseMessageשמכילOrderUpdateעם המצבCREATED(&"הזמנה&&; סטטוס רכישה),CONFIRMED("מקובל&ציטוט; סטטוס רכישה) אוREJECTED("נדחה" סטטוס רכישה).
אחרי ביצוע ההזמנה, המשתמש מצפה לקבל עדכונים על סטטוס ההזמנה גם מכם וגם מהממשק המשתמש של Order with Google. אתם נדרשים לשלוח למשתמש הודעת אישור הזמנה. בנוסף, תוכלו להשתמש ב-Asynchronous Order Update API כדי לשלוח ל-Google עדכוני הזמנות רלוונטיים.
פעולת עדכון של הזמנה אסינכרונית
ללא קשר להתראות של המשתמשים בצד שלכם, עליכם לשלוח ל-Google עדכונים גם לגבי סטטוס ההזמנה של האירועים הבאים:
- שינויים ב-
OrderStateכמו מעבר מ-CREATEDל-CONFIRMEDו-CONFIRMEDל-IN_TRANSIT. - שינויים בפריטי הזמנה, כמו מחיר או זמינות.
- בכל פעם שהמשתמש מפעיל בקשת תמיכה מאחד מערוצי תמיכת הלקוחות שלכם.
עדכונים נשלחים מנקודת הקצה של שירות האינטרנט בתור AsyncOrderUpdateRequestMessage, שמכיל OrderUpdate. Google מגיבה באמצעות AsyncOrderUpdateResponseMessage.
תרשים רצף
האיור הבא מראה איך פעולות מילוי ההזמנה יוצרות אינטראקציה עם שירות האינטרנט שלכם. אפשר ללחוץ כדי להגדיל.
הגדרת נקודת הקצה למילוי הזמנות
הפעולות של Order with Google משמשות בהודעות JSON כדי לתקשר עם שירות האינטרנט ולטפל בעיבוד, באישור ובעדכונים של הזמנות אוכל. כשמעצבים את שירות האינטרנט עם Order with Google, צריך להגדיר נקודת קצה לכתובת URL שמקבלת הודעות בקשה משירות Order with Google ושניתן להחזיר הודעות לשירות Google. ההטמעה חייבת לעמוד בדרישות הבאות:
- שירות האינטרנט שלכם חייב להיות מסוגל לקבל הודעת JSON כבקשת
POSTמשירות Order with Google. - שירות האינטרנט צריך לספק נקודת קצה (endpoint) שזמינה באופן ציבורי, שנקראת כתובת URL למילוי הזמנה, שאותה מציינים בפורטל לשותפים. כתובת ה-URL למילוי הזמנות משמשת לבדיקה ולשליחה של הזמנות. היישום של הבקשה חייב לטפל בשני סוגי הבקשות.
- צריך לוודא ששירות האינטרנט מאפשר לאמת הודעות מ-Google באמצעות השיטה אימות הודעות.
- נקודת הקצה ליישום כתובת ה-URL חייבת להיות מסוגלת לטפל גם בתהליך התשלום וגם במימוש ההזמנה באמצעות נקודת קצה אחת. לא ניתן להגדיר כתובת URL אחת לסיום תשלום בקופה ונקודת קצה נפרדת להזמנה.
ספריות לקוח
במחולל קוד הלקוח בקטע 'כלים' תוכלו לאמת את שירות האינטרנט בהתאם למפרט ממשק ה-API של מילוי.