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