Method: accounts.propertyPerformanceReportViews.query

Belirli bir hesap için ücretsiz rezervasyon bağlantıları raporunu sorgulama (alma, filtreleme ve segmentlere ayırma) olanağı sağlar. Bu yeni sürüm, gösterim ve tıklamaların yanı sıra çok daha büyük bir filtre/toplama üst kümesi döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Sorgulanan hesabın kaynak adı. Biçim: accounts/{account_id}

Sorgu parametreleri

Parametreler
filter

string

Sorgulanan hesap için mülk performans metriklerini filtrelemek üzere kullanılan koşullar (alanlar ve ifadeler). Söz diziminde in operatörünün etrafında boşluk olması gerekir. Aksi takdirde boşluklar atlanabilir. Koşullar AND operatörü kullanılarak birleştirilebilir.

Önemli: Birden fazla koşul eklemek için doğru söz dizimi: "?filter=<condition>=<value>%20AND%20<condition>=<value>..."

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

date alan değerleri dahilidir ve YYYY-AA-GG biçiminde olmalıdır. Kabul edilebilir en erken tarih 2021-03-09'dur. Daha önceki tarih değerleri 2021-03-09 olarak zorlanır.

partnerPropertyDisplayName ve brand değerleri büyük/küçük harfe duyarlı olmadan eşleştirilir.

Geçerli koşullara örnek olarak aşağıdakiler verilebilir:

  • 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 bölümlendirileceğini belirtir. Örneğin, userRegionCode belirtilirse PropertyPerformanceResult, kullanıcı bölgesine göre toplanan metrikleri sağlar.

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

Önemli: aggregateBy parametresini partnerHotelId veya ikiden fazla değerle kullanmak hataya neden olabilir. Satır sayısını azaltmak için partnerHotelId ve date ile filtreleme yapmak hataların oluşmasını önleyebilir.
pageSize

integer

Döndürülecek maksimum katılım sonucu sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse 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 bir participationReportViews.query isteğinden alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken participationReportViews.query'ye 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 metni

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

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

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

object (PropertyPerformanceResult)

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

string

Sonuçların sonraki sayfasını almak için kullanılan sayfalama jetonu. Bu alan atlanırsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

PropertyPerformanceResult

Bir hesabın mülk performans raporu için yapılan sorgulamanın sonucunu gösterir.

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,
  "adsClickCount": string,
  "adsImpressionCount": string,
  "adsClickthroughRate": number,
  "vrWebsiteButtonClicks": string
}
Alanlar
date

object (Date)

İstenen tarih aralığında bir tarih.

Yalnızca istekteki aggregateBy içinde date belirtilmişse bulunur.
advanceBookingWindow

enum (AdvanceBookingWindow)

Tesisin yerel saat dilimindeki sorgu tarihi ile check-in tarihi arasındaki gün farkı.

Yalnızca istekteki aggregateBy içinde advanceBookingWindow belirtilmişse bulunur.
brand

string

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

Yalnızca istekteki aggregateBy içinde brand belirtilmişse bulunur.
deviceType

enum (Device)

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

Yalnızca istekteki aggregateBy içinde deviceType belirtilmişse bulunur.
highIntentUsers

boolean

Kullanıcının sorgusunun, rezervasyona ilgisinin yüksek olduğunu gösterip göstermediği.

Yalnızca istekteki aggregateBy içinde highIntentUsers belirtilmişse bulunur.
lengthOfStay

enum (LengthOfStay)

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

Yalnızca istekteki aggregateBy içinde lengthOfStay belirtilmişse bulunur.
propertyRegionCode

string

Tesisin bulunduğu ülkenin/bölgenin ISO 3116 bölge kodu.

Yalnızca istekte aggregateBy içinde propertyRegionCode belirtilmişse bulunur.
occupancy

enum (Occupancy)

Tesiste konaklaması istenen kişi sayısı.

Yalnızca istekteki aggregateBy içinde partnerPropertyId belirtilmişse bulunur.
partnerPropertyId

string

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

Yalnızca istekteki aggregateBy içinde partnerPropertyId belirtilmişse bulunur.
partnerPropertyDisplayName

string

İş ortağının tesis adı.

Yalnızca istekteki aggregateBy içinde partnerPropertyDisplayName belirtilmişse bulunur.
userRegionCode

string

Kullanıcının bulunduğu ülkenin/bölgenin ISO 3116 bölge kodu.

Yalnızca istekte aggregateBy içinde userRegionCode belirtilmişse bulunur.
clickCount

string (int64 format)

Bu sonuç için kaydedilen toplam ücretsiz rezervasyon bağlantısı tıklama sayısı.
impressionCount

string (int64 format)

Bu sonuç için kaydedilen toplam ücretsiz rezervasyon bağlantısı gösterim sayısı. Bu değer, kullanıcı gizliliğini korumak için yuvarlanır.
clickthroughRate

number

clickCount bölü impressionCount değerine eşittir.
adsClickCount

string (int64 format)

Bu sonuç için kaydedilen toplam reklam tıklaması sayısı.
adsImpressionCount

string (int64 format)

Bu sonuç için kaydedilen toplam reklam gösterimi sayısı.
adsClickthroughRate

number

adsClickCount bölü adsImpressionCount değerine eşittir.
vrWebsiteButtonClicks

string (int64 format)

Kiralık yerler için Google'daki "Web sitesi" düğmesinin toplam tıklama sayısı.

AdvanceBookingWindow

Desteklenen erken rezervasyon dönemlerini (ERD) listeler. Tüm tarih karşılaştırmaları mülkün saat dilimine göre yapılır.

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 sonraki gündü.
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 Giriş tarihi, sorgu tarihinden 2-7 gün sonra olmalıdır.
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 Giriş tarihi, sorgu tarihinden 8-14 gün sonra olmalıdır.
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 Giriş tarihi, sorgu tarihinden 15-30 gün sonra olmalıdır.
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 Giriş tarihi, sorgu tarihinden 31-60 gün sonra olmalıdır.
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 Giriş tarihi, sorgu tarihinden 61-90 gün sonra olmalıdır.
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 Giriş tarihi, sorgu tarihinden 91-120 gün sonra olmalıdır.
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 Giriş tarihi, sorgu tarihinden 121-150 gün sonra.
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 Giriş tarihi, sorgu tarihinden 151-180 gün sonra.
ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 Giriş tarihi, sorgu tarihinden 180 günden fazla bir süre sonra.

LengthOfStay

Desteklenen konaklama sürelerini (KS) listeler.

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 uzun konaklamalar

Doluluk

Desteklenen toplam oda doluluğunu numaralandırır.

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