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 berdasarkan ID hotel partner.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Layanan Tampilan Laporan Partisipasi memberikan kemampuan untuk mengajukan kueri (mendapatkan, memfilter, dan menyegmentasikan) laporan partisipasi untuk akun tertentu.
Membuat 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
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 melakukan paging melalui respons, ada beberapa parameter lainnya untuk menyertakan harga atau sinyal piksel yang cocok dalam hasil.
Dalam contoh ini, laporan akurasi harga pada 26/8/2019 menyertakan 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
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 untuk laporan antara 15/6/2019 hingga 15/9/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
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
Contoh respons
{
"contents": "Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel PostalCode,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status\n\n111,\"Capybara Hotel and Spa\",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04,2016-02-01,2016-02-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required\n\n211,\"Mabels Gabels\",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-02-04,2016-02-01,2016-02-03,1,3,414.21,GBP,1.249,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required\n\n311,\"No-Tell Motels\",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-03-04,2016-02-01,2016-02-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,2016-06-07,Invoice Required"
}
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
Contoh respons yang berhasil
{
"successfulRecordCount": 3
}
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
Semua hak dilindungi undang-undang. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2022-08-23 UTC.
[null,null,["Terakhir diperbarui pada 2022-08-23 UTC."],[[["The Travel Partner API uses REST-ful syntax for HTTPS calls to various endpoints, allowing access to data like property performance, hotel details, and price accuracy."],["You can query reports, like the Property Performance Report or the Participation Report, to gain insights into your hotel data using specific filters and aggregations."],["The API provides methods for retrieving hotel lists, summaries, price coverage information, and pricing data for individual properties within your account."],["Reconciliation Reports, specifically for Hotel Ads, can be listed, downloaded, validated, and uploaded through dedicated API endpoints."],["The base URL for all API requests is `https://travelpartner.googleapis.com/v3/accounts/account_id`, and detailed documentation for resources is available in the API resources catalog."]]],[]]