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 merek dan ikon (beta tertutup)
  • Data performa properti melalui Layanan Tampilan Laporan Performa Properti
  • Data hotel melalui Layanan Tampilan Hotel
  • Data laporan partisipasi melalui Layanan Penayangan Laporan Partisipasi
  • Data akurasi harga melalui Layanan Tampilan Akurasi Harga
  • Data cakupan harga melalui Layanan Tampilan Cakupan Harga
  • Data itinerari dan harga melalui Layanan Tampilan Harga
  • Pengelolaan laporan rekonsiliasi komisi melalui Layanan Laporan Rekonsiliasi (khusus partner bayar per kunjungan komisi)

Endpoint

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

https://travelpartner.googleapis.com

Endpoint layanan
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

Mengubah 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

Tampilan Hotel

Menampilkan daftar tampilan hotel atau ringkasan.

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

Ikon

Kelola ikon. (beta tertutup)

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

Tampilan Laporan Partisipasi

Menampilkan tampilan laporan partisipasi atau, dengan menggunakan kueri, menampilkan subkumpulan 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

Tampilan Harga

Menampilkan tampilan harga yang diminta secara mendetail.

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 pada tampilan Info Akun dari tab Akun di Pusat Bantuan Iklan Hotel.

Log perubahan

Banyak layanan di Travel Partner API v2.1 telah dimigrasikan ke Google Ads API. Akibatnya, Travel Partner API v3 hanya menyimpan layanan khusus hotel.

LayananTampilanHotel

  • HotelViewService.ListHotelViews (sebelumnya Hotels API)
    • Endpoint API telah diubah 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 di respons.
    • Beberapa kolom telah diganti namanya.
  • HotelViewService.SummarizeHotelViews (sebelumnya hotel_list_stats di Scorecard API)
    • Endpoint API telah diubah 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.

PartisipasiLaporanViewService (sebelumnya peluang_stats di Scorecard API)

  • ParticipationReportService.QueryParticipationReport
    • Endpoint API telah diubah 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.

PriceAkurasiViewService (sebelumnya price_accuracy report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Endpoint API telah diubah dari https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy menjadi https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
    • API baru ini menampilkan daftar nama resource tampilan hotel, bukan versi sebelumnya, yang menampilkan daftar tanggal laporan.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Endpoint API telah diubah 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 didukung lagi.
    • Beberapa kolom telah diganti namanya.

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (sebelumnya price_coverage_stats_history di Scorecard API)
    • Endpoint API telah diubah 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 diubah 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 Price API)

  • PriceViewService.GetPriceView
    • Endpoint API telah diubah 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 diubah 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 diubah 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 diubah 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 diubah 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, ketika versi tidak digunakan lagi, tanggal matahari terbenam akan ditentukan.
Dihentikan
menunjukkan bahwa versi API dihapus dan tidak lagi tersedia. Jumlah minimum waktu antara penghentian dan penghentian adalah 3 bulan.

Tabel berikut menunjukkan jadwal versi API saat ini, serta perkiraan penghentian dan tanggal penghentian:

Version Tanggal Penghentian Tanggal Penghentian
v3.0 T/A T/A
v2.1 September 2019 31 Mei 2020
v2.0 (API Bid) 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 mengautentikasi menggunakan autentikasi OAuth2.

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