Method: accounts.freeBookingLinksReportViews.query

TIDAK DIGUNAKAN LAGI: Sebagai gantinya, gunakan PropertyPerformanceReportService.QueryPropertyPerformanceReport, yang juga memiliki pelaporan tayangan iklan. 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 ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

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

Parameter kueri

Parameter
filter

string

Kondisi (kolom dan ekspresi) yang digunakan untuk memfilter metrik link pemesanan gratis untuk akun yang sedang 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 yang lebih awal akan dikonversi menjadi 09-03-2021.

Nilai untuk partnerHotelDisplayName dicocokkan tanpa 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 memberikan metrik yang dikelompokkan 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, paling banyak 10.000 hasil akan ditampilkan. Nilai maksimum adalah 10.000; nilai di atas 10.000 akan dikonversi menjadi 10.000.
pageToken

string

Token halaman, yang diterima dari permintaan participationReportViews.query sebelumnya. Berikan ini untuk menerima halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan ke participationReportViews.query harus sesuai dengan panggilan yang memberikan token halaman.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

TIDAK DIGUNAKAN LAGI: Gunakan QueryPropertyPerformanceReportResponse dengan PropertyPerformanceReportService sebagai gantinya. Pesan respons untuk FreeBookingLinksReportService.QueryFreeBookingLinksReport.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (FreeBookingLinksResult)

Daftar hasil yang cocok dengan kueri.
nextPageToken

string

Token penomoran halaman yang digunakan untuk mengambil halaman hasil berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/travelpartner

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

FreeBookingLinksResult

TIDAK DIGUNAKAN LAGI: Gunakan PropertyPerformanceResult dengan PropertyPerformanceReportService sebagai gantinya. Mewakili hasil dari kueri untuk statistik link pemesanan gratis untuk suatu 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)

Jumlah total klik yang dicatat untuk hasil ini.