Method: accounts.propertyPerformanceReportViews.query

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

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
name

string

অ্যাকাউন্টের সম্পদের নাম জিজ্ঞাসা করা হচ্ছে। বিন্যাস: অ্যাকাউন্টস/{account_id}

ক্যোয়ারী প্যারামিটার

পরামিতি
filter

string

ক্যোয়ারী করা অ্যাকাউন্টের জন্য প্রপার্টি পারফরম্যান্স মেট্রিক্স ফিল্টার করতে ব্যবহৃত শর্ত (ক্ষেত্র এবং এক্সপ্রেশন)। সিনট্যাক্সের জন্য in অপারেটরের চারপাশে স্পেস প্রয়োজন। অন্যথায়, স্পেস বাদ দেওয়া যেতে পারে। শর্তাবলী and অপারেটর ব্যবহার করে যোগদান করা যেতে পারে.

date ক্ষেত্র প্রয়োজন. অন্যান্য সমস্ত ক্ষেত্রগুলি ঐচ্ছিক।

date ক্ষেত্রের মানগুলি অন্তর্ভুক্ত এবং অবশ্যই YYYY-MM-DD ফর্ম্যাটে হতে হবে৷ প্রথমতম গ্রহণযোগ্য তারিখ হল 2021-03-09; পূর্ববর্তী তারিখের মান 2021-03-09-এ বাধ্য করা হবে।

partnerPropertyDisplayName এবং brand মানগুলি অক্ষর-সংবেদনশীলভাবে মেলে৷

বৈধ শর্তের উদাহরণ নিম্নরূপ:

  • advanceBookingWindow = 'ADVANCE_BOOKING_WINDOW_SAME_DAY'
  • advanceBookingWindow in ('ADVANCE_BOOKING_WINDOW_SAME_DAY', 'ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90')
  • brand = 'Brand A'
  • brand in ('Brand A', 'brand B')
  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • highIntentUsers = 'TRUE'
  • highIntentUsers = 'FALSE'
  • lengthOfStay = 'LENGTH_OF_STAY_NIGHTS_2'
  • lengthOfStay in ('LENGTH_OF_STAY_NIGHTS_2', 'LENGTH_OF_STAY_NIGHTS_4_TO_7')
  • propertyRegionCode = 'US'
  • propertyRegionCode in ('US', 'CA')
  • occupancy = 'OCCUPANCY_2'
  • occupancy in ('OCCUPANCY_2', 'OCCUPANCY_OVER_4')
  • partnerPropertyId = 'AAA'
  • partnerPropertyId in ('AAA', 'BBB')
  • partnerPropertyDisplayName = 'hotel A'
  • partnerPropertyDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

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

স্ট্রিং মান হল একটি কমা দ্বারা পৃথক করা ক্ষেত্রগুলির তালিকা৷ বৈধ ক্ষেত্রগুলি হল: advanceBookingWindow , brand , date , deviceType প্রকার , lengthOfStay highIntentUsers propertyRegionCode অঞ্চল কোড , occupancy , partnerPropertyId , অংশীদার প্রপার্টি partnerPropertyDisplayName , এবং userRegionCode ৷ শুধুমাত্র এখানে নির্দিষ্ট করা ক্ষেত্রগুলিই PropertyPerformance Result-এ অন্তর্ভুক্ত।

pageSize

integer

সর্বাধিক সংখ্যক অংশগ্রহণের ফলাফল ফেরত দিতে হবে। পরিষেবাটি এই মানের থেকে কম ফেরত দিতে পারে। অনির্দিষ্ট থাকলে, সর্বাধিক 10,000টি ফলাফল ফেরত দেওয়া হবে। সর্বোচ্চ মান 10,000; 10,000-এর উপরে মানগুলি 10,000-এ বাধ্য করা হবে৷

pageToken

string

একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী অংশগ্রহণের ReportViews.query অনুরোধ থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পেতে এটি প্রদান করুন।

পেজিনেট করার সময়, participationReportViews.query-এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পেজ টোকেন প্রদানকারী কলের সাথে মিলবে।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

PropertyPerformanceReportService.QueryPropertyPerformanceReport এর জন্য প্রতিক্রিয়া বার্তা।

JSON প্রতিনিধিত্ব
{
  "results": [
    {
      object (PropertyPerformanceResult)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
results[]

object ( PropertyPerformanceResult )

ফলাফলের তালিকা যা প্রশ্নের সাথে মেলে।

nextPageToken

string

ফলাফলের পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে ব্যবহৃত পৃষ্ঠা সংখ্যা টোকেন। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে পরবর্তী পৃষ্ঠা থাকবে না।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

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

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

সম্পত্তি কর্মক্ষমতা ফলাফল

একটি অ্যাকাউন্টের জন্য সম্পত্তি কর্মক্ষমতা প্রতিবেদনের জন্য অনুসন্ধানের ফলাফলের প্রতিনিধিত্ব করে।

JSON প্রতিনিধিত্ব
{
  "date": {
    object (Date)
  },
  "advanceBookingWindow": enum (AdvanceBookingWindow),
  "brand": string,
  "deviceType": enum (Device),
  "highIntentUsers": boolean,
  "lengthOfStay": enum (LengthOfStay),
  "propertyRegionCode": string,
  "occupancy": enum (Occupancy),
  "partnerPropertyId": string,
  "partnerPropertyDisplayName": string,
  "userRegionCode": string,
  "clickCount": string,
  "impressionCount": string,
  "clickthroughRate": number
}
ক্ষেত্র
date

object ( Date )

অনুরোধ করা তারিখ সীমার মধ্যে একটি তারিখ।

অনুরোধে aggregateBy এ date উল্লেখ থাকলেই কেবল উপস্থিত।

advanceBookingWindow

enum ( AdvanceBookingWindow )

সম্পত্তির স্থানীয় সময় অঞ্চলে ক্যোয়ারী তারিখ এবং চেক-ইন তারিখের মধ্যে দিনের পার্থক্য।

aggregateBy advanceBookingWindow নির্দিষ্ট করা থাকে তবেই উপস্থিত।

brand

string

সম্পত্তির জন্য অংশীদার-নির্দিষ্ট ব্র্যান্ড।

অনুরোধে aggregateBy এ brand নির্দিষ্ট করা থাকলেই কেবল উপস্থিত।

deviceType

enum ( Device )

ব্যবহারকারীর ডিভাইসের ধরন।

অনুরোধে যদি deviceType aggregateBy এ নির্দিষ্ট করা থাকে তবেই উপস্থিত।

highIntentUsers

boolean

ব্যবহারকারীর ক্যোয়ারী বুকিংয়ে প্রবল আগ্রহের ইঙ্গিত দিয়েছে কিনা।

অনুরোধে যদি highIntentUsers aggregateBy এ নির্দিষ্ট করা থাকে তবেই উপস্থিত।

lengthOfStay

enum ( LengthOfStay )

ব্যবহারকারীর দ্বারা নির্দিষ্ট চেক-ইন এবং চেক-আউট তারিখের মধ্যে রাতের সংখ্যা।

শুধুমাত্র যদি lengthOfStay অনুরোধে aggregateBy উল্লেখ করা থাকে তাহলেই উপস্থিত।

propertyRegionCode

string

সম্পত্তির দেশ/অঞ্চলের ISO 3116 অঞ্চল কোড।

অনুরোধে aggregateBy propertyRegionCode নির্দিষ্ট করা থাকলেই কেবল উপস্থিত

occupancy

enum ( Occupancy )

সম্পত্তিতে থাকার জন্য অনুরোধ করা হয়েছে.

যদি partnerPropertyId অনুরোধে aggregateBy এ নির্দিষ্ট করা থাকে তবেই উপস্থিত।

partnerPropertyId

string

অংশীদার সম্পত্তি আইডি.

যদি partnerPropertyId অনুরোধে aggregateBy এ নির্দিষ্ট করা থাকে তবেই উপস্থিত।

partnerPropertyDisplayName

string

অংশীদারের সম্পত্তির নাম।

যদি partnerPropertyDisplayName অনুরোধে aggregateBy এ নির্দিষ্ট করা থাকে তবেই উপস্থিত।

userRegionCode

string

ব্যবহারকারীর দেশ/অঞ্চলের ISO 3116 অঞ্চল কোড।

অনুরোধে যদি userRegionCode aggregateBy এ নির্দিষ্ট করা থাকে তবেই উপস্থিত

clickCount

string ( int64 format)

এই ফলাফলের জন্য রেকর্ড করা ক্লিকের মোট সংখ্যা।

impressionCount

string ( int64 format)

এই ফলাফলের জন্য রেকর্ড করা ইম্প্রেশনের মোট সংখ্যা। ব্যবহারকারীর গোপনীয়তা রক্ষা করার জন্য এই মানটি বৃত্তাকার করা হয়েছে।

clickthroughRate

number

impressionCount কাউন্ট দিয়ে ভাগ করা clickCount সমান।

অ্যাডভান্সবুকিং উইন্ডো

সমর্থিত অগ্রিম বুকিং উইন্ডোজ (ABW) গণনা করে। সমস্ত তারিখের তুলনা সম্পত্তির টাইমজোনে রয়েছে।

এনামস
ADVANCE_BOOKING_WINDOW_UNSPECIFIED উল্লিখিত না.
ADVANCE_BOOKING_WINDOW_SAME_DAY চেক-ইন তারিখটি ক্যোয়ারী তারিখের মতোই ছিল৷
ADVANCE_BOOKING_WINDOW_NEXT_DAY চেক-ইন তারিখ ছিল ক্যোয়ারী তারিখের পরের দিন।
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 চেক-ইন তারিখ ছিল ক্যোয়ারী তারিখের 2-7 দিন পর।
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 চেক-ইন তারিখ ছিল 8-14 দিন পরে ক্যোয়ারী তারিখ.
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 চেক-ইন তারিখ ছিল ক্যোয়ারী তারিখের 15-30 দিন পর।
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 চেক-ইন তারিখ ছিল ক্যোয়ারী তারিখের 31-60 দিন পর।
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 চেক-ইন তারিখটি প্রশ্নের তারিখের 61-90 দিন পরে ছিল।
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 চেক-ইন তারিখ ছিল 91-120 দিন পরে ক্যোয়ারী তারিখ.
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 ক্যোয়ারী তারিখের 121-150 দিন পরে চেক-ইন তারিখ ছিল।
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 চেক-ইন তারিখ ছিল ক্যোয়ারী তারিখের 151-180 দিন পর।
ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 চেক-ইন তারিখটি ক্যোয়ারী তারিখের 180 দিনের বেশি ছিল।

থাকার দৈর্ঘ্য

সমর্থিত থাকার দৈর্ঘ্য (LOS) গণনা করে।

এনামস
LENGTH_OF_STAY_UNSPECIFIED উল্লিখিত না.
LENGTH_OF_STAY_NIGHTS_1 একা রাত্রিযাপন।
LENGTH_OF_STAY_NIGHTS_2 ২ রাত থাকা।
LENGTH_OF_STAY_NIGHTS_3 ৩ রাত থাকা।
LENGTH_OF_STAY_NIGHTS_4_TO_7 4-7 রাত থাকা।
LENGTH_OF_STAY_NIGHTS_8_TO_14 8-14 রাত থাকা।
LENGTH_OF_STAY_NIGHTS_15_TO_21 15-21 রাত থাকা।
LENGTH_OF_STAY_NIGHTS_22_TO_30 22-30 রাত থাকা।
LENGTH_OF_STAY_NIGHTS_OVER_30 30 রাতের বেশি থাকা।

দখল

সমর্থিত মোট রুম দখল গণনা করে।

এনামস
OCCUPANCY_UNSPECIFIED উল্লিখিত না.
OCCUPANCY_1 একক ব্যক্তি.
OCCUPANCY_2 দুইজন মানুষ.
OCCUPANCY_3 তিন জনের.
OCCUPANCY_4 চারজন লোক.
OCCUPANCY_OVER_4 4 জনের বেশি।