Method: accounts.participationReportViews.query

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

पैरामीटर
filter

string

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

अहम जानकारी: एक से ज़्यादा शर्तें जोड़ने का सही सिंटैक्स यह है: "?filter=<condition>=<value>%20AND%20<condition>=<value>..."

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

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

  • advanceBookingWindow = 2
  • advanceBookingWindow >= 0
  • advanceBookingWindow <= 5
  • checkinDate = '2020-10-01'
  • checkinDate >= '2020-10-01'
  • checkinDate <= '2020-10-01'
  • checkinDate between '2020-10-01' and '2020-10-05'
  • date = '2020-02-04'
  • date between '2020-02-04' and '2020-02-09'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • hotelRegionCode = 'US'
  • hotelRegionCode in ('US', 'CA')
  • lengthOfStayDays = 2
  • lengthOfStayDays >= 0
  • lengthOfStayDays <= 5
  • occupancy = 2
  • occupancy >= 0
  • occupancy <= 5
  • occupancy between 1 and 5
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

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

स्ट्रिंग वैल्यू, कॉमा लगाकर अलग किए गए फ़ील्ड की सूची होती है. मान्य फ़ील्ड ये हैं: date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate, और occupancy. जिन फ़ील्ड के बारे में नहीं बताया गया है उन्हें ParticipationResult में शामिल नहीं किया जाता.

अहम जानकारी: partnerHotelId या इससे ज़्यादा वैल्यू के साथ aggregateBy पैरामीटर का इस्तेमाल करने पर गड़बड़ी हो सकती है. partnerHotelId और date का इस्तेमाल करके, लाइनों की संख्या को कम करने के लिए फ़िल्टर करने से गड़बड़ियों को रोका जा सकता है.
pageSize

integer

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

string

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

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

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

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

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

ParticipationReportService.QueryParticipationReport के लिए जवाब का मैसेज.

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

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

object (ParticipationResult)

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

string

इस पेज पर दिए गए पेज नंबर के हिसाब से नतीजे दिखाने के लिए इस्तेमाल किया गया टोकन.

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

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

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

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

ParticipationResult

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

JSON के काेड में दिखाना 
{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}
फ़ील्ड
key

object (Key)

नतीजे की कुंजी.
opportunityCount

string (int64 format)

किसी होटल के लिए, उपलब्ध अवसरों की कुल संख्या. अवसरों से पता चलता है कि किसी उपयोगकर्ता को होटल का विज्ञापन कितनी बार दिखाया जा सकता था.
participationCount

string (int64 format)

उन अवसरों की कुल संख्या जब Google Ads की नीलामी में शामिल होने की ज़रूरी शर्तें पूरी की गई थीं.
participationPercent

number

हिस्सा लेने वालों की दर एक प्रतिशत है. इसका हिसाब लगाने के लिए, हिस्सा लेने वाले मौकों की कुल संख्या को कुल अवसरों की संख्या से भाग दिया जाता है. उदाहरण के लिए, अगर किसी प्रॉपर्टी को 100 में से 90 बार Google Ads की नीलामी में शामिल होने की मंज़ूरी मिली है, तो नीलामी में शामिल होने की दर 90% है.
missedParticipationCount

string (int64 format)

उन अवसरों की कुल संख्या जो Google Ads की नीलामी प्रक्रिया के लिए ज़रूरी शर्तें पूरी नहीं करते. इसमें ये शामिल हैं:

  • लैंडिंग पेज मौजूद नहीं है
  • कीमत मौजूद नहीं है
  • कीमत से जुड़ी समस्या
  • कीमत उपलब्ध नहीं है
  • अन्य
missedParticipationCountDetails

object (MissedParticipationCountDetails)

उन वजहों की जानकारी जिनकी वजह से, हिस्सा लेने वालों की संख्या में कमी आई (उदाहरण के लिए, उपलब्धता न होना). साथ ही, हर वजह के लिए कुल संख्या.
partnerHotelDisplayName

string

पार्टनर के होटल का डिसप्ले नेम. इस फ़ील्ड में जानकारी सिर्फ़ तब अपने-आप भरती है, जब नतीजे को partnerHotelId के हिसाब से एग्रीगेट किया जाता है.

कुंजी

किसी नतीजे की कुंजी.

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

object (Date)

वह तारीख जिसके लिए मेट्रिक का अनुरोध किया जा रहा है.

अगर अनुरोध कॉल में date, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में date फ़ील्ड नहीं दिखाया जाता.
userRegionCode

string

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

अगर अनुरोध कॉल में userRegionCode, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में userRegionCode फ़ील्ड नहीं दिखाया जाता.
deviceType

enum (Device)

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

अगर अनुरोध कॉल में deviceType, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में deviceType फ़ील्ड नहीं दिखाया जाता.
partnerHotelId

string

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

अगर अनुरोध कॉल में partnerHotelId, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में partnerHotelId फ़ील्ड नहीं दिखाया जाता.
hotelRegionCode

string

होटल के देश/इलाके का CLDR रीजन कोड.

अगर अनुरोध कॉल में hotelRegionCode, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में hotelRegionCode फ़ील्ड नहीं दिखाया जाता.
advanceBookingWindow

integer

उपयोगकर्ता को यात्रा की योजना कितने दिन पहले बुक करनी है.

अगर अनुरोध कॉल में advanceBookingWindow, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में advanceBookingWindow फ़ील्ड नहीं दिखाया जाता.
lengthOfStayDays

integer

यात्रा की अवधि (रातों की संख्या).

अगर अनुरोध कॉल में lengthOfStayDays, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में lengthOfStayDays फ़ील्ड नहीं दिखाया जाता.
checkinDate

object (Date)

यात्रा की योजना के लिए चेक-इन करने की तारीख.

अगर अनुरोध कॉल में checkinDate, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में checkinDate फ़ील्ड नहीं दिखाया जाता.
occupancy

integer

यात्रा कार्यक्रम में यात्रियों की कुल संख्या.

अगर अनुरोध कॉल में occupancy, aggregateBy पैरामीटर की वैल्यू नहीं है, तो Key में occupancy फ़ील्ड नहीं दिखाया जाता.

MissedParticipationCountDetails

हिस्सा न लेने की वजह के हिसाब से, हिस्सा न लेने वाले लोगों की संख्या.

JSON के काेड में दिखाना 
{
  "noAvailabilityCount": string,
  "hotelSuspendedCount": string,
  "noTaxBreakdownCount": string,
  "noLandingPageCount": string,
  "noPriceCount": string,
  "noPriceCountDetails": {
    object (NoPriceCountDetails)
  },
  "otherReasonCount": string,
  "priceMissingCount": string,
  "priceMissingCountDetails": {
    object (PriceMissingCountDetails)
  },
  "priceProblemCount": string,
  "priceProblemCountDetails": {
    object (PriceProblemCountDetails)
  },
  "priceUnavailableCount": string,
  "priceUnavailableCountDetails": {
    object (PriceUnavailableCountDetails)
  }
}
फ़ील्ड
noAvailabilityCount
(deprecated)

string (int64 format)

होटल/यात्रा की योजना का कॉम्बिनेशन उपलब्ध न होने या यात्री के किराये के लिए ज़रूरी शर्तें पूरी न करने की वजह से, बुकिंग नहीं की जा सकी. इन नीलामियों में हिस्सा लेने के लिए, आपको कीमत की ज़्यादा जानकारी देनी पड़ सकती है.
hotelSuspendedCount
(deprecated)

string (int64 format)

कीमत सटीक न होने की वजह से, आपके एक या उससे ज़्यादा होटलों को निलंबित कर दिया गया है. इस वजह से, नीलामी में शामिल होने के कितने मौके छूट गए.
noTaxBreakdownCount
(deprecated)

string (int64 format)

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

string (int64 format)

कोई भी लैंडिंग पेज, उपयोगकर्ता से मेल नहीं खाता.
noPriceCount
(deprecated)

string (int64 format)

यात्रा की योजना के लिए कीमत न देने की वजह से, विज्ञापन में हिस्सा न लेने की कुल संख्या.
noPriceCountDetails
(deprecated)

object (NoPriceCountDetails)

उन वजहों की जानकारी जिनकी वजह से किराये की जानकारी नहीं मिली. उदाहरण के लिए, मौजूदा किराया उपलब्ध नहीं है. साथ ही, हर वजह के लिए कुल संख्या की जानकारी.
otherReasonCount

string (int64 format)

किसी वजह से होटल ने हिस्सा नहीं लिया.
priceMissingCount

string (int64 format)

Google की कैश मेमोरी में किराया मौजूद न होने या लाइव प्राइसिंग की सुविधा के लिए सही जवाब न दे पाने की वजह से, बुकिंग के मौके न मिलने की कुल संख्या. इसमें ये शामिल हैं:

  • बैंडविड्थ खत्म हो गया है
  • कैश मेमोरी में सेव किए गए पेजों की दर मौजूद नहीं है
  • यात्रा की योजना ब्लॉक की गई
  • लाइव किराया सेट अप नहीं किया गया है
  • मौजूदा कीमत के लिए टाइम आउट
  • मौजूदा कीमत की गड़बड़ी
priceMissingCountDetails

object (PriceMissingCountDetails)

कीमत मौजूद न होने की वजहें.
priceProblemCount

string (int64 format)

यात्रा की योजना के लिए दी गई कीमत के सटीक न होने की वजह से, विज्ञापन दिखाने के अवसरों की कुल संख्या. इसमें ये शामिल हैं:

  • होटल निलंबित किया गया
  • कीमत सामान्य से ज़्यादा है
  • कीमत सामान्य से कम है
  • टैक्स और फ़ीड की जानकारी मौजूद नहीं है
priceProblemCountDetails

object (PriceProblemCountDetails)

कीमत से जुड़ी समस्या की संख्या की वजहें.
priceUnavailableCount

string (int64 format)

अनुरोध की गई यात्रा की योजना के लिए, किराये की जानकारी उपलब्ध न होने (-1) की वजह से, विज्ञापन दिखाने के अवसरों की कुल संख्या. इसमें ये शामिल हैं:

  • कीमत उपलब्ध नहीं है
  • शामिल होने की संभावना नहीं है
  • अन्य
priceUnavailableCountDetails

object (PriceUnavailableCountDetails)

उन वजहों की जानकारी जिनसे कीमत उपलब्ध न होने की संख्या बढ़ी है.

NoPriceCountDetails

कीमत न होने की वजहें और हर वजह के लिए कुल संख्या.

JSON के काेड में दिखाना 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
फ़ील्ड
livePricingTechnicalIssueCount

string (int64 format)

इनमें से किसी भी वजह से, मौजूदा किराये की जानकारी देने वाली सुविधा में तकनीकी समस्याएं आने की वजह से, बुकिंग नहीं की जा सकी:

  • आपने तय समय में जवाब नहीं दिया और जवाब देने की समयसीमा (लगभग 4,000 मिलीसेकंड) खत्म हो गई है.
  • आपने गड़बड़ी का मैसेज दिखाया है.
  • आपका जवाब सही फ़ॉर्मैट में नहीं था.
livePricingNotTriggeredCount

string (int64 format)

लाइव प्राइसिंग ट्रिगर न होने की वजह से, बुकिंग में शामिल न हो पाने की कुल संख्या. ऐसा इन वजहों से हो सकता है:

  • आपने बिड सेट नहीं की है.
  • आपके पास मान्य लैंडिंग पेज नहीं था.
  • कैश मेमोरी में, ज़रूरत के मुताबिक कीमतें मौजूद नहीं थीं.
livePricingConfigIssueCount

string (int64 format)

लाइव प्राइसिंग ट्रिगर न होने की वजह से, बुकिंग में शामिल न हो पाने की कुल संख्या. ऐसा इन वजहों से हो सकता है:

  • आपने इन खोजों के लिए, लाइव फ़ेयर की सुविधा कॉन्फ़िगर नहीं की थी.
  • आपने Google को होटल में ठहरने से जुड़ी जानकारी ऐक्सेस करने से रोका है.
livePricingNotAvailableCount

string (int64 format)

लाइव प्राइसिंग की सुविधा उपलब्ध न होने की वजह से, बुकिंग में शामिल न हो पाने की कुल संख्या. कुछ डिफ़ॉल्ट यात्रा की योजनाओं या यूज़र इंटरफ़ेस के लिए, मौजूदा किराया नहीं दिखेगा. इस स्थिति में, पार्टनर को इस सुविधा का इस्तेमाल करने के लिए, किराये की कैश मेमोरी की ज़रूरत होगी.
livePricingOtherReasonCount

string (int64 format)

लाइव प्राइसिंग से जुड़ी अन्य समस्याओं की वजह से, बुकिंग न होने की संख्या.

PriceMissingCountDetails

कीमत मौजूद न होने की वजहों की संख्या और हर वजह के लिए कुल संख्या.

JSON के काेड में दिखाना 
{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}
फ़ील्ड
cacheRateMissingCount

string (int64 format)

इस यात्रा की योजना के लिए, कैश मेमोरी में कोई किराया मौजूद नहीं है. पेज की सीमाओं की वजह से लाइव क्वेरी नहीं की गई.
itineraryBlockedCount

string (int64 format)

यात्रा की योजना, बुनियादी पैरामीटर के हिसाब से नहीं थी. इसलिए, लाइव क्वेरी या कैश मेमोरी से यात्रा की योजना के लिए कोई किराया नहीं मिला.
livePricingNotSetupCount

string (int64 format)

इस यात्रा की योजना के लिए, किराये की जानकारी कैश मेमोरी में सेव नहीं की गई थी. साथ ही, इस खाते के लिए लाइव क्वेरी की सुविधा कॉन्फ़िगर नहीं की गई थी.
bandwidthDepletedCount

string (int64 format)

इस यात्रा की योजना के लिए, किराये की कोई जानकारी कैश मेमोरी में सेव नहीं की गई थी. साथ ही, लाइव क्वेरी का कोई कोटा नहीं बचा था.
livePricingTimeoutCount

string (int64 format)

इस यात्रा की योजना के लिए, किराये की कोई जानकारी कैश मेमोरी में सेव नहीं की गई थी. साथ ही, आपके सिस्टम को भेजी गई लाइव क्वेरी का समय खत्म हो गया है.
livePricingErrorCount

string (int64 format)

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

PriceProblemCountDetails

कीमत से जुड़ी समस्या की संख्या और हर समस्या की कुल संख्या.

JSON के काेड में दिखाना 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string,
  "basePriceViolationsCount": string,
  "priceAccuracyIssueCount": string
}
फ़ील्ड
hotelSuspendedCount

string (int64 format)

होटल को निलंबित कर दिया गया था. ऐसा इसलिए हो सकता है, क्योंकि कुछ समय से समस्याएं बनी हुई हैं. जैसे, टैक्स और शुल्क की गलत जानकारी.
priceUnusuallyHighCount

string (int64 format)

इस यात्रा की योजना के लिए दी गई कीमत, क्षेत्र के रुझानों की तुलना में बहुत ज़्यादा लग रही थी.
priceUnusuallyLowCount

string (int64 format)

इस यात्रा कार्यक्रम के लिए दी गई कीमत, इलाके के रुझानों के हिसाब से काफ़ी कम थी.
taxesAndFeesMissingCount

string (int64 format)

किराये में टैक्स और शुल्क शामिल नहीं थे.
basePriceViolationsCount

string (int64 format)

कुल कीमत की तुलना में आधार कीमत बहुत कम है.
priceAccuracyIssueCount

string (int64 format)

किराये की सटीक जानकारी न देने की समस्या.

PriceUnavailableCountDetails

कीमत उपलब्ध न होने की वजहों की संख्या और हर वजह के लिए कुल संख्या.

JSON के काेड में दिखाना 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
फ़ील्ड
priceUnavailableCount

string (int64 format)

होटल ने हिस्सा नहीं लिया, क्योंकि वह यात्रा की तारीखों के लिए उपलब्ध नहीं था.
participationNotLikelyCount

string (int64 format)

इस यात्रा की योजना के लिए, किराये की जानकारी कैश मेमोरी में सेव नहीं की गई थी. साथ ही, लाइव क्वेरी भी नहीं की गई थी, क्योंकि आपका सर्वर हमें बताता है कि होटल उपलब्ध नहीं है या उसके सभी कमरे बुक हो चुके हैं.