- Permintaan HTTP
- Parameter jalur
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan Otorisasi
- PropertyPerformanceResult
- AdvancedBookingWindow
- Durasi Lama
- Jumlah tamu
Memberikan kemampuan untuk membuat kueri (mendapatkan, memfilter, dan menyegmentasikan) laporan link performa properti untuk akun tertentu.
Permintaan HTTP
GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/propertyPerformanceReportViews:query
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
name |
Nama resource akun yang dikueri. Format: accounts/{account_id} |
Parameter kueri
Parameter | |
---|---|
filter |
Kondisi (kolom dan ekspresi) digunakan untuk memfilter metrik performa properti untuk akun yang dikueri. Sintaksis memerlukan spasi di sekitar operator Kolom Nilai kolom Nilai untuk Contoh kondisi yang valid adalah sebagai berikut:
|
aggregateBy |
Menentukan cara menyegmentasikan metrik yang ditampilkan oleh kueri. Misalnya, jika Nilai string adalah daftar kolom yang dipisahkan koma. Kolom yang valid adalah: |
pageSize |
Jumlah maksimum hasil partisipasi yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 10.000 hasil akan ditampilkan. Nilai maksimum adalah 10.000; nilai di atas 10.000 akan dikonversi menjadi 10.000. |
pageToken |
Token halaman, diterima dari permintaan partisipasiReportReports.query sebelumnya. Berikan ini untuk menerima halaman berikutnya. Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk partisipasiReportViews.query harus sesuai dengan panggilan yang disediakan token halaman. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Pesan respons untuk PropertyPerformanceReportService.QueryPropertyPerformanceReport
.
Representasi JSON |
---|
{
"results": [
{
object ( |
Kolom | |
---|---|
results[] |
Daftar hasil yang cocok dengan kueri. |
nextPageToken |
Token penomoran yang digunakan untuk mengambil halaman hasil berikutnya. Jika kolom ini dihilangkan, maka tidak ada halaman berikutnya. |
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/travelpartner
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
PropertiPerformanceResult
Merepresentasikan hasil dari melakukan kueri untuk laporan performa properti untuk akun.
Representasi JSON |
---|
{ "date": { object ( |
Kolom | |
---|---|
date |
Tanggal dalam rentang tanggal yang diminta. Hanya ada jika |
advanceBookingWindow |
Perbedaan hari antara tanggal kueri dan tanggal check-in di zona waktu lokal properti. Hanya ada jika |
brand |
Merek yang ditentukan partner untuk properti. Hanya ada jika |
deviceType |
Jenis perangkat pengguna. Hanya ada jika |
highIntentUsers |
Apakah kueri pengguna menunjukkan minat yang kuat pada pemesanan. Hanya ada jika |
lengthOfStay |
Jumlah malam antara tanggal check-in dan check-out yang ditentukan oleh pengguna. Hanya ada jika |
propertyRegionCode |
Kode wilayah ISO 3116 negara/wilayah properti. Hanya ada jika |
occupancy |
Meminta jumlah orang yang menginap di properti tersebut. Hanya ada jika |
partnerPropertyId |
ID properti partner. Hanya ada jika |
partnerPropertyDisplayName |
Nama properti partner. Hanya ada jika |
userRegionCode |
Kode wilayah ISO 3116 negara/wilayah pengguna. Hanya ada jika |
clickCount |
Total jumlah klik yang direkam untuk hasil ini. |
impressionCount |
Total jumlah tayangan yang direkam untuk hasil ini. Nilai ini dibulatkan untuk menjaga privasi pengguna. |
clickthroughRate |
Setara dengan |
WindowBookingWindow
Menghitung periode pemesanan di awal (ABW) yang didukung. Semua perbandingan tanggal berada di zona waktu properti.
Enumerasi | |
---|---|
ADVANCE_BOOKING_WINDOW_UNSPECIFIED |
Tidak ditentukan. |
ADVANCE_BOOKING_WINDOW_SAME_DAY |
Tanggal check-in sama dengan tanggal kueri. |
ADVANCE_BOOKING_WINDOW_NEXT_DAY |
Tanggal check-in adalah hari berikutnya setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 |
Tanggal check-in adalah 2-7 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 |
Tanggal check-in adalah 8-14 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 |
Tanggal check-in adalah 15-30 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 |
Tanggal check-in adalah 31-60 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 |
Tanggal check-in adalah 61-90 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 |
Tanggal check-in adalah 91-120 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 |
Tanggal check-in adalah 121-150 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 |
Tanggal check-in adalah 151-180 hari setelah tanggal kueri. |
ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 |
Tanggal check-in lebih dari 180 hari setelah tanggal kueri. |
Lama Menginap
Menghitung durasi menginap yang didukung (LOS).
Enumerasi | |
---|---|
LENGTH_OF_STAY_UNSPECIFIED |
Tidak ditentukan. |
LENGTH_OF_STAY_NIGHTS_1 |
Menginap satu malam. |
LENGTH_OF_STAY_NIGHTS_2 |
Menginap 2 malam. |
LENGTH_OF_STAY_NIGHTS_3 |
Menginap 3 malam. |
LENGTH_OF_STAY_NIGHTS_4_TO_7 |
Menginap selama 4-7 malam. |
LENGTH_OF_STAY_NIGHTS_8_TO_14 |
Menginap selama 8-14 malam. |
LENGTH_OF_STAY_NIGHTS_15_TO_21 |
Menginap selama 15-21 malam. |
LENGTH_OF_STAY_NIGHTS_22_TO_30 |
Menginap selama 22-30 malam. |
LENGTH_OF_STAY_NIGHTS_OVER_30 |
Menginap lebih dari 30 malam. |
Penggunaan
Menghitung jumlah total tamu yang didukung.
Enumerasi | |
---|---|
OCCUPANCY_UNSPECIFIED |
Tidak ditentukan. |
OCCUPANCY_1 |
Satu orang. |
OCCUPANCY_2 |
Dua orang. |
OCCUPANCY_3 |
Tiga orang. |
OCCUPANCY_4 |
Empat orang. |
OCCUPANCY_OVER_4 |
Lebih dari 4 orang. |