- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- Property नतीजों में दिखना
- ऐडवांसबुकिंगविंडो
- लॉन्गऑफ़
- व्यस्तता की दर
किसी खास खाते के लिए, प्रॉपर्टी की परफ़ॉर्मेंस के लिंक वाली रिपोर्ट पाने, क्वेरी करने, और फ़िल्टर करने की सुविधा मिलती है.
एचटीटीपी अनुरोध
GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/propertyPerformanceReportViews:query
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल होता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
name |
क्वेरी किए जा रहे खाते का संसाधन नाम. फ़ॉर्मैट: खाते/{account_id} |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
filter |
इस्तेमाल किए जा रहे खाते के लिए, प्रॉपर्टी की परफ़ॉर्मेंस मेट्रिक को फ़िल्टर करने में इस्तेमाल होने वाली शर्तें (फ़ील्ड और एक्सप्रेशन). सिंटैक्स के लिए
मान्य शर्तों के उदाहरण नीचे दिए गए हैं:
|
aggregateBy |
इससे यह पता चलता है कि क्वेरी से मिलने वाली मेट्रिक को कैसे सेगमेंट करना है. उदाहरण के लिए, अगर स्ट्रिंग की वैल्यू, कॉमा लगाकर अलग की गई फ़ील्ड की सूची होती है. मान्य फ़ील्ड हैं: |
pageSize |
मीटिंग में हिस्सा लेने वाले ज़्यादा से ज़्यादा लोगों की संख्या. सेवा इस मान से कम वैल्यू दे सकती है. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10,000 नतीजे दिखाए जाएंगे. ज़्यादा से ज़्यादा वैल्यू 10,000 हो सकती है; 10,000 से ज़्यादा वैल्यू को 10,000 पर सेट किया जाएगा. |
pageToken |
पिछले प्रति सेक्शन के ज़रिए रिपोर्ट पेज से मिला पेज टोकन. बाद वाला पेज पाने के लिए इसे उपलब्ध कराएं. पेजों को क्रम में लगाने पर, आपने भाग लेने वाले ViewViews.query के लिए जो भी अन्य पैरामीटर दिए हैं वे उस कॉल से मेल खाने चाहिए जो पेज टोकन देता है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
PropertyPerformanceReportService.QueryPropertyPerformanceReport
के लिए जवाब का मैसेज.
जेएसओएन के काेड में दिखाना |
---|
{
"results": [
{
object ( |
फ़ील्ड | |
---|---|
results[] |
क्वेरी से मेल खाने वाले नतीजों की सूची. |
nextPageToken |
नतीजों का अगला पेज वापस पाने के लिए, पेज पर नंबर डालने का टोकन इस्तेमाल किया गया. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होगा. |
अनुमति पाने के लिंक
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/travelpartner
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
प्रॉपर्टी की परफ़ॉर्मेंस का नतीजा
यह किसी खाते की प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट की क्वेरी करने से मिले नतीजे को दिखाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "date": { object ( |
फ़ील्ड | |
---|---|
date |
अनुरोध की गई तारीख की सीमा में तारीख. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
advanceBookingWindow |
प्रॉपर्टी के स्थानीय समय क्षेत्र में क्वेरी की तारीख और चेक-इन करने की तारीख के बीच के अंतर. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
brand |
प्रॉपर्टी के लिए, पार्टनर का तय किया गया ब्रैंड. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
deviceType |
उपयोगकर्ता का डिवाइस किस तरह का है. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
highIntentUsers |
उपयोगकर्ता की क्वेरी से बुकिंग में काफ़ी रुचि मिली या नहीं. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
lengthOfStay |
उपयोगकर्ता की ओर से तय की गई चेक-इन और चेक-आउट की तारीखों के बीच की रातों की संख्या. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
propertyRegionCode |
प्रॉपर्टी के देश/इलाके का ISO 3116 क्षेत्र कोड. सिर्फ़ तब मौजूद होता है, जब अनुरोध में |
occupancy |
प्रॉपर्टी में ठहरे लोगों की अनुरोध की गई संख्या. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
partnerPropertyId |
पार्टनर का प्रॉपर्टी आईडी. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
partnerPropertyDisplayName |
पार्टनर की प्रॉपर्टी का नाम. यह सिर्फ़ तब दिखता है, जब अनुरोध में |
userRegionCode |
उपयोगकर्ता के देश/इलाके का ISO 3116 क्षेत्र कोड. सिर्फ़ तब मौजूद होता है, जब अनुरोध में |
clickCount |
इस नतीजे के लिए रिकॉर्ड किए गए क्लिक की कुल संख्या. |
impressionCount |
इस नतीजे के लिए रिकॉर्ड किए गए इंप्रेशन की कुल संख्या. उपयोगकर्ता की निजता को सुरक्षित रखने के लिए, इस वैल्यू को पूरी तरह से राउंड किया जाता है. |
clickthroughRate |
|
ऐडवांसबुकिंग विंडो
ऐडवांस बुकिंग विंडो (एबीडब्ल्यू) के साथ काम करता है. तारीख की सभी तुलनाएं, प्रॉपर्टी के समय क्षेत्र के हिसाब से हैं.
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 |
चार से ज़्यादा लोग. |