Usage

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