בקטע הזה מוצגים פרטים נוספים על שלושת החלקים העיקריים של השילוב עם מרכז הפעולות. תשתמשו בכל אחת מהן בשלבים המפורטים במדריך מקצה לקצה.
פידים
פידים הם קבצים בפורמט JSON או בפורמט pb3 שמשמשים
לשידור נתוני המלאי אל מרכז הפעולות. כך אפשר
לשלוח את כל הנתונים בבת אחת כדי לעדכן את המוכרים, השירותים
ומשבצות הזמינות באמצעות העלאת SFTP.
API של מפות Google להזמנה
הממשק Maps Booking API מאפשר לעדכן אובייקטים במערכת של Actions Center בין הפידים ששולחים כדי לשמור על עדכניות המידע. ה-API גם מאפשר לבטל הזמנות שבוצעו דרך שילוב מקצה לקצה של 'Google הזמנת מקומות'.
העדכונים בזמן אמת מוטמעים באמצעות קריאות ל-REST.
שרת הזמנות
כדי שהשילוב מקצה לקצה של מרכז הפעולות ייצור הזמנות בשמכם, צריך להגדיר שרת הזמנות.
API ל-REST
גרסת v3 היא הגרסה האחרונה של ה-API, והיא תומכת בממשק שמבוסס על REST. כל השילובים החדשים צריכים להשתמש ב-API v3.
בקטע הזה מצוינים קובצי הפיד שמשמשים להעברת נתוני המלאי שלך אל מרכז הפעולות. התוכן של הפידים מגדיר אילו שירותים אתם מספקים, אילו שירותים זמינים ומתי השירותים יהיו זמינים.
כדאי לעיין באקורדיון קובצי עזר ודוגמאות כדי ללמוד איך לשתף איתנו את הפידים האלה.
המבנה של הפידים של המלאי מוגדר על ידי Google Maps Booking API.
חובה להוסיף את הפיד הבא בכל שילוב:
- פיד מוכרים: מכיל נתונים שמתארים את המוכרים.
בנוסף, חובה להשתמש בשני הפידים הבאים לצורך שילוב מקצה לקצה.
- פיד שירותים: מתאר את השירותים שהמוכרים שלכם מספקים.
- פיד זמינות: פירוט של יחידות קיבולת הזמינות של השירותים שהמוכרים שלכם מספקים.
חלק מהשדות בפידים האלה הם שדות חובה וחלקם אופציונליים. כל שדה שמסומן כאופציונלי יכול לא להופיע בפיד כשהוא ריק.
פורמט הפידים מתואר באמצעות התחביר של פרוטוקול למאגר אחסון 3. אפשר להעלות את קובץ הפידים כסידור בינארי של נתוני מאגר הנתונים הזמני של הפרוטוקול בפורמט pb3 או בפורמט JSON נגזר. מומלץ להעלות את הפידים בפורמט JSON.
מומלץ להשתמש ב-gzip כדי לדחוס פידים לפני ההעלאה.
המדריך הזה מיועד ספציפית למאגרי המידע של הפרוטוקולים של מרכז הפעולות. לקבלת מידע כללי על אופן השימוש במאגרי האחסון הזמניים של הפרוטוקולים כדי ליצור קובץ pb3, ראו דוגמה ב-Java.