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 অপারেটর ব্যবহার করে শর্তাবলী যোগ করা যেতে পারে।

গুরুত্বপূর্ণ: একাধিক শর্ত যোগ করার জন্য সঠিক বাক্য গঠন হল: "?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

কোয়েরি দ্বারা ফেরত আসা মেট্রিক্সগুলিকে কীভাবে ভাগ করতে হবে তা নির্দিষ্ট করে। উদাহরণস্বরূপ, যদি userRegionCode aggregateBy মান হিসাবে নির্দিষ্ট করা হয়, তাহলে participationResult ব্যবহারকারী অঞ্চল অনুসারে একত্রিত মেট্রিক্স প্রদান করবে।

স্ট্রিং মান হল কমা দ্বারা পৃথক করা ক্ষেত্রগুলির একটি তালিকা। বৈধ ক্ষেত্রগুলি হল: date , userRegionCode , deviceType , partnerHotelId , hotelRegionCode , advanceBookingWindow , lengthOfStayDays , checkinDate , এবং occupancy । নির্দিষ্ট না করা ক্ষেত্রগুলি ParticipationResult-এ অন্তর্ভুক্ত নয়।

গুরুত্বপূর্ণ : partnerHotelId অথবা দুটির বেশি মানের সাথে aggregateBy প্যারামিটার ব্যবহার করলে ত্রুটি হতে পারে। partnerHotelId এবং date দিয়ে ফিল্টার করে সারির সংখ্যা কমানো গেলে ত্রুটির ঘটনা রোধ করা যেতে পারে।

pageSize

integer

অংশগ্রহণের ফলাফলের সর্বাধিক সংখ্যা। পরিষেবাটি এই মানের চেয়ে কম ফলাফল দিতে পারে। যদি নির্দিষ্ট না করা থাকে, তাহলে সর্বাধিক ১০,০০০ ফলাফল প্রদান করা হবে। সর্বোচ্চ মান ১০,০০০; ১০,০০০ এর উপরে মান ১০,০০০-এ জোরপূর্বক বৃদ্ধি করা হবে।

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 .

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

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

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

সফলভাবে অংশগ্রহণকারী সুযোগের সংখ্যার অংশগ্রহণের শতাংশের হারকে মোট সুযোগের সংখ্যা দিয়ে ভাগ করা হয়। উদাহরণস্বরূপ, যদি কোনও সম্পত্তি ১০০টি সুযোগের মধ্যে ৯০ বার Google বিজ্ঞাপন নিলামে প্রবেশের যোগ্য হয়, তাহলে অংশগ্রহণের হার ৯০%।

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 প্যারামিটারের মান না হয়, তাহলে 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 প্যারামিটারের মান না হয়, তাহলে hotelRegionCode ক্ষেত্রটি Key তে ফেরত পাঠানো হবে না।

advanceBookingWindow

integer

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

যদি অনুরোধ কলে advanceBookingWindow aggregateBy প্যারামিটারের মান না হয়, তাহলে Key তে advanceBookingWindow ক্ষেত্রটি ফেরত পাঠানো হবে না।

lengthOfStayDays

integer

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

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

checkinDate

object ( Date )

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

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

occupancy

integer

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

যদি অনুরোধ কলে aggregateBy প্যারামিটারের মান occupancy না হয়, তাহলে 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)

অনুরোধকৃত ভ্রমণপথের জন্য মূল্য অনুপলব্ধ (-১) হিসাবে তালিকাভুক্ত হওয়ার কারণে অংশগ্রহণ থেকে বাদ পড়া মোট সদস্যের সংখ্যা। নিম্নলিখিতগুলি অন্তর্ভুক্ত:

  • দাম অনুপলব্ধ
  • অংশগ্রহণের সম্ভাবনা কম।
  • অন্যান্য
priceUnavailableCountDetails

object ( PriceUnavailableCountDetails )

দামের এই বৃদ্ধির কারণগুলি অনুপলব্ধ।

NoPriceCountবিস্তারিত

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

JSON উপস্থাপনা 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
ক্ষেত্র
livePricingTechnicalIssueCount

string ( int64 format)

নিম্নলিখিত যেকোনো কারণে লাইভ মূল্য নির্ধারণের কারিগরি সমস্যার কারণে অংশগ্রহণ বাদ পড়া মোট সংখ্যা:

  • আপনি যথেষ্ট দ্রুত সাড়া দেননি এবং সাড়া দেওয়ার সময়সীমা (প্রায় ৪০০০ মিলিসেকেন্ড) অতিক্রম করেছেন।
  • আপনি একটি ত্রুটি ফিরিয়ে দিয়েছেন।
  • আপনার উত্তরটি ত্রুটিপূর্ণ ছিল।
livePricingNotTriggeredCount

string ( int64 format)

নিম্নলিখিত কোনও কারণে লাইভ মূল্য নির্ধারণ শুরু না হওয়ার কারণে অংশগ্রহণ মিস করা মোট সংখ্যা:

  • তুমি কোনও বিড সেট করোনি।
  • আপনার কোনও বৈধ ল্যান্ডিং পৃষ্ঠা ছিল না।
  • ক্যাশে পর্যাপ্ত দাম ছিল না।
livePricingConfigIssueCount

string ( int64 format)

নিম্নলিখিত কোনও কারণে লাইভ মূল্য নির্ধারণ শুরু না হওয়ার কারণে অংশগ্রহণ মিস করা মোট সংখ্যা:

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

string ( int64 format)

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

livePricingOtherReasonCount

string ( int64 format)

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

মূল্যঅনুপস্থিতগণনাবিস্তারিত

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

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,
  "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)

দামের নির্ভুলতার সমস্যা।

মূল্যঅনুপলব্ধগণনাবিস্তারিত

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

JSON উপস্থাপনা 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
ক্ষেত্র
priceUnavailableCount

string ( int64 format)

ভ্রমণপথের তারিখের জন্য হোটেলটি উপলব্ধ না থাকায় তারা অংশগ্রহণ করেনি।

participationNotLikelyCount

string ( int64 format)

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