Method: accounts.freeBookingLinksReportViews.query

DEPRECATED: इसके बजाय, PropertyPerformanceReportService.QueryPropertyPerformanceReport का इस्तेमाल करें. इसमें इंप्रेशन रिपोर्टिंग की सुविधा भी उपलब्ध है. इसकी मदद से, किसी खाते के लिए बिना शुल्क वाले बुकिंग लिंक की रिपोर्ट को क्वेरी किया जा सकता है. जैसे, रिपोर्ट को पाना, फ़िल्टर करना, और सेगमेंट में बांटना.

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

पैरामीटर
filter

string

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

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

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

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

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

  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • partnerHotelDisplayName = 'hotel A'
  • partnerHotelDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

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

स्ट्रिंग वैल्यू, कॉमा लगाकर अलग किए गए फ़ील्ड की सूची होती है. मान्य फ़ील्ड ये हैं: date, userRegionCode, deviceType, partnerHotelId, और partnerHotelDisplayName. यहां दिए गए फ़ील्ड ही, FreeBookingLinksResult में शामिल किए जाते हैं.
pageSize

integer

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

string

यह पेज टोकन, participationReportViews.query के पिछले अनुरोध से मिला है. अगला पेज पाने के लिए, यह जानकारी दें.

पेज नंबर के हिसाब से डेटा दिखाने के दौरान, participationReportViews.query को दिए गए अन्य सभी पैरामीटर, उस कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया था.

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

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

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

DEPRECATED: इसके बजाय, PropertyPerformanceReportService के साथ QueryPropertyPerformanceReportResponse का इस्तेमाल करें. FreeBookingLinksReportService.QueryFreeBookingLinksReport के लिए जवाब का मैसेज.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
results[]

object (FreeBookingLinksResult)

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

string

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

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

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

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

FreeBookingLinksResult

DEPRECATED: इसके बजाय, PropertyPerformanceReportService के साथ PropertyPerformanceResult का इस्तेमाल करें. यह किसी खाते के लिए, बिना किसी शुल्क के दिखाए जाने वाले बुकिंग लिंक के आंकड़ों के बारे में क्वेरी करने पर मिले नतीजे को दिखाता है.

JSON के काेड में दिखाना 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
फ़ील्ड
date

object (Date)

तारीख की उस सीमा के अंदर की कोई तारीख जिसके लिए अनुरोध किया गया है.

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

string

उपयोगकर्ता के देश/इलाके का आईएसओ 3116 क्षेत्र कोड.

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

enum (Device)

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

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

string

पार्टनर के होटल का आईडी.

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

string

पार्टनर के होटल का नाम.

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

string (int64 format)

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