Usage

בדף הזה מוצגות כמה קריאות לדוגמה באמצעות גרסה 3 של Google Partner API.

נקודות הקצה (endpoints) של שלכם בתוכנית השותפים של הנסיעות משתמשות בתחביר שמותאם ל-REST באמצעות קריאות ל-HTTPS. base_url עבור כל בקשות ה-API הוא:

https://travelpartner.googleapis.com/v3/accounts/account_id

הרשימה המלאה של שדות הבקשות והתשובות זמינה בקטלוג המשאבים של ה-API.

דוח ביצועי נכסים

שירות תצוגת דוח הביצועים של נכס מספק את היכולת לשלוח שאילתות (לקבל, לסנן ולפלח) דוח ביצועי נכסים עבור חשבון ספציפי.

שליחת שאילתה לדוח ביצועים של נכס

בדוגמה הבאה מופיע דוח ביצועי הנכס לכל הנכסים בחשבון 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/10/20.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

המחירים המדויקים

השירות 'דיוק המחירים' מאפשר לאחזר דוחות וכרטיסי מידע של דיוק מחירים בחשבון מסוים.

קבלת דוח דיוק במחירים

הדוגמה הבאה מאחזרת את דוח דיוק המחירים ב-26/8/2019 עבור החשבון 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826

מלבד הפרמטרים הרגילים של השאילתות, כדי לעבור בין הדפים במהלך התגובה, יש עוד כמה פרמטרים לציון מחירים תואמים או אותות פיקסלים בתוצאות.

בדוגמה הזו, דוח דיוק המחירים ב-26/8/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

כיסוי מחירים

שירות תצוגות של כיסוי מחירים מספק את הדוח העדכני ביותר של מחירי הכיסוי או את ההיסטוריה המלאה של הדפים הנכללים באינדקס.

קבלת נתונים סטטיסטיים עדכניים לגבי כיסוי המחירים

הדוגמה הבאה מאחזרת את הנתונים הסטטיסטיים העדכניים ביותר של כיסוי המחיר לחשבון 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

הצגת ההיסטוריה של כיסוי המחירים

הבקשה הזו מקבלת את כל היסטוריית כיסוי המחירים עבור חשבון:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews

מחיר

שירות תצוגות המחיר מאפשר לכם לאחזר דוח מחירים לנכס מסוים.

קבלת נתוני תמחור של נכס

כדי לקבל את דוח התמחור של מלון ספציפי (ID=101) השייך לחשבון 12345678, יש לשלוח את הבקשה הבאה:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

דוחות התאמה

שירות דוחות ההתאמה

קבלת רשימה של דוחות התאמה

בדוגמה הבאה מופיעה רשימת דוחות לחשבון 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