Method: accounts.propertyPerformanceReportViews.query

Belirli bir hesap için mülk performans bağlantıları raporunu sorgulama (alma, filtreleme ve segmentlere ayırma) olanağı sağlar.

HTTP isteği

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

URL, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Sorgulanan hesabın kaynak adı. Biçim: hesaplar/{hesap_kimliği}

Sorgu parametreleri

Parametreler
filter

string

Sorgulanan hesabın mülk performansı metriklerini filtrelemek için kullanılan koşullar (alanlar ve ifadeler). Söz dizimi için in operatörünün etrafında boşluklar eklenmesi gerekir. Aksi takdirde, boşluklar atlanabilir. Koşullar and operatörü kullanılarak birleştirilebilir.

date alanı zorunludur. Diğer tüm alanlar isteğe bağlıdır.

date alan değerleri kapsayıcıdır ve YYYY-AA-GG biçiminde olmalıdır. Kabul edilebilir en erken tarih 09.03.2021'dir. Daha önceki tarih değerleri 09.03.2021'e zorlanır.

partnerPropertyDisplayName ve brand değerleri, büyük/küçük harfe duyarlı değildir.

Geçerli koşul örnekleri şunlardır:

  • advanceBookingWindow = 'ADVANCE_BOOKING_WINDOW_SAME_DAY'
  • advanceBookingWindow in ('ADVANCE_BOOKING_WINDOW_SAME_DAY', 'ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90')
  • brand = 'Brand A'
  • brand in ('Brand A', 'brand B')
  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • highIntentUsers = 'TRUE'
  • highIntentUsers = 'FALSE'
  • lengthOfStay = 'LENGTH_OF_STAY_NIGHTS_2'
  • lengthOfStay in ('LENGTH_OF_STAY_NIGHTS_2', 'LENGTH_OF_STAY_NIGHTS_4_TO_7')
  • propertyRegionCode = 'US'
  • propertyRegionCode in ('US', 'CA')
  • occupancy = 'OCCUPANCY_2'
  • occupancy in ('OCCUPANCY_2', 'OCCUPANCY_OVER_4')
  • partnerPropertyId = 'AAA'
  • partnerPropertyId in ('AAA', 'BBB')
  • partnerPropertyDisplayName = 'hotel A'
  • partnerPropertyDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

Sorgu tarafından döndürülen metriklerin nasıl segmentlere ayrılacağını belirtir. Örneğin userRegionCode öğesi belirtilirse PropertyPerformanceResult, kullanıcı bölgesine göre toplu metrikleri sağlar.

Dize değeri, alanların virgülle ayrılmış bir listesidir. Geçerli alanlar şunlardır: advanceBookingWindow, brand, date, deviceType, highIntentUsers, lengthOfStay, propertyRegionCode, occupancy, partnerPropertyId, partnerPropertyDisplayName ve userRegionCode. Yalnızca burada belirtilen alanlar PropertyPerformanceResult'a dahil edilir.
pageSize

integer

Döndürülecek maksimum katılım sonucu sayısı. Hizmet bu değerden daha az değer döndürebilir. Belirtilmemesi halinde en fazla 10.000 sonuç döndürülür. Maksimum değer 10.000'dir; 10.000'in üzerindeki değerler 10.000'e zorlanır.
pageToken

string

Önceki birKatılımReportViews.query isteğinden alınan sayfa jetonu. Sonraki sayfayı almak için bunu girin.

Sayfalara ayırma sırasında, reportReports.query'ya sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek metni

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

PropertyPerformanceReportService.QueryPropertyPerformanceReport için yanıt mesajı.

JSON gösterimi 
{
  "results": [
    {
      object (PropertyPerformanceResult)
    }
  ],
  "nextPageToken": string
}
Alanlar
results[]

object (PropertyPerformanceResult)

Sorguyla eşleşen sonuçların listesi.
nextPageToken

string

Sonraki sonuç sayfasını almak için kullanılan sayfalara ayırma jetonu. Bu alan çıkarılırsa sonraki sayfalar görünmez.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış konusuna bakın.

ÖzellikPerformansSonuçı

Bir hesap için mülk performans raporunun sorgulanmasından elde edilen sonucu temsil eder.

JSON gösterimi 
{
  "date": {
    object (Date)
  },
  "advanceBookingWindow": enum (AdvanceBookingWindow),
  "brand": string,
  "deviceType": enum (Device),
  "highIntentUsers": boolean,
  "lengthOfStay": enum (LengthOfStay),
  "propertyRegionCode": string,
  "occupancy": enum (Occupancy),
  "partnerPropertyId": string,
  "partnerPropertyDisplayName": string,
  "userRegionCode": string,
  "clickCount": string,
  "impressionCount": string,
  "clickthroughRate": number
}
Alanlar
date

object (Date)

İstenen tarih aralığındaki bir tarih.

Yalnızca istekte aggregateBy içinde date belirtilmişse mevcuttur.
advanceBookingWindow

enum (AdvanceBookingWindow)

Tesisin yerel saat diliminde sorgu tarihi ile giriş tarihi arasındaki gün farkı.

Yalnızca istekte aggregateBy içinde advanceBookingWindow belirtilmişse mevcuttur.
brand

string

Tesis için iş ortağı tarafından belirtilen marka.

Yalnızca istekte aggregateBy içinde brand belirtilmişse mevcuttur.
deviceType

enum (Device)

Kullanıcının cihaz türü.

Yalnızca istekte aggregateBy içinde deviceType belirtilmişse mevcuttur.
highIntentUsers

boolean

Kullanıcının sorgusunun rezervasyona büyük ilgi gösterip göstermediği.

Yalnızca istekte aggregateBy içinde highIntentUsers belirtilmişse mevcuttur.
lengthOfStay

enum (LengthOfStay)

Kullanıcı tarafından belirtilen giriş ve çıkış tarihleri arasındaki gece sayısı.

Yalnızca istekte aggregateBy içinde lengthOfStay belirtilmişse mevcuttur.
propertyRegionCode

string

Tesisin ülke/bölgesinin ISO 3116 bölge kodu.

Yalnızca istekte aggregateBy öğesinde propertyRegionCode belirtilirse gösterilir
occupancy

enum (Occupancy)

Tesiste konaklayacak istenen kişi sayısı.

Yalnızca istekte aggregateBy içinde partnerPropertyId belirtilmişse mevcuttur.
partnerPropertyId

string

İş ortağının mülk kimliği.

Yalnızca istekte aggregateBy içinde partnerPropertyId belirtilmişse mevcuttur.
partnerPropertyDisplayName

string

İş ortağının mülk adı.

Yalnızca istekte aggregateBy içinde partnerPropertyDisplayName belirtilmişse mevcuttur.
userRegionCode

string

Kullanıcının ülkesinin/bölgesinin ISO 3116 bölge kodu.

Yalnızca istekte aggregateBy öğesinde userRegionCode belirtilirse gösterilir
clickCount

string (int64 format)

Bu sonuç için kaydedilen toplam tıklama sayısı.
impressionCount

string (int64 format)

Bu sonuç için kaydedilen gösterimlerin toplam sayısı. Bu değer, kullanıcı gizliliğini korumak için yuvarlanır.
clickthroughRate

number

clickCount değerinin impressionCount değerine bölünmesiyle elde edilir.

Erken RezervasyonZaman Aralığı

Desteklenen erken rezervasyon aralıklarını (ABW) sıralar. Tüm tarih karşılaştırmaları, mülkün saat dilimindedir.

Sıralamalar
ADVANCE_BOOKING_WINDOW_UNSPECIFIED Belirtilmedi.
ADVANCE_BOOKING_WINDOW_SAME_DAY Giriş tarihi, sorgu tarihiyle aynıydı.
ADVANCE_BOOKING_WINDOW_NEXT_DAY Giriş tarihi, sorgu tarihinden bir gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 Giriş tarihi, sorgu tarihinden 2-7 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 Giriş tarihi, sorgu tarihinden 8-14 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 Giriş tarihi, sorgu tarihinden 15-30 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 Giriş tarihi, sorgu tarihinden 31-60 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 Giriş tarihi, sorgu tarihinden 61-90 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 Giriş tarihi, sorgu tarihinden 91-120 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 Giriş tarihi, sorgu tarihinden 121-150 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 Giriş tarihi, sorgu tarihinden 151-180 gün sonraydı.
ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 Giriş tarihi, sorgu tarihinden 180 gün sonraydı.

Konaklama Süresi

Desteklenen konaklama süresini (LOS) gösterir.

Sıralamalar
LENGTH_OF_STAY_UNSPECIFIED Belirtilmedi.
LENGTH_OF_STAY_NIGHTS_1 Tek gecelik konaklama.
LENGTH_OF_STAY_NIGHTS_2 2 gece konaklama.
LENGTH_OF_STAY_NIGHTS_3 3 gece konaklama.
LENGTH_OF_STAY_NIGHTS_4_TO_7 4-7 gece konaklama.
LENGTH_OF_STAY_NIGHTS_8_TO_14 8-14 gece konaklama.
LENGTH_OF_STAY_NIGHTS_15_TO_21 15-21 gece konaklama.
LENGTH_OF_STAY_NIGHTS_22_TO_30 22-30 gece konaklama.
LENGTH_OF_STAY_NIGHTS_OVER_30 30 geceden fazla konaklama.

Doluluk

Desteklenen toplam oda doluluk oranını gösterir.

Sıralamalar
OCCUPANCY_UNSPECIFIED Belirtilmedi.
OCCUPANCY_1 Tek kişi.
OCCUPANCY_2 İki kişi.
OCCUPANCY_3 Üç kişi.
OCCUPANCY_4 Dört kişi.
OCCUPANCY_OVER_4 4 kişiden fazla.