- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt gövdesi
- Yetkilendirme Kapsamları
- PropertyPerformanceResult
- Gelişmiş Rezervasyon Aralığı
- Konaklama Süresi
- Doluluk durumu
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 |
Sorgulanan hesabın kaynak adı. Biçim: hesaplar/{hesap_kimliği} |
Sorgu parametreleri
Parametreler | |
---|---|
filter |
Sorgulanan hesabın mülk performansı metriklerini filtrelemek için kullanılan koşullar (alanlar ve ifadeler). Söz dizimi için
Geçerli koşul örnekleri şunlardır:
|
aggregateBy |
Sorgu tarafından döndürülen metriklerin nasıl segmentlere ayrılacağını belirtir. Örneğin Dize değeri, alanların virgülle ayrılmış bir listesidir. Geçerli alanlar şunlardır: |
pageSize |
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 |
Ö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 ( |
Alanlar | |
---|---|
results[] |
Sorguyla eşleşen sonuçların listesi. |
nextPageToken |
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 ( |
Alanlar | |
---|---|
date |
İstenen tarih aralığındaki bir tarih. Yalnızca istekte |
advanceBookingWindow |
Tesisin yerel saat diliminde sorgu tarihi ile giriş tarihi arasındaki gün farkı. Yalnızca istekte |
brand |
Tesis için iş ortağı tarafından belirtilen marka. Yalnızca istekte |
deviceType |
Kullanıcının cihaz türü. Yalnızca istekte |
highIntentUsers |
Kullanıcının sorgusunun rezervasyona büyük ilgi gösterip göstermediği. Yalnızca istekte |
lengthOfStay |
Kullanıcı tarafından belirtilen giriş ve çıkış tarihleri arasındaki gece sayısı. Yalnızca istekte |
propertyRegionCode |
Tesisin ülke/bölgesinin ISO 3116 bölge kodu. Yalnızca istekte |
occupancy |
Tesiste konaklayacak istenen kişi sayısı. Yalnızca istekte |
partnerPropertyId |
İş ortağının mülk kimliği. Yalnızca istekte |
partnerPropertyDisplayName |
İş ortağının mülk adı. Yalnızca istekte |
userRegionCode |
Kullanıcının ülkesinin/bölgesinin ISO 3116 bölge kodu. Yalnızca istekte |
clickCount |
Bu sonuç için kaydedilen toplam tıklama sayısı. |
impressionCount |
Bu sonuç için kaydedilen gösterimlerin toplam sayısı. Bu değer, kullanıcı gizliliğini korumak için yuvarlanır. |
clickthroughRate |
|
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. |