این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Method: accounts.participationReportViews.query

امکان پرس و جو (دریافت، فیلتر کردن، و بخش بندی) یک گزارش مشارکت را برای یک حساب خاص فراهم می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های

مولفه های
`name`	`string` نام منبع حساب مورد نظر. قالب `accounts/{account_id}` است.

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 معیارهایی را ارائه می‌کند `participationResult` بر اساس منطقه کاربر جمع‌آوری شده‌اند. مقدار رشته لیستی از فیلدها است که با کاما از هم جدا شده اند. فیلدهای معتبر عبارتند از: `date` ، `userRegionCode` ، `deviceType` ، `partnerHotelId` ، `hotelRegionCode` ، `advanceBookingWindow` ، `lengthOfStayDays` ، `checkinDate` ، و `occupancy` . فیلدهایی که مشخص نشده اند در ParticipationResult گنجانده نشده اند. استفاده از مشخصات `aggregateBy` که تعداد سطرهای زیادی تولید می کند باعث خطا می شود. این امر به ویژه در هنگام جمع آوری توسط `partnerHotelId` یا بیش از دو فیلد صادق است. برای کاهش احتمال خطا، براساس `partnerHotelId` و `date` فیلتر کنید تا فقط تعداد معینی از هتل ها و تاریخ ها را شامل شود. حساب‌های دارای تعداد زیادی هتل باید با فیلتر کردن بیشتر داده‌ها را کاهش دهند.
`pageSize`	`integer` حداکثر تعداد نتایج مشارکت برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. اگر نامشخص باشد، حداکثر 10000 نتیجه برگردانده می شود. حداکثر مقدار 10000 است. مقادیر بالای 10000 به 10000 اجباری می شود.
`pageToken`	`string` یک نشانه صفحه، دریافت شده از یک درخواست مشارکتReportViews.query قبلی. این را برای دریافت صفحه بعدی ارائه دهید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ParticipationReportViews.query باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پیام پاسخ برای ParticipationReportService.QueryParticipationReport .

نمایندگی JSON
{ "results": [ { object (`ParticipationResult`) } ], "nextPageToken": string }

زمینه های

زمینه های
`results[]`	`object ( ParticipationResult )` فهرست نتایجی که با پرس و جو مطابقت دارد.
`nextPageToken`	`string` نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود.

results[]

object ( ParticipationResult )

فهرست نتایجی که با پرس و جو مطابقت دارد.

nextPageToken

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

نتیجه مشارکت

نشان دهنده نتیجه پرس و جو برای آمار مشارکت برای یک حساب است.

نمایندگی JSON

نمایندگی JSON
{ "key": { object (`Key`) }, "opportunityCount": string, "participationCount": string, "participationPercent": number, "missedParticipationCount": string, "missedParticipationCountDetails": { object (`MissedParticipationCountDetails`) }, "partnerHotelDisplayName": string }

{
  "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` درصد مشارکت که در آن تعداد فرصت‌های شرکت‌کننده با موفقیت بر تعداد کل فرصت‌ها تقسیم می‌شود. به عنوان مثال، اگر ملکی 90 بار از 100 فرصت، واجد شرایط ورود به مزایده گوگل ادز بود، نرخ مشارکت 90 درصد است.
`missedParticipationCount`	`string ( int64 format)` تعداد کل فرصت‌هایی که برای فرآیند مزایده Google Ads واجد شرایط نیستند. متشکل از موارد زیر: صفحه فرود وجود ندارد قیمت گم شده است مشکل قیمت قیمت در دسترس نیست دیگر
`missedParticipationCountDetails`	`object ( MissedParticipationCountDetails )` دلایلی که در مشارکت از دست رفته نقش داشته اند (مثلاً در دسترس نبودن) و تعداد کل برای هر دلیل محاسبه می شود.
`partnerHotelDisplayName`	`string` نام نمایشی هتل شریک. این فیلد تنها زمانی پر می شود که نتیجه توسط `partnerHotelId` جمع شود.

کلید

کلید یک نتیجه

نمایندگی JSON

نمایندگی 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)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}

زمینه های
`date`	`object ( Date )` تاریخی که برای آن معیارها را درخواست می کنید. اگر `date` مقداری از پارامتر `aggregateBy` در فراخوانی درخواست نباشد، فیلد `date` در `Key` برگردانده نمی‌شود.
`userRegionCode`	`string` کد منطقه ایزو 3116 کشور/منطقه کاربر. اگر `userRegionCode` مقدار پارامتر `aggregateBy` در فراخوانی درخواست نباشد، فیلد `userRegionCode` در `Key` برگردانده نمی شود.
`deviceType`	`enum ( Device )` نوع دستگاه کاربر اگر `deviceType` مقدار پارامتر `aggregateBy` در فراخوانی درخواستی نباشد، فیلد `deviceType` در `Key` برگردانده نمی شود.
`partnerHotelId`	`string` شناسه هتل شریک اگر `partnerHotelId` مقداری از پارامتر `aggregateBy` در فراخوانی درخواست نباشد، فیلد `partnerHotelId` در `Key` برگردانده نمی شود.
`hotelRegionCode`	`string` کد منطقه CLDR کشور/منطقه هتل. اگر `hotelRegionCode` مقدار پارامتر `aggregateBy` در فراخوانی درخواست نباشد، فیلد `hotelRegionCode` در `Key` برگردانده نمی‌شود.
`advanceBookingWindow`	`integer` تعداد روزهای قبل که کاربر می خواهد برنامه سفر را رزرو کند. اگر `advanceBookingWindow` مقدار پارامتر `aggregateBy` در فراخوانی درخواست نباشد، فیلد `advanceBookingWindow` در `Key` برگردانده نمی‌شود.
`lengthOfStayDays`	`integer` تعداد شب های برنامه سفر. اگر `lengthOfStayDays` مقدار پارامتر `aggregateBy` در فراخوانی درخواست نباشد، فیلد `lengthOfStayDays` در `Key` برگردانده نمی‌شود.
`checkinDate`	`object ( Date )` تاریخ ورود به برنامه سفر. اگر `checkinDate` مقدار پارامتر `aggregateBy` در فراخوانی درخواست نیست، فیلد `checkinDate` در `Key` برگردانده نمی شود.
`occupancy`	`integer` اشغال کل برنامه سفر. اگر `occupancy` مقداری از پارامتر `aggregateBy` در فراخوانی درخواست نباشد، فیلد `occupancy` در `Key` برگردانده نمی شود.

MissedParticipationCountDetails

تعداد مشارکت از دست رفته بر اساس دلیل تفکیک شده است.

نمایندگی JSON

نمایندگی 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": 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 }

نمایندگی JSON

{
  "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)` تعداد شرکت های از دست رفته به دلیل سایر مسائل مربوط به قیمت گذاری زنده.

PriceMissingCountDetails

دلایلی که در کاهش قیمت و تعداد کل برای هر دلیل نقش داشته اند.

نمایندگی JSON
{ "cacheRateMissingCount": string, "itineraryBlockedCount": string, "livePricingNotSetupCount": string, "bandwidthDepletedCount": string, "livePricingTimeoutCount": string, "livePricingErrorCount": string }

نمایندگی 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 }

زمینه های
`hotelSuspendedCount`	`string ( int64 format)` هتل به حالت تعلیق درآمد. این ممکن است به دلیل مشکلات مداوم در زمینه هایی مانند مالیات و هزینه های نادرست باشد.
`priceUnusuallyHighCount`	`string ( int64 format)` قیمت ارائه شده برای این سفر در مقایسه با روندهای منطقه ای به طرز عجیبی بالا به نظر می رسید.
`priceUnusuallyLowCount`	`string ( int64 format)` قیمت ارائه شده برای این سفر در مقایسه با روندهای منطقه ای به طرز عجیبی پایین به نظر می رسید.
`taxesAndFeesMissingCount`	`string ( int64 format)` مالیات و کارمزد در قیمت گذاری وجود نداشت.

قیمت در دسترس نیست تعداد جزئیات

دلایلی که منجر به در دسترس نبودن قیمت و تعداد کل برای هر دلیل شده است.

نمایندگی JSON
{ "priceUnavailableCount": string, "participationNotLikelyCount": string }

زمینه های

زمینه های
`priceUnavailableCount`	`string ( int64 format)` هتل شرکت نکرد زیرا برای تاریخ های برنامه سفر در دسترس نبود.
`participationNotLikelyCount`	`string ( int64 format)` هیچ قیمتی برای این برنامه سفر ذخیره نشده است، و هیچ درخواست زنده ای انجام نشده است زیرا سرور شما معمولاً به ما می گوید که هتل در دسترس نیست یا فروخته شده است.

priceUnavailableCount

string ( int64 format)

هتل شرکت نکرد زیرا برای تاریخ های برنامه سفر در دسترس نبود.

participationNotLikelyCount

string ( int64 format)

هیچ قیمتی برای این برنامه سفر ذخیره نشده است، و هیچ درخواست زنده ای انجام نشده است زیرا سرور شما معمولاً به ما می گوید که هتل در دسترس نیست یا فروخته شده است.