Halaman ini menyajikan beberapa contoh panggilan menggunakan Travel Partner API v3.
Endpoint Travel Partner API menerima sintaksis RESTful dalam panggilan HTTPS. base_url untuk semua permintaan API adalah:
https://travelpartner.googleapis.com/v3/accounts/account_id
Untuk mengetahui daftar lengkap kolom permintaan dan respons, lihat katalog resource API.
Laporan performa properti
Layanan Tampilan Laporan Performa Properti memberikan kemampuan untuk membuat kueri (mendapatkan, memfilter, dan menyegmentasikan) laporan performa properti untuk akun tertentu.
Membuat kueri laporan performa properti
Contoh berikut mendapatkan laporan performa properti untuk semua properti di akun 12345678
, yang difilter ke tanggal 11 Mei 2022, dan dikelompokkan menurut ID hotel partner.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Hotel
Hotel View Service menyediakan daftar semua hotel atau ringkasannya untuk akun tertentu.
Mendapatkan daftar hotel
Contoh berikut mengambil daftar semua hotel di akun 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
Permintaan menerima parameter kueri untuk menavigasi hasil multi-halaman:
GET base_url/hotelViews?pageSize=10&pageToken=11
Mendapatkan ringkasan properti
Contoh ini mendapatkan ringkasan properti untuk akun 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
Laporan partisipasi
Participation Report View Service memberikan kemampuan untuk membuat kueri (mendapatkan, memfilter, dan menyegmentasikan) laporan partisipasi untuk akun tertentu.
Mengirimkan kueri laporan partisipasi
Contoh berikut mendapatkan laporan partisipasi untuk semua properti di akun 12345678
dan memfilter laporan menggunakan tanggal 4/10/20.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
Keakuratan harga
Price Accuracy Views Service memungkinkan pengambilan laporan dan kartu skor akurasi harga untuk akun tertentu.
Mendapatkan laporan akurasi harga
Contoh berikut mengambil laporan akurasi harga pada 26/8/2019 untuk akun 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Selain parameter kueri biasa untuk menelusuri respons, ada beberapa parameter lagi untuk menyertakan harga yang cocok atau sinyal piksel dalam hasil.
Dalam contoh ini, laporan akurasi harga pada 26/08/2019 mencakup harga yang cocok dan sinyal piksel:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Mencantumkan laporan akurasi harga yang tersedia
Untuk mendapatkan daftar laporan yang tersedia, kirim permintaan ini:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Anda dapat menyertakan parameter kueri biasa untuk melakukan penomoran halaman hasil.
Mendapatkan skor akurasi harga
Untuk mendapatkan kartu skor akurasi harga, gunakan metode summarize
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
Cakupan harga
Layanan Tampilan Cakupan Harga memberikan laporan cakupan harga terbaru atau seluruh histori cakupan harga.
Mendapatkan statistik cakupan harga terbaru
Contoh berikut mengambil statistik cakupan harga terbaru untuk akun 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
Mendapatkan histori cakupan harga
Permintaan ini mendapatkan seluruh histori cakupan harga untuk akun:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
Harga
Price Views Service memungkinkan Anda mengambil laporan harga untuk properti tertentu.
Mendapatkan data harga untuk properti
Untuk mendapatkan laporan harga untuk hotel tertentu (ID=101
) yang termasuk dalam akun 12345678
, kirimkan permintaan ini:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
Laporan rekonsiliasi
Reconciliation Reports Service memungkinkan Anda mendapatkan daftar laporan, mendownload laporan tertentu, memvalidasinya, lalu mengupload laporan ke Google.
Mendapatkan daftar laporan rekonsiliasi
Contoh berikut mendapatkan daftar laporan untuk akun 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Anda dapat menyertakan parameter kueri tanggal mulai dan akhir opsional untuk membatasi hasil. Misalnya, kueri ini membatasi laporan hanya pada laporan antara 15/6/2019 hingga 15/9/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Mendownload laporan rekonsiliasi
Contoh ini mengambil laporan booking_report.csv
(sebagai respons JSON) yang diupload pada 2019-08-26T12:00:00
:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Memvalidasi laporan rekonsiliasi
Anda dapat menggunakan metode ini untuk memvalidasi laporan sebelum menguploadnya. Memvalidasi laporan tidak akan menguploadnya.
Laporan rekonsiliasi disertakan dalam isi permintaan, sebagai nilai untuk kolom contents
. Laporan rekonsiliasi harus mengikuti sintaksis yang dijelaskan dalam Laporan rekonsiliasi.
Contoh berikut memvalidasi laporan untuk akun 12345678
:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Mengupload laporan rekonsiliasi
Setelah mengonfirmasi bahwa laporan rekonsiliasi valid, Anda dapat menguploadnya ke Google seperti dalam contoh ini:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports