Method: accounts.propertyPerformanceReportViews.query

किसी खास खाते के लिए, प्रॉपर्टी की परफ़ॉर्मेंस के लिंक वाली रिपोर्ट पाने, क्वेरी करने, और फ़िल्टर करने की सुविधा मिलती है.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल होता है.

पाथ पैरामीटर

पैरामीटर
name

string

क्वेरी किए जा रहे खाते का संसाधन नाम. फ़ॉर्मैट: खाते/{account_id}

क्वेरी पैरामीटर

पैरामीटर
filter

string

इस्तेमाल किए जा रहे खाते के लिए, प्रॉपर्टी की परफ़ॉर्मेंस मेट्रिक को फ़िल्टर करने में इस्तेमाल होने वाली शर्तें (फ़ील्ड और एक्सप्रेशन). सिंटैक्स के लिए in ऑपरेटर के आस-पास स्पेस होना ज़रूरी है. ऐसा न करने पर, स्पेस छोड़े जा सकते हैं. and ऑपरेटर का इस्तेमाल करके शर्तों को जोड़ा जा सकता है.

date फ़ील्ड में जानकारी डालना ज़रूरी है. अन्य सभी फ़ील्ड वैकल्पिक हैं.

date फ़ील्ड की वैल्यू शामिल हैं और वे YYYY-MM-DD फ़ॉर्मैट में होनी चाहिए. सबसे पहले, 09-03-2021 को मंज़ूरी दी गई है. तारीख से पहले की वैल्यू 09-03-2021 को लागू की जाएगी.

partnerPropertyDisplayName और brand के लिए वैल्यू, केस-इनसेंसिटिव तरीके से मैच की जाती हैं.

मान्य शर्तों के उदाहरण नीचे दिए गए हैं:

  • 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

इससे यह पता चलता है कि क्वेरी से मिलने वाली मेट्रिक को कैसे सेगमेंट करना है. उदाहरण के लिए, अगर userRegionCode बताया गया है, तो PropertyPerformanceResult उपयोगकर्ता के इलाके के हिसाब से एग्रीगेट की गई मेट्रिक दिखाएगा.

स्ट्रिंग की वैल्यू, कॉमा लगाकर अलग की गई फ़ील्ड की सूची होती है. मान्य फ़ील्ड हैं: advanceBookingWindow, brand, date, deviceType, highIntentUsers, lengthOfStay, propertyRegionCode, occupancy, partnerPropertyId, partnerPropertyDisplayName, और userRegionCode. यहां दिए गए फ़ील्ड, Propertyबेहतर नतीजे में शामिल हैं.
pageSize

integer

मीटिंग में हिस्सा लेने वाले ज़्यादा से ज़्यादा लोगों की संख्या. सेवा इस मान से कम वैल्यू दे सकती है. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10,000 नतीजे दिखाए जाएंगे. ज़्यादा से ज़्यादा वैल्यू 10,000 हो सकती है; 10,000 से ज़्यादा वैल्यू को 10,000 पर सेट किया जाएगा.
pageToken

string

पिछले प्रति सेक्शन के ज़रिए रिपोर्ट पेज से मिला पेज टोकन. बाद वाला पेज पाने के लिए इसे उपलब्ध कराएं.

पेजों को क्रम में लगाने पर, आपने भाग लेने वाले ViewViews.query के लिए जो भी अन्य पैरामीटर दिए हैं वे उस कॉल से मेल खाने चाहिए जो पेज टोकन देता है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

PropertyPerformanceReportService.QueryPropertyPerformanceReport के लिए जवाब का मैसेज.

जेएसओएन के काेड में दिखाना 
{
  "results": [
    {
      object (PropertyPerformanceResult)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
results[]

object (PropertyPerformanceResult)

क्वेरी से मेल खाने वाले नतीजों की सूची.
nextPageToken

string

नतीजों का अगला पेज वापस पाने के लिए, पेज पर नंबर डालने का टोकन इस्तेमाल किया गया. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होगा.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

प्रॉपर्टी की परफ़ॉर्मेंस का नतीजा

यह किसी खाते की प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट की क्वेरी करने से मिले नतीजे को दिखाता है.

जेएसओएन के काेड में दिखाना 
{
  "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
}
फ़ील्ड
date

object (Date)

अनुरोध की गई तारीख की सीमा में तारीख.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में date बताया गया हो.
advanceBookingWindow

enum (AdvanceBookingWindow)

प्रॉपर्टी के स्थानीय समय क्षेत्र में क्वेरी की तारीख और चेक-इन करने की तारीख के बीच के अंतर.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में advanceBookingWindow बताया गया हो.
brand

string

प्रॉपर्टी के लिए, पार्टनर का तय किया गया ब्रैंड.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में brand बताया गया हो.
deviceType

enum (Device)

उपयोगकर्ता का डिवाइस किस तरह का है.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में deviceType बताया गया हो.
highIntentUsers

boolean

उपयोगकर्ता की क्वेरी से बुकिंग में काफ़ी रुचि मिली या नहीं.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में highIntentUsers बताया गया हो.
lengthOfStay

enum (LengthOfStay)

उपयोगकर्ता की ओर से तय की गई चेक-इन और चेक-आउट की तारीखों के बीच की रातों की संख्या.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में lengthOfStay बताया गया हो.
propertyRegionCode

string

प्रॉपर्टी के देश/इलाके का ISO 3116 क्षेत्र कोड.

सिर्फ़ तब मौजूद होता है, जब अनुरोध में aggregateBy में propertyRegionCode के बारे में बताया गया हो
occupancy

enum (Occupancy)

प्रॉपर्टी में ठहरे लोगों की अनुरोध की गई संख्या.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में partnerPropertyId बताया गया हो.
partnerPropertyId

string

पार्टनर का प्रॉपर्टी आईडी.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में partnerPropertyId बताया गया हो.
partnerPropertyDisplayName

string

पार्टनर की प्रॉपर्टी का नाम.

यह सिर्फ़ तब दिखता है, जब अनुरोध में aggregateBy के बारे में partnerPropertyDisplayName बताया गया हो.
userRegionCode

string

उपयोगकर्ता के देश/इलाके का ISO 3116 क्षेत्र कोड.

सिर्फ़ तब मौजूद होता है, जब अनुरोध में aggregateBy में userRegionCode के बारे में बताया गया हो
clickCount

string (int64 format)

इस नतीजे के लिए रिकॉर्ड किए गए क्लिक की कुल संख्या.
impressionCount

string (int64 format)

इस नतीजे के लिए रिकॉर्ड किए गए इंप्रेशन की कुल संख्या. उपयोगकर्ता की निजता को सुरक्षित रखने के लिए, इस वैल्यू को पूरी तरह से राउंड किया जाता है.
clickthroughRate

number

clickCount के बराबर को impressionCount से भाग देने पर मिलने वाली संख्या.

ऐडवांसबुकिंग विंडो

ऐडवांस बुकिंग विंडो (एबीडब्ल्यू) के साथ काम करता है. तारीख की सभी तुलनाएं, प्रॉपर्टी के समय क्षेत्र के हिसाब से हैं.

Enums
ADVANCE_BOOKING_WINDOW_UNSPECIFIED तय नहीं है.
ADVANCE_BOOKING_WINDOW_SAME_DAY चेक इन करने की तारीख और क्वेरी की तारीख एक ही थी.
ADVANCE_BOOKING_WINDOW_NEXT_DAY चेक इन करने की तारीख, क्वेरी की तारीख के अगले दिन थी.
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 चेक इन करने की तारीख, क्वेरी की तारीख के 2-7 दिन बाद थी.
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 क्वेरी की तारीख, जांच की तारीख के 8-14 दिनों के बाद की होनी चाहिए.
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 चेक इन करने की तारीख, क्वेरी की तारीख के 15 से 30 दिनों बाद की है.
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 क्वेरी की तारीख के 31 से 60 दिन बाद, चेक इन करने की तारीख.
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 चेक इन करने की तारीख, क्वेरी की तारीख के 61 से 90 दिनों के बाद थी.
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 चेक इन करने की तारीख, क्वेरी की तारीख के 91 से 120 दिनों बाद की है.
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 क्वेरी की तारीख के 121-150 दिन बाद चेक-इन की तारीख थी.
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 क्वेरी की तारीख के 151-180 दिन बाद चेक-इन की तारीख थी.
ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 क्वेरी की तारीख के 180 दिन बाद, चेक इन करने की तारीख.

अवधि

ठहरने की कुल अवधि (एलओएस) की जानकारी देता है.

Enums
LENGTH_OF_STAY_UNSPECIFIED तय नहीं है.
LENGTH_OF_STAY_NIGHTS_1 एक रात ठहरने की सुविधा.
LENGTH_OF_STAY_NIGHTS_2 दो रात ठहरने की सुविधा.
LENGTH_OF_STAY_NIGHTS_3 तीन रातों तक ठहरने के लिए.
LENGTH_OF_STAY_NIGHTS_4_TO_7 चार से सात रातों के लिए ठहरने की सुविधा.
LENGTH_OF_STAY_NIGHTS_8_TO_14 8-14 रातों तक ठहरें.
LENGTH_OF_STAY_NIGHTS_15_TO_21 15-21 रातों के लिए ठहरें.
LENGTH_OF_STAY_NIGHTS_22_TO_30 22 से 30 रातों तक ठहरें.
LENGTH_OF_STAY_NIGHTS_OVER_30 30 से ज़्यादा रातों के लिए होटल.

बुक किया हुआ

यह कमरा बुक करने की कुल संख्या की जानकारी देता है.

Enums
OCCUPANCY_UNSPECIFIED तय नहीं है.
OCCUPANCY_1 एक व्यक्ति.
OCCUPANCY_2 दो लोग.
OCCUPANCY_3 तीन लोग.
OCCUPANCY_4 चार लोग.
OCCUPANCY_OVER_4 चार से ज़्यादा लोग.