Method: accounts.freeBookingLinksReportViews.query

TIDAK DIGUNAKAN LAGI: Menggunakan PropertyPerformanceReportService.QueryPropertyPerformanceReport, yang juga memiliki pelaporan tayangan. Memberikan kemampuan untuk membuat kueri (mendapatkan, memfilter, dan menyegmentasikan) laporan link pemesanan gratis untuk akun tertentu.

Permintaan HTTP

GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/freeBookingLinksReportViews:query

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Nama resource akun yang dikueri. Format: accounts/{account_id}

Parameter kueri

Parameter
filter

string

Kondisi (kolom dan ekspresi) digunakan untuk memfilter metrik link pemesanan gratis untuk akun yang dikueri. Sintaksis memerlukan spasi di sekitar operator in. Jika tidak, spasi dapat dihilangkan. Kondisi dapat digabungkan menggunakan operator and.

Kolom date wajib diisi. Semua kolom lainnya bersifat opsional.

Nilai kolom date bersifat inklusif dan harus dalam format YYYY-MM-DD. Tanggal paling awal yang dapat diterima adalah 09-03-2021; nilai tanggal sebelumnya akan dikonversi ke 09-03-2021.

Nilai untuk partnerHotelDisplayName dicocokkan secara tidak peka huruf besar/kecil.

Contoh kondisi yang valid adalah sebagai berikut:

  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • partnerHotelDisplayName = 'hotel A'
  • partnerHotelDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

Menentukan cara menyegmentasikan metrik yang ditampilkan oleh kueri. Misalnya, jika userRegionCode ditentukan, freeBookingLinksResult akan menyediakan metrik yang digabungkan menurut wilayah pengguna.

Nilai string adalah daftar kolom yang dipisahkan koma. Kolom yang valid adalah: date, userRegionCode, deviceType, partnerHotelId, dan partnerHotelDisplayName. Hanya kolom yang ditentukan di sini yang disertakan dalam FreeBookingLinksResult.
pageSize

integer

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

string

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:

TIDAK DIGUNAKAN LAGI: Sebagai gantinya, gunakan QueryPropertyPerformanceReportResponse dengan PropertyPerformanceReportService. Pesan respons untuk FreeBookingLinksReportService.QueryFreeBookingLinksReport.

Representasi JSON 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
Kolom
results[]

object (FreeBookingLinksResult)

Daftar hasil yang cocok dengan kueri.
nextPageToken

string

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.

HasilLink FreeBooking

TIDAK DIGUNAKAN LAGI: Sebagai gantinya, gunakan PropertyPerformanceResult dengan PropertyPerformanceReportService. Merepresentasikan hasil dari proses kueri statistik link pemesanan gratis untuk akun.

Representasi JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
Kolom
date

object (Date)

Tanggal dalam rentang tanggal yang diminta.

Hanya ada jika date ditentukan dalam aggregateBy dalam permintaan.
userRegionCode

string

Kode wilayah ISO 3116 negara/wilayah pengguna.

Hanya ada jika userRegionCode ditentukan dalam aggregateBy dalam permintaan
deviceType

enum (Device)

Jenis perangkat pengguna.

Hanya ada jika deviceType ditentukan dalam aggregateBy dalam permintaan.
partnerHotelId

string

ID hotel partner.

Hanya ada jika partnerHotelId ditentukan dalam aggregateBy dalam permintaan.
partnerHotelDisplayName

string

Nama hotel partner.

Hanya ada jika partnerHotelDisplayName ditentukan dalam aggregateBy dalam permintaan.
clickCount

string (int64 format)

Total jumlah klik yang direkam untuk hasil ini.