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