Release Notes

גרסה 3 של Travel Partner API מאפשרת גישה פרוגרמטית אל:

  • ניהול קישורים בין חשבון Hotel Center לבין חשבון Google Ads
  • ניהול ההגדרות של המלונות שנבחרו
  • ניהול של מותגים וסמלים (בטא סגורה)
  • נתוני ביצועים ברמת המלון באמצעות Property Performance Report Views Service
  • נתוני מלונות דרך Hotel Views Service
  • נתונים מדוח ההשתתפות דרך Participation Report Views Service
  • נתונים של דיוק מחירים באמצעות Price Accuracy Views Service
  • נתוני כיסוי מחירים באמצעות Price Coverage Views Service
  • נתוני מסלול נסיעה ותמחור באמצעות Price Views Service
  • ניהול של דוחות התאמה של עמלות באמצעות Reconciliation Reports Service (רק שותפים שמשלמים עמלות על כל שהייה)

נקודות קצה

אפשר לגשת לנקודות הקצה של Travel Partner API באמצעות תחביר RESTful מקריאות HTTPS. כתובת ה-URL הבסיסית לכל הבקשות היא:

https://travelpartner.googleapis.com

נקודות קצה של שירותים
קישור חשבונות

ניהול קישורים בין חשבון Google Ads לחשבון Hotel Center.

POST /v3/accounts/account id/accountLinks
DELETE /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks
PATCH /v3/accounts/account id/accountLinks/account link id

מותגים

שינוי הגדרת המותג. (בטא סגורה)

POST /v3/accounts/account id/brands
GET /v3/accounts/account id/brands
PATCH /v3/accounts/account id/brands/brand id

בתי מלון

שינוי ההגדרות של המלונות שנבחרו.

POST /v3/accounts/account id/hotels:setLiveOnGoogle

צפיות במלון

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

GET /v3/accounts/account id/hotelViews
GET /v3/accounts/account id/hotelViews:summarize

סמלים

ניהול סמלים. (בטא סגורה)

POST /v3/accounts/account id/icons
GET /v3/accounts/account id/icons/icon id

צפיות בדוח השתתפות

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

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

צפיות בדיוק המחירים

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

GET /v3/accounts/account id/priceAccuracyViews/report date
GET /v3/accounts/account id/priceAccuracyViews
GET /v3/accounts/account id/priceAccuracyViews:summarize

צפיות בכיסוי מחירים

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

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

צפיות במחיר

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

GET /v3/accounts/account id/priceViews/partner hotel id

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

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

GET /v3/accounts/account id/participationReportViews:query

דוחות התאמה

יצירה, אימות ואחזור של דוחות התאמת עמלות (רק ב-Hotel Ads).

POST /v3/accounts/account id/reconciliationReports
POST /v3/accounts/account id/reconciliationReports:validate
GET /v3/accounts/account id/reconciliationReports/datetime~filename
GET /v3/accounts/account id/reconciliationReports

אפשר למצוא את מספר החשבון בתצוגה פרטי החשבון בכרטיסייה חשבון ב-Hotel Ads Center.

יומן שינויים

הרבה שירותים ב-Travel Partner API גרסה 2.1 הועברו אל Google Ads API. כתוצאה מכך, ב-Travel Partner API v3 נשארים רק שירותים ספציפיים למלונות.

HotelViewService

  • HotelViewService.ListHotelViews (לשעבר Hotels API)
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/hotels ל-https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
    • הוסר פרמטר הבקשה type.
    • הוסר השדה manifestOnly בתשובה.
    • השמות של חלק מהשדות השתנו.
  • HotelViewService.SummarizeHotelViews (לשעבר hotel_list_stats ב-Scorecard API)
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats ל-https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
    • השמות של חלק מהשדות השתנו.

‫ParticipationReportViewService (לשעבר opportunity_stats ב-Scorecard API)

  • ParticipationReportService.QueryParticipationReport
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats ל-https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
    • הפרמטרים של השאילתה נוספו.
    • השמות של השדות שונו והמבנה שלהם שונה.

‫PriceAccuracyViewService (לשעבר price_accuracy report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy ל-https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
    • ה-API החדש מחזיר רשימה של שמות משאבים של צפיות במלונות, בניגוד לגרסה הקודמת שמחזירה רשימה של תאריכי דוחות.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 ל-https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
    • אין יותר תמיכה בפלט CSV.
    • השמות של חלק מהשדות השתנו.

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (לשעבר price_coverage_stats_history ב-Scorecard API)
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history ל-https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
    • השמות של חלק מהשדות השתנו.
  • PriceAccuracyViewService.GetLatestPriceCoverageViews (לשעבר price_coverage_stats ב-Scorecard API)
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats ל-https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
    • השמות של חלק מהשדות השתנו.

‫PriceViewService (לשעבר Prices API)

  • PriceViewService.GetPriceView
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id ל-https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
    • השמות של חלק מהשדות השתנו.
    • הוסר מהתשובה מידע על הצעות מחיר.

שיטות של ReconciliationReportService (לשעבר Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports ל-https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.GetReconciliationReport
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename ל-https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
  • ReconciliationReportService.CreateReconciliationReport
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports ל-https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.ValidateReconciliationReport
    • נקודת הקצה של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate ל-https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

הוצאה משימוש

הוצא משימוש
‫
מציין שגרסת ה-API תמשיך לפעול כצפוי, אבל יכול להיות שלא יתבצעו בה עדכונים עם תכונות חדשות או תיקוני באגים. בנוסף, כשמוציאים גרסה משימוש, נקבע תאריך סיום התמיכה.
יצא משימוש
‫
מציין שהגרסה של ה-API הוסרה והיא לא זמינה יותר. פרק הזמן המינימלי בין הוצאה משימוש לבין סגירה הוא 3 חודשים.

בטבלה הבאה מוצג לוח הזמנים הנוכחי של גרסאות ה-API, וגם תאריכי ההוצאה משימוש וההפסקה הצפויים:

גרסה תאריך ההוצאה משימוש תאריך היציאה משימוש
v3.0 לא רלוונטי לא רלוונטי
v2.1 ספטמבר 2019 31 במאי 2020
גרסה 2.0 (Bids API) פברואר 2018 מאי 2018
‫v2.0 (כל שאר ממשקי ה-API) ספטמבר 2019 ‫15 בפברואר 2020
v1.2 פברואר 2018 מאי 2018
v1.1 יוני 2016 אוקטובר 2016
v1.0 אפריל 2015 אוקטובר 2015

אימות

כדי לגשת אל Travel Partner API, הלקוחות צריכים לבצע אימות באמצעות אימות OAuth2.

לדוגמה של אפליקציה ולמידע נוסף על שימוש ב-OAuth כדי להתחבר ל-Travel Partner API, אפשר לעיין במאמר בנושא אימות API.