Release Notes

גרסה 3 של ה-API של שותף השותפים נותנת לכם גישה פרוגרמטית ל:

  • ניהול קישורים לחשבון בין Hotel Center ל-Google Ads
  • ניהול הגדרות המלונות שנבחרו
  • ניהול מותגים וסמלים (גרסת בטא סגורה)
  • נתוני ביצועי הנכס דרך שירות הצפיות בדוח הביצועים של הנכס
  • נתוני מלונות דרך השירות 'צפיות במלון'
  • נתוני דוחות ההשתתפות דרך השירות 'צפיות בדוח השתתפות'
  • נתוני דיוק במחירים דרך שירות 'דיוק רמת הדיוק של המחירים'
  • נתוני כיסוי המחירים באמצעות שירות צפיות המחיר
  • נתוני לוחות זמנים ותמחור דרך השירות 'צפיות במחיר'
  • ניהול דוחות התאמה של עמלות דרך שירות דוחות ההתאמה (שותפים מבוססי עמלות לשהייה בלבד)

נקודות קצה

אפשר לגשת לנקודות הקצה של Partner Partner API באמצעות תחביר עם REST מקריאות ל-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

דוחות התאמה

יצירה, אימות ואחזור של דוחות התאמה של עמלות (מודעות להזמנת חדרים בלבד).

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.

יומן שינויים

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

מלוןViewViewService

  • 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 ב-ניקודcard 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.
    • השמות של חלק מהשדות שונו.

ServiceCoverageViewService

  • 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, וגם תאריכי ההוצאה משימוש וההוצאה הצפויה:

גרסה תאריך הוצאה משימוש תאריך שקיעה
גרסה 3.0 לא רלוונטי לא רלוונטי
גרסה 2.1 ספטמבר 2019 31 במאי 2020
גרסה 2.0 (API של הצעות מחיר) פברואר 2018 מאי 2018
גרסה 2.0 (כל ממשקי ה-API האחרים) ספטמבר 2019 15 בפברואר 2020
v1.2 פברואר 2018 מאי 2018
גרסה 1.1 יוני 2016 אוקטובר 2016
גרסה 1.0 אפריל 2015 אוקטובר 2015

אימות

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

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