Release Notes

Travel Partner API versi 3 memberi Anda akses terprogram ke:

  • Pengelolaan penautan akun antara Pusat Pengelolaan Hotel dan Google Ads
  • Pengelolaan setelan hotel yang dipilih
  • Pengelolaan brand dan ikon (beta tertutup)
  • Data performa properti melalui Layanan Tampilan Laporan Performa Properti
  • Data hotel melalui Hotel Views Service
  • Data laporan partisipasi melalui Layanan Tampilan Laporan Partisipasi
  • Data akurasi harga melalui Price Accuracy Views Service
  • Data cakupan harga melalui Price Coverage Views Service
  • Data itinerari dan harga melalui Price Views Service
  • Pengelolaan laporan rekonsiliasi komisi melalui Reconciliation Reports Service (khusus partner dengan komisi bayar per kunjungan)

Endpoint

Endpoint Travel Partner API dapat diakses melalui sintaksis RESTful dari panggilan HTTPS. URL dasar untuk semua permintaan adalah:

https://travelpartner.googleapis.com

Endpoint Service
Penautan Akun

Mengelola penautan antara akun Google Ads dan akun Pusat Pengelolaan Hotel.

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

Merek

Ubah konfigurasi Merek. (beta tertutup)

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

Hotel

Ubah setelan hotel yang dipilih.

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

Penayangan Hotel

Menampilkan daftar penayangan hotel atau ringkasan.

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

Ikon

Mengelola ikon. (beta tertutup)

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

Penayangan Laporan Partisipasi

Menampilkan tampilan laporan partisipasi atau, dengan menggunakan kueri, menampilkan subset data tampilan yang difilter.

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

Tampilan Akurasi Harga

Menampilkan tampilan akurasi harga tertentu, tampilan akurasi yang tersedia, atau ringkasan.

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

Tampilan Cakupan Harga

Menampilkan tampilan cakupan harga terbaru atau seluruh histori cakupan.

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

Penayangan Harga

Menampilkan tampilan harga yang diminta dengan detail lengkap.

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

Tampilan Laporan Performa Properti

Menampilkan tampilan laporan performa properti menggunakan kueri.

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

Laporan Rekonsiliasi

Membuat, memvalidasi, dan mengambil laporan rekonsiliasi komisi (khusus Iklan Hotel).

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

Anda dapat mencari ID akun di bagian tampilan Info Akun pada tab Akun di Pusat Bantuan Iklan Hotel.

Log perubahan

Banyak layanan di Travel Partner API v2.1 telah dimigrasikan ke Google Ads API. Oleh karena itu, Travel Partner API v3 hanya mempertahankan layanan khusus hotel.

HotelViewService

  • HotelViewService.ListHotelViews (sebelumnya Hotels API)
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/hotels menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
    • Menghapus parameter permintaan type.
    • Menghapus kolom manifestOnly dalam respons.
    • Beberapa kolom telah diganti namanya.
  • HotelViewService.SummarizeHotelViews (sebelumnya hotel_list_stats di Scorecard API)
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
    • Beberapa kolom telah diganti namanya.

ParticipationReportViewService (sebelumnya opportunity_stats di Scorecard API)

  • ParticipationReportService.QueryParticipationReport
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
    • Parameter kueri telah ditambahkan.
    • Kolom telah diganti namanya dan disusun ulang.

PriceAccuracyViewService (sebelumnya price_accuracy report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
    • API baru menampilkan daftar nama resource tampilan hotel, bukan versi sebelumnya yang menampilkan daftar tanggal laporan.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
    • Output CSV tidak lagi didukung.
    • Beberapa kolom telah diganti namanya.

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (sebelumnya price_coverage_stats_history di Scorecard API)
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
    • Beberapa kolom telah diganti namanya.
  • PriceAccuracyViewService.GetLatestPriceCoverageViews (sebelumnya price_coverage_stats di Scorecard API)
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
    • Beberapa kolom telah diganti namanya.

PriceViewService (sebelumnya Prices API)

  • PriceViewService.GetPriceView
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
    • Beberapa kolom telah diganti namanya.
    • Menghapus informasi bid dari respons.

Metode ReconciliationReportService (sebelumnya Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.GetReconciliationReport
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
  • ReconciliationReportService.CreateReconciliationReport
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.ValidateReconciliationReport
    • Endpoint API telah berubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Status penghentian penggunaan

Tidak digunakan lagi
menunjukkan bahwa versi API akan terus berfungsi seperti yang diharapkan, tetapi mungkin tidak diupdate dengan fitur baru atau perbaikan bug. Selain itu, saat versi tidak digunakan lagi, tanggal penghentian akan ditentukan.
Dihentikan
menunjukkan bahwa versi API dihapus dan tidak lagi tersedia. Jangka waktu minimum antara penghentian penggunaan dan penghentian total adalah 3 bulan.

Tabel berikut menunjukkan jadwal versi API saat ini, serta tanggal penghentian dan penonaktifan yang diharapkan:

Versi Tanggal Penghentian Tanggal Penghentian
v3.0 T/A T/A
v2.1 September 2019 31 Mei 2020
v2.0 (Bids API) Februari 2018 Mei 2018
v2.0 (semua API lainnya) September 2019 15 Februari 2020
v1.2 Februari 2018 Mei 2018
v1.1 Juni 2016 Oktober 2016
v1.0 April 2015 Oktober 2015

Autentikasi

Untuk mengakses Travel Partner API, klien harus melakukan autentikasi menggunakan autentikasi OAuth2.

Untuk contoh aplikasi dan informasi tambahan tentang penggunaan OAuth untuk terhubung ke Travel Partner API, lihat Autentikasi API.