Release Notes

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

  • ניהול קישורים בין חשבון Hotel Center לחשבון Google Ads
  • ניהול ההגדרות של המלונות שנבחרו
  • ניהול של מותגים וסמלים (בטא סגורה)
  • נתוני ביצועים ברמת המלון באמצעות Property Performance Report Views Service
  • נתוני מלונות באמצעות Hotel Views Service
  • נתונים מדוח ההשתתפות דרך Participation Report 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

Icons

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

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)
    • נקודת הקצה (endpoint) של ה-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)
    • נקודת הקצה (endpoint) של ה-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
    • נקודת הקצה (endpoint) של ה-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
    • נקודת הקצה (endpoint) של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy ל-https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
    • ה-API החדש מחזיר רשימה של שמות משאבים של צפיות במלונות, בניגוד לגרסה הקודמת שמחזירה רשימה של תאריכי דוחות.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • נקודת הקצה (endpoint) של ה-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)
    • נקודת הקצה (endpoint) של ה-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)
    • נקודת הקצה (endpoint) של ה-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
    • נקודת הקצה (endpoint) של ה-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
    • נקודת הקצה (endpoint) של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports ל-https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.GetReconciliationReport
    • נקודת הקצה (endpoint) של ה-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
    • נקודת הקצה (endpoint) של ה-API השתנתה מ-https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports ל-https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.ValidateReconciliationReport
    • נקודת הקצה (endpoint) של ה-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
גרסה 2.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.