Method: accounts.participationReportViews.query

Memberikan kemampuan untuk membuat kueri (mendapatkan, memfilter, dan menyegmentasikan) laporan partisipasi untuk akun tertentu.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Nama resource akun yang sedang dikueri. Formatnya adalah accounts/{account_id}.

Parameter kueri

Parameter
filter

string

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

Penting: Sintaksis yang benar untuk menambahkan beberapa kondisi adalah: "?filter=<condition>=<value>%20AND%20<condition>=<value>..."

Kolom date wajib diisi. Semua kolom lainnya bersifat opsional.

Contoh kondisi yang valid adalah sebagai berikut:

  • advanceBookingWindow = 2
  • advanceBookingWindow >= 0
  • advanceBookingWindow <= 5
  • checkinDate = '2020-10-01'
  • checkinDate >= '2020-10-01'
  • checkinDate <= '2020-10-01'
  • checkinDate between '2020-10-01' and '2020-10-05'
  • date = '2020-02-04'
  • date between '2020-02-04' and '2020-02-09'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • hotelRegionCode = 'US'
  • hotelRegionCode in ('US', 'CA')
  • lengthOfStayDays = 2
  • lengthOfStayDays >= 0
  • lengthOfStayDays <= 5
  • occupancy = 2
  • occupancy >= 0
  • occupancy <= 5
  • occupancy between 1 and 5
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

Menentukan cara menyegmentasikan metrik yang ditampilkan oleh kueri. Misalnya, jika userRegionCode ditentukan sebagai nilai aggregateBy, participationResult akan memberikan metrik yang digabungkan menurut wilayah pengguna.

Nilai string adalah daftar kolom yang dipisahkan koma. Kolom yang valid adalah: date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate, dan occupancy. Kolom yang tidak ditentukan tidak disertakan dalam ParticipationResult.

Penting: Penggunaan parameter aggregateBy dengan partnerHotelId atau lebih dari dua nilai dapat menyebabkan error. Memfilter dengan partnerHotelId dan date untuk mengurangi jumlah baris dapat mencegah terjadinya error.
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

Pesan respons untuk ParticipationReportService.QueryParticipationReport.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (ParticipationResult)

Daftar hasil yang cocok dengan kueri.
nextPageToken

string

Token penomoran halaman yang digunakan untuk mengambil halaman hasil berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ParticipationResult

Menampilkan hasil dari kueri untuk statistik partisipasi akun.

Representasi JSON 
{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}
Kolom
key

object (Key)

Kunci hasil.
opportunityCount

string (int64 format)

Jumlah total peluang yang tersedia untuk hotel tertentu. Peluang adalah total berapa kali Iklan Hotel dapat ditampilkan kepada pengguna.
participationCount

string (int64 format)

Jumlah total peluang saat Anda memenuhi syarat untuk berpartisipasi dalam proses lelang Google Ads.
participationPercent

number

Tingkat persentase partisipasi yang menampilkan jumlah peluang dengan partisipasi yang berhasil dibagi jumlah total peluang. Misalnya, jika suatu properti memenuhi syarat untuk berpartisipasi dalam lelang Google Ads sebanyak 90 kali dari 100 peluang, tingkat partisipasinya adalah 90%.
missedParticipationCount

string (int64 format)

Jumlah total peluang yang tidak memenuhi syarat untuk proses lelang Google Ads. Terdiri dari hal-hal berikut:

  • Halaman landing tidak ada
  • Harga tidak ada
  • Masalah harga
  • Harga tidak tersedia
  • Lainnya
missedParticipationCountDetails

object (MissedParticipationCountDetails)

Alasan yang menyebabkan jumlah partisipasi yang terlewat (misalnya, tidak ada ketersediaan) dan jumlah total untuk setiap alasan.
partnerHotelDisplayName

string

Nama tampilan hotel partner. Kolom ini hanya diisi jika hasilnya diagregasi menurut partnerHotelId.

Kunci

Kunci hasil.

Representasi JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}
Kolom
date

object (Date)

Tanggal saat Anda meminta metrik.

Jika date bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom date tidak akan ditampilkan dalam Key.
userRegionCode

string

Kode wilayah ISO 3116 negara/wilayah pengguna.

Jika userRegionCode bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom userRegionCode tidak akan ditampilkan dalam Key.
deviceType

enum (Device)

Jenis perangkat pengguna.

Jika deviceType bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom deviceType tidak akan ditampilkan dalam Key.
partnerHotelId

string

ID hotel partner.

Jika partnerHotelId bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom partnerHotelId tidak akan ditampilkan dalam Key.
hotelRegionCode

string

Kode wilayah CLDR negara/wilayah hotel.

Jika hotelRegionCode bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom hotelRegionCode tidak akan ditampilkan dalam Key.
advanceBookingWindow

integer

Jumlah hari sebelum pengguna ingin memesan itinerari.

Jika advanceBookingWindow bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom advanceBookingWindow tidak akan ditampilkan dalam Key.
lengthOfStayDays

integer

Jumlah malam untuk itinerari.

Jika lengthOfStayDays bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom lengthOfStayDays tidak akan ditampilkan dalam Key.
checkinDate

object (Date)

Tanggal check-in itinerari.

Jika checkinDate bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom checkinDate tidak akan ditampilkan dalam Key.
occupancy

integer

Total hunian itinerari.

Jika occupancy bukan nilai parameter aggregateBy dalam panggilan permintaan, kolom occupancy tidak akan ditampilkan dalam Key.

MissedParticipationCountDetails

Jumlah partisipasi yang terlewat dikelompokkan menurut alasan.

Representasi JSON 
{
  "noAvailabilityCount": string,
  "hotelSuspendedCount": string,
  "noTaxBreakdownCount": string,
  "noLandingPageCount": string,
  "noPriceCount": string,
  "noPriceCountDetails": {
    object (NoPriceCountDetails)
  },
  "otherReasonCount": string,
  "priceMissingCount": string,
  "priceMissingCountDetails": {
    object (PriceMissingCountDetails)
  },
  "priceProblemCount": string,
  "priceProblemCountDetails": {
    object (PriceProblemCountDetails)
  },
  "priceUnavailableCount": string,
  "priceUnavailableCountDetails": {
    object (PriceUnavailableCountDetails)
  }
}
Kolom
noAvailabilityCount
(deprecated)

string (int64 format)

Jumlah total partisipasi yang terlewat karena kombinasi hotel/itinerari tidak tersedia, atau wisatawan tidak memenuhi syarat untuk mendapatkan tarif tersebut. Untuk berpartisipasi dalam lelang ini, Anda mungkin perlu memberikan informasi harga lainnya.
hotelSuspendedCount
(deprecated)

string (int64 format)

Jumlah total partisipasi yang terlewat karena satu atau beberapa hotel Anda ditangguhkan karena pelanggaran akurasi harga.
noTaxBreakdownCount
(deprecated)

string (int64 format)

Jumlah total partisipasi yang terlewat karena satu atau beberapa hotel Anda tidak menentukan pajak dan biaya secara terpisah.
noLandingPageCount

string (int64 format)

Tidak ada halaman landing yang cocok dengan pengguna.
noPriceCount
(deprecated)

string (int64 format)

Jumlah total partisipasi yang terlewat karena harga tidak ditawarkan untuk itinerari yang diminta.
noPriceCountDetails
(deprecated)

object (NoPriceCountDetails)

Alasan yang menyebabkan jumlah tanpa harga (misalnya, harga real time tidak tersedia) dan jumlah total untuk setiap alasan.
otherReasonCount

string (int64 format)

Hotel tidak berpartisipasi karena alasan yang tidak diketahui.
priceMissingCount

string (int64 format)

Jumlah total partisipasi yang terlewat karena harga tidak ada di cache Google atau harga real time gagal direspons. Terdiri dari hal-hal berikut:

  • Bandwidth habis
  • Tarif di cache tidak ada
  • Itinerari diblokir
  • Harga real time belum disiapkan
  • Waktu tunggu harga real time
  • Error harga real time
priceMissingCountDetails

object (PriceMissingCountDetails)

Alasan yang menyebabkan jumlah harga tidak ada.
priceProblemCount

string (int64 format)

Jumlah total partisipasi yang terlewat karena masalah dengan akurasi harga yang diberikan untuk itinerari. Terdiri dari hal-hal berikut:

  • Hotel ditangguhkan
  • Harga sangat tinggi
  • Harga sangat rendah
  • Pajak dan biaya tidak ada
priceProblemCountDetails

object (PriceProblemCountDetails)

Alasan yang berkontribusi pada jumlah masalah harga.
priceUnavailableCount

string (int64 format)

Jumlah total partisipasi yang terlewat karena harga tercantum sebagai tidak tersedia (-1) untuk itinerari yang diminta. Terdiri dari hal-hal berikut:

  • Harga tidak tersedia
  • Partisipasi tidak memungkinkan
  • Lainnya
priceUnavailableCountDetails

object (PriceUnavailableCountDetails)

Alasan yang berkontribusi pada jumlah harga tidak tersedia.

NoPriceCountDetails

Alasan yang menyebabkan tidak ada jumlah harga dan jumlah total untuk setiap alasan.

Representasi JSON 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
Kolom
livePricingTechnicalIssueCount

string (int64 format)

Jumlah total partisipasi yang terlewat karena masalah teknis pada harga real time dengan salah satu alasan berikut:

  • Respons yang Anda berikan tidak cukup cepat dan melebihi batas waktu respons (sekitar 4.000 milidetik).
  • Anda membuat error.
  • Respons Anda salah format.
livePricingNotTriggeredCount

string (int64 format)

Jumlah total partisipasi yang terlewat karena harga real time tidak dipicu oleh salah satu alasan berikut:

  • Anda tidak menetapkan bid.
  • Anda tidak memiliki halaman landing yang valid.
  • Cache tidak memiliki cukup harga.
livePricingConfigIssueCount

string (int64 format)

Jumlah total partisipasi yang terlewat karena harga real time tidak dipicu oleh salah satu alasan berikut:

  • Anda tidak mengonfigurasi harga real time untuk penelusuran ini.
  • Anda membatasi akses Google ke itinerari hotel yang bersangkutan.
livePricingNotAvailableCount

string (int64 format)

Jumlah total partisipasi yang terlewat karena harga real time tidak tersedia. Harga real time tidak akan dipicu untuk itinerari atau UI default tertentu. Dalam skenario ini, partner memerlukan harga yang di-cache untuk berpartisipasi.
livePricingOtherReasonCount

string (int64 format)

Jumlah partisipasi yang terlewat karena masalah lain pada harga real time.

PriceMissingCountDetails

Alasan yang menyebabkan jumlah harga tidak ada dan jumlah total untuk setiap alasan.

Representasi JSON 
{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}
Kolom
cacheRateMissingCount

string (int64 format)

Tidak ada harga di cache untuk itinerari ini. Kueri real time tidak dilakukan karena pembatasan halaman.
itineraryBlockedCount

string (int64 format)

Itinerari berada di luar parameter dasar, sehingga tidak ada harga yang diambil untuk itinerari dari kueri real time atau data di cache.
livePricingNotSetupCount

string (int64 format)

Tidak ada harga yang di-cache untuk itinerari ini, dan kueri real time tidak dikonfigurasi untuk akun ini.
bandwidthDepletedCount

string (int64 format)

Tidak ada harga yang di-cache untuk itinerari ini, dan tidak ada sisa kuota kueri real time.
livePricingTimeoutCount

string (int64 format)

Tidak ada harga yang di-cache untuk itinerari ini, dan kueri real time yang dikirimkan ke sistem Anda telah kedaluwarsa.
livePricingErrorCount

string (int64 format)

Tidak ada harga yang di-cache untuk itinerari ini. Kueri real time tidak kedaluwarsa, tetapi sistem menampilkan error.

PriceProblemCountDetails

Alasan yang berkontribusi pada jumlah masalah harga dan jumlah total untuk setiap alasan.

Representasi JSON 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string,
  "basePriceViolationsCount": string,
  "priceAccuracyIssueCount": string
}
Kolom
hotelSuspendedCount

string (int64 format)

Hotel ditangguhkan. Hal ini mungkin disebabkan karena masalah persisten di bidang seperti pajak dan biaya yang salah.
priceUnusuallyHighCount

string (int64 format)

Harga yang diberikan untuk itinerari ini sangat tinggi dibandingkan dengan tren regional.
priceUnusuallyLowCount

string (int64 format)

Harga yang diberikan untuk itinerari ini sangat rendah dibandingkan dengan tren regional.
taxesAndFeesMissingCount

string (int64 format)

Tidak ada pajak dan biaya pada harga.
basePriceViolationsCount

string (int64 format)

Harga dasar terlalu rendah dibandingkan dengan harga total.
priceAccuracyIssueCount

string (int64 format)

Masalah akurasi harga.

PriceUnavailableCountDetails

Alasan yang menyebabkan jumlah harga tidak tersedia dan jumlah total untuk setiap alasan.

Representasi JSON 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
Kolom
priceUnavailableCount

string (int64 format)

Hotel tidak berpartisipasi karena tidak tersedia untuk tanggal itinerari.
participationNotLikelyCount

string (int64 format)

Tidak ada harga yang di-cache untuk itinerari ini, dan tidak ada kueri real time yang dijalankan karena server Anda biasanya memberitahukan bahwa hotel tidak tersedia atau penuh.