Method: accounts.freeBookingLinksReportViews.query

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

पैरामीटर
filter

string

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

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

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

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 से ज़्यादा वैल्यू को 10,000 पर सेट किया जाएगा.
pageToken

string

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

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

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

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

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

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

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

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

object (FreeBookingLinksResult)

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

string

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

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

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

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

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

FreeBookingLinksResult

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

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

object (Date)

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

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

string

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

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

enum (Device)

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

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

string

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

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

string

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

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

string (int64 format)

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