Method: accounts.participationReportViews.query

একটি নির্দিষ্ট অ্যাকাউন্টের জন্য একটি অংশগ্রহণ প্রতিবেদন জিজ্ঞাসা (পান, ফিল্টার এবং সেগমেন্ট) করার ক্ষমতা প্রদান করে।

HTTP অনুরোধ

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

URL 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

একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী অংশগ্রহণের ReportViews.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 ওভারভিউ দেখুন।

অংশগ্রহণের ফলাফল

একটি অ্যাকাউন্টের জন্য অংশগ্রহণের পরিসংখ্যানের জন্য অনুসন্ধানের ফলাফলের প্রতিনিধিত্ব করে।

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 বিজ্ঞাপন নিলাম প্রক্রিয়ায় প্রবেশের জন্য যোগ্য মোট সুযোগের সংখ্যা।

participationPercent

number

অংশগ্রহণের শতকরা হার যেখানে সফলভাবে অংশগ্রহণ করা সুযোগের সংখ্যাকে সুযোগের মোট সংখ্যা দিয়ে ভাগ করা হয়। উদাহরণস্বরূপ, যদি একটি প্রপার্টি 100টি সুযোগের মধ্যে 90 বার Google Ads নিলামে প্রবেশের যোগ্য হয়, তাহলে অংশগ্রহণের হার 90%।

missedParticipationCount

string ( int64 format)

Google বিজ্ঞাপন নিলাম প্রক্রিয়ার জন্য যোগ্য নয় মোট সুযোগের সংখ্যা। নিম্নলিখিতগুলি নিয়ে গঠিত:

  • ল্যান্ডিং পৃষ্ঠা অনুপস্থিত
  • মূল্য অনুপস্থিত
  • দামের সমস্যা
  • মূল্য অনুপলব্ধ
  • অন্যান্য
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 প্যারামিটারের একটি মান না হয়, তবে date ক্ষেত্রটি Key তে ফেরত দেওয়া হয় না।

userRegionCode

string

ব্যবহারকারীর দেশ/অঞ্চলের ISO 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

ব্যবহারকারী যত দিন আগে ভ্রমণপথ বুক করতে চান।

যদি অ্যাডভান্সবুকিংউইন্ডো অনুরোধ কলে aggregateBy প্যারামিটারের একটি মান না হয়, তাহলে advanceBookingWindow ক্ষেত্র Key - advanceBookingWindow ফেরত দেওয়া হয় না।

lengthOfStayDays

integer

ভ্রমণপথের জন্য রাতের সংখ্যা।

যদি lengthOfStayDays অনুরোধ কলে aggregateBy প্যারামিটারের একটি মান না হয়, তাহলে lengthOfStayDays ক্ষেত্র Key -তে ফেরত দেওয়া হয় না।

checkinDate

object ( Date )

ভ্রমণপথের চেক-ইন তারিখ।

যদি checkinDate অনুরোধ কলে aggregateBy প্যারামিটারের একটি মান না হয়, তাহলে checkinDate ক্ষেত্র Key -তে ফেরত দেওয়া হয় না।

occupancy

integer

ভ্রমণপথের মোট দখল।

যদি occupancy অনুরোধ কলে aggregateBy প্যারামিটারের একটি মান না হয়, তাহলে Key -তে occupancy ক্ষেত্রটি ফেরত দেওয়া হয় না।

মিসডঅংশগ্রহণগণনা বিবরণ

মিস অংশগ্রহণ গণনা কারণ দ্বারা বিভক্ত.

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 )

মূল্য অনুপলব্ধ গণনা অবদান যে কারণ.

কোন মূল্য গণনা বিবরণ

মূল্য গণনা না হওয়া এবং প্রতিটি কারণের জন্য মোট গণনা করার কারণগুলি।

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)

লাইভ মূল্য অনুপলব্ধ হওয়ার কারণে মিস অংশগ্রহণের মোট সংখ্যা। নির্দিষ্ট ডিফল্ট ভ্রমণপথ বা UI-এর জন্য লাইভ মূল্য ট্রিগার করা হবে না। এই পরিস্থিতিতে, অংশীদারদের অংশগ্রহণের জন্য একটি ক্যাশে মূল্যের প্রয়োজন হবে।

livePricingOtherReasonCount

string ( int64 format)

লাইভ মূল্যের সাথে অন্যান্য সমস্যার কারণে মিস অংশগ্রহণের সংখ্যা।

PriceMissing Count Details

মূল্য অনুপস্থিত গণনা এবং প্রতিটি কারণের জন্য মোট গণনাতে অবদান রাখার কারণগুলি৷

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)

এই ভ্রমণপথের জন্য কোন মূল্য ক্যাশ করা হয়নি। একটি লাইভ ক্যোয়ারী সময় শেষ হয়নি, কিন্তু আপনার সিস্টেম একটি ত্রুটি ফিরিয়ে দিয়েছে৷

মূল্য সমস্যা গণনা বিবরণ

মূল্য সমস্যা গণনা এবং প্রতিটি কারণের জন্য মোট গণনা অবদান যে কারণ.

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)

এই ভ্রমণপথের জন্য কোনো মূল্য ক্যাশ করা হয়নি, এবং কোনো লাইভ প্রশ্ন করা হয়নি কারণ আপনার সার্ভার সাধারণত আমাদের বলে যে হোটেলটি অনুপলব্ধ বা বিক্রি হয়ে গেছে।