Usage

בדף הזה מוצגות כמה דוגמאות לקריאות באמצעות 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

דוחות התאמה

Reconciliation Reports Service מאפשר לכם לקבל רשימה של דוחות, להוריד דוח מסוים, לאמת אותו ואז להעלות את הדוח ל-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