Release Notes

نسخه 3 Travel Partner API به شما امکان دسترسی برنامه‌ریزی به موارد زیر را می‌دهد:

  • مدیریت پیوندهای حساب بین مرکز هتل و تبلیغات گوگل
  • مدیریت تنظیمات هتل انتخاب شده
  • مدیریت برندها و نمادها (بتای بسته)
  • داده های عملکرد دارایی از طریق سرویس مشاهده گزارش عملکرد دارایی
  • اطلاعات هتل از طریق سرویس نمای هتل
  • داده های گزارش مشارکت از طریق سرویس مشاهده گزارش مشارکت
  • داده های دقت قیمت از طریق سرویس مشاهده دقت قیمت
  • داده های پوشش قیمت از طریق سرویس مشاهده پوشش قیمت
  • داده های سفر و قیمت از طریق سرویس مشاهده قیمت
  • مدیریت گزارش‌های تطبیق کمیسیون از طریق سرویس گزارش‌های آشتی (فقط شرکای پرداخت به ازای هر اقامت)

نقاط پایانی

نقاط پایانی Travel Partner API از طریق دستور REST-ful از تماس‌های HTTPS قابل دسترسی است. URL پایه برای همه درخواست ها این است:

https://travelpartner.googleapis.com

نقاط پایانی خدمات
پیوندهای حساب

پیوندهای بین حساب Google Ads و حساب مرکز هتل را مدیریت می کند.

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

می‌توانید شناسه حساب خود را در نمای اطلاعات حساب در برگه حساب در مرکز تبلیغات هتل جستجو کنید.

تغییرات

بسیاری از خدمات در Travel Partner API نسخه 2.1 به Google Ads API منتقل شده اند. در نتیجه Travel Partner API v3 فقط خدمات خاص هتل را حفظ می کند.

خدمات هتل ویو

  • HotelViewService.ListHotelViews (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 (قبلا فرصت_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 (API گزارش قبلی price_accuracy)

  • 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 و همچنین تاریخ‌های منسوخ و غروب خورشید مورد انتظار را نشان می‌دهد:

نسخه تاریخ منسوخ شدن تاریخ غروب آفتاب
نسخه 3.0 N/A N/A
نسخه 2.1 سپتامبر 2019 31 مه 2020
نسخه 2.0 (Bids API) فوریه 2018 می 2018
نسخه 2.0 (همه APIهای دیگر) سپتامبر 2019 15 فوریه 2020
نسخه 1.2 فوریه 2018 می 2018
نسخه 1.1 ژوئن 2016 اکتبر 2016
نسخه 1.0 آوریل 2015 اکتبر 2015

احراز هویت

برای دسترسی به Travel Partner API، مشتریان باید با استفاده از احراز هویت OAuth2 احراز هویت کنند.

برای مثال برنامه کاربردی و اطلاعات اضافی درباره استفاده از OAuth برای اتصال به Travel Partner API، به API Authentication مراجعه کنید.