Method: accounts.participationReportViews.query

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

पैरामीटर
filter

string

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

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

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

  • advanceBookingWindow = 2
  • advanceBookingWindow >= 0
  • advanceBookingWindow <= 5
  • advanceBookingWindow between 1 and 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
  • lengthOfStayDays between 1 and 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

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

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

बड़ी संख्या में पंक्तियां बनाने वाले aggregateBy स्पेसिफ़िकेशन का इस्तेमाल करने पर गड़बड़ी हो सकती है. partnerHotelId या दो से ज़्यादा फ़ील्ड के हिसाब से इकट्ठा करने पर, ऐसा होता है. किसी गड़बड़ी की संभावना को कम करने के लिए, partnerHotelId और date तक फ़िल्टर करें. इससे, आपको सिर्फ़ चुनिंदा होटल और तारीखें शामिल करनी होंगी. बड़ी संख्या में होटल वाले खातों को और ज़्यादा फ़िल्टर के ज़रिए डेटा को और कम करना होगा.
pageSize

integer

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

string

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

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

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

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

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

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

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

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

object (ParticipationResult)

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

string

नतीजों का अगला पेज वापस पाने के लिए, पेज पर नंबर डालने का टोकन इस्तेमाल किया गया.

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

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

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

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

हिस्सा लेने का नतीजा

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

जेएसओएन के काेड में दिखाना 
{
  "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 मौकों में से Google Ads नीलामी में 90 गुना हिस्सा ले सकती है, तो हिस्सा लेने की दर 90% है.
missedParticipationCount

string (int64 format)

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

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

object (MissedParticipationCountDetails)

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

string

पार्टनर के होटल का डिसप्ले नेम. यह फ़ील्ड सिर्फ़ तब पॉप्युलेट होता है, जब नतीजा partnerHotelId से एग्रीगेट होता है.

की

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

जेएसओएन के काेड में दिखाना 
{
  "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

उपयोगकर्ता के देश/इलाके का ISO 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 फ़ील्ड नहीं दिखेगा.

उन लोगों की संख्या जो नहीं मिल सके

इवेंट में हिस्सा न लेने की वजह, कई वजहों से अलग-अलग हो सकती है.

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

string (int64 format)

इनमें से किसी भी वजह से लाइव कीमत की सुविधा से जुड़ी तकनीकी समस्याओं की वजह से, हिस्सा नहीं लेने की कुल संख्या:

  • आपने तेज़ी से जवाब नहीं दिया और जवाब देने की समयसीमा को पार किया (4000 मिलीसेकंड के आस-पास).
  • आपने एक गड़बड़ी दिखाई.
  • आपका जवाब गलत तरीके से डाला गया था.
livePricingNotTriggeredCount

string (int64 format)

नीचे दी गई किसी भी वजह से, लाइव कीमत की सुविधा चालू न होने की वजह से हिस्सा नहीं लेने की कुल संख्या:

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

string (int64 format)

नीचे दी गई किसी भी वजह से, लाइव कीमत की सुविधा चालू न होने की वजह से हिस्सा नहीं लेने की कुल संख्या:

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

string (int64 format)

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

string (int64 format)

लाइव कीमत वाली दूसरी समस्याओं की वजह से, हिस्सा नहीं लेने वाले लोगों की संख्या.

कीमत मौजूद नहीं है

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

जेएसओएन के काेड में दिखाना 
{
  "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)

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

Priceप्रॉब्लम का ब्यौरा

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

जेएसओएन के काेड में दिखाना 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string
}
फ़ील्ड
hotelSuspendedCount

string (int64 format)

होटल को निलंबित कर दिया गया है. ऐसा गलत टैक्स और शुल्क जैसे क्षेत्रों में लगातार आने वाली समस्याओं की वजह से हो सकता है.
priceUnusuallyHighCount

string (int64 format)

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

string (int64 format)

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

string (int64 format)

कीमत में टैक्स और शुल्क मौजूद नहीं थे.

कीमत की जानकारी उपलब्ध नहीं है

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

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

string (int64 format)

होटल ने इस सर्वे में हिस्सा नहीं लिया, क्योंकि इसमें यात्रा की योजना से जुड़ी तारीखें उपलब्ध नहीं थीं.
participationNotLikelyCount

string (int64 format)

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