בדף הזה מוצגות כמה דוגמאות לקריאות באמצעות Travel Partner API v3.
נקודות הקצה של Travel Partner API מקבלות תחביר RESTful בקריאות HTTPS. ה-base_url לכל בקשות ה-API הוא:
https://travelpartner.googleapis.com/v3/accounts/account_id
רשימה מלאה של שדות הבקשות והתגובות זמינה בקטלוג משאבי ה-API.
דוח ביצועים של נכס
השירות Property Performance Report View מאפשר לשלוח שאילתות (לקבל, לסנן ולפלח) לדוח ביצועים של נכס בחשבון מסוים.
שאילתות בדוח ביצועים של נכס
בדוגמה הבאה מתקבל דוח ביצועים של הנכס עבור כל הנכסים בחשבון 12345678, עם סינון לפי התאריך 11 במאי 2022 וקיבוץ לפי מזהה המלון של השותף.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
מלונות
שירות תצוגת המלונות מספק רשימה של כל המלונות או סיכום שלהם בחשבון מסוים.
קבלת רשימה של מלונות
בדוגמה הבאה מאחזרים רשימה של כל המלונות בחשבון 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
הבקשה מקבלת פרמטרים של שאילתה לניווט בתוצאות של כמה דפים:
GET base_url/hotelViews?pageSize=10&pageToken=11
קבלת סיכום של נכסים
בדוגמה הזו מתקבל סיכום של הנכסים בחשבון 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
דוח השתתפות
השירות 'תצוגת דוח השתתפות' מאפשר לשלוח שאילתות (לקבל, לסנן ולפלח) לדוח השתתפות בחשבון מסוים.
שאילתה על דוח השתתפות
בדוגמה הבאה מתקבל דוח ההשתתפות של כל הנכסים בחשבון 12345678, והדוח מסונן לפי התאריך 4 באוקטובר 2020.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
המחירים המדויקים
שירות התצוגות של דיוק במחירים מאפשר לאחזר דוחות וכרטיסי ניקוד של דיוק במחירים עבור חשבון מסוים.
איך מקבלים דוח דיוק במחירים
בדוגמה הבאה מאחזרים את דוח הדיוק במחירים מ-26 באוגוסט 2019 עבור חשבון 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
בנוסף לפרמטרים הרגילים של שאילתות להחלפת דפים בתשובה, יש עוד כמה פרמטרים שמאפשרים לכלול בתוצאות מחירים תואמים או אותות פיקסל.
בדוגמה הזו, דוח הדיוק במחירים מ-26 באוגוסט 2019 כולל מחירים תואמים ואותות פיקסל:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
רישום של דוחות זמינים של דיוק מחירים
כדי לקבל רשימה של הדוחות הזמינים, שולחים את הבקשה הבאה:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
אפשר לכלול את הפרמטרים הרגילים של שאילתה כדי להציג את התוצאות בדפים.
קבלת ציון הדיוק במחיר
כדי לקבל את כרטיס הניקוד של הדיוק במחירים, משתמשים בשיטה summarize:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
כיסוי המחירים
השירות Price Coverage Views מספק את דוח כיסוי המחירים העדכני או את כל היסטוריית כיסוי המחירים.
קבלת נתונים סטטיסטיים עדכניים על כיסוי המחירים
בדוגמה הבאה מאחזרים את נתוני הכיסוי העדכניים ביותר של המחירים בחשבון 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
איך מקבלים את היסטוריית הכיסוי של המחירים
הבקשה הזו מחזירה את כל היסטוריית הכיסוי של המחירים בחשבון:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
מחיר
השירות Price Views מאפשר לכם לאחזר דוח מחירים של נכס מסוים.
אחזור נתוני תמחור של נכס
כדי לקבל את דוח התמחור של מלון מסוים (מזהה=101) ששייך לחשבון 12345678, שולחים את הבקשה הבאה:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
דוחות התאמה
.שירות דוחות ההתאמה מאפשר לכם לקבל רשימה של דוחות, להוריד דוח מסוים, לאמת אותו ואז להעלות את הדוח ל-Google.
קבלת רשימה של דוחות התאמה
בדוגמה הבאה מוצגת רשימה של דוחות עבור חשבון 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
אפשר לכלול פרמטרים אופציונליים של שאילתות לגבי תאריכי התחלה וסיום כדי להגביל את התוצאות. לדוגמה, השאילתה הזו מגבילה את הדוחות רק לאלה שבין 15 ביוני 2019 ל-15 בספטמבר 2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
הורדת דוח התאמה
בדוגמה הזו מאחזרים את הדוח booking_report.csv (כתגובת JSON) שהועלה ב-2019-08-26T12:00:00:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
אימות של דוח התאמה
אפשר להשתמש בשיטה הזו כדי לאמת את הדוח לפני שמעלים אותו. אימות דוח לא גורם להעלאה שלו.
דוח ההתאמה נכלל בגוף הבקשה, כערך של השדה contents. כשיוצרים את הקובץ צריך להקפיד על כללי התחביר שמפורטים בקטע דוחות התאמה.
בדוגמה הבאה מתבצעת אימות של דוח עבור חשבון 12345678:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
העלאת דוח התאמה
אחרי שמאשרים שדוח ההתאמה תקין, אפשר להעלות אותו ל-Google כמו בדוגמה הזו:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports