Method: accounts.propertyPerformanceReportViews.query

একটি নির্দিষ্ট অ্যাকাউন্টের জন্য বিনামূল্যে বুকিং লিঙ্ক রিপোর্ট অনুসন্ধান (পাওয়া, ফিল্টার করা এবং ভাগ করা) করার ক্ষমতা প্রদান করে। এই নতুন সংস্করণটি ইম্প্রেশন এবং ক্লিকগুলি ফেরত দেয়, পাশাপাশি ফিল্টার/সমষ্টির একটি অনেক বড় সুপারসেটও প্রদান করে।

HTTP অনুরোধ

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

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

পথের পরামিতি

পরামিতি
name

string

যে অ্যাকাউন্টটি জিজ্ঞাসা করা হচ্ছে তার রিসোর্সের নাম। ফর্ম্যাট: accounts/{account_id}

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

পরামিতি
filter

string

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

গুরুত্বপূর্ণ: একাধিক শর্ত যোগ করার জন্য সঠিক বাক্য গঠন হল: "?filter=<condition>=<value>%20AND%20<condition>=<value>..."

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 , highIntentUsers , lengthOfStay , propertyRegionCode , occupancy , partnerPropertyId , partnerPropertyDisplayName , এবং userRegionCode । এখানে উল্লেখিত ক্ষেত্রগুলি শুধুমাত্র PropertyPerformanceResult-এ অন্তর্ভুক্ত।

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

pageSize

integer

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

pageToken

string

পূর্ববর্তী participationReportViews.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 Overview .

সম্পত্তির পারফরম্যান্স ফলাফল

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

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,
  "adsClickCount": string,
  "adsImpressionCount": string,
  "adsClickthroughRate": number,
  "vrWebsiteButtonClicks": string
}
ক্ষেত্র
date

object ( Date )

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

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

advanceBookingWindow

enum ( AdvanceBookingWindow )

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

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

brand

string

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

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

deviceType

enum ( Device )

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

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

highIntentUsers

boolean

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

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

lengthOfStay

enum ( LengthOfStay )

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

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

propertyRegionCode

string

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

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

occupancy

enum ( Occupancy )

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

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

partnerPropertyId

string

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

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

partnerPropertyDisplayName

string

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

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

userRegionCode

string

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

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

clickCount

string ( int64 format)

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

impressionCount

string ( int64 format)

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

clickthroughRate

number

impressionCount দিয়ে ভাগ করলে clickCount এর সমান।

adsClickCount

string ( int64 format)

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

adsImpressionCount

string ( int64 format)

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

adsClickthroughRate

number

adsClickCount কে adsImpressionCount দিয়ে ভাগ করলে সমান।

vrWebsiteButtonClicks

string ( int64 format)

Google-এ ছুটি কাটানোর জন্য ভাড়ার জন্য "ওয়েবসাইট" বোতামে ক্লিকের মোট সংখ্যা।

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

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

এনামস
ADVANCE_BOOKING_WINDOW_UNSPECIFIED নির্দিষ্ট করা হয়নি।
ADVANCE_BOOKING_WINDOW_SAME_DAY চেক-ইন তারিখ এবং কোয়েরির তারিখ একই ছিল।
ADVANCE_BOOKING_WINDOW_NEXT_DAY চেক-ইনের তারিখ ছিল কোয়েরির তারিখের পরের দিন।
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 চেক-ইনের তারিখ ছিল কোয়েরির তারিখের ২-৭ দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 চেক-ইনের তারিখ ছিল কোয়েরির তারিখের ৮-১৪ দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 চেক-ইনের তারিখ ছিল ক্যোয়ারির তারিখের ১৫-৩০ দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 চেক-ইন তারিখ ছিল ক্যোয়ারির তারিখের ৩১-৬০ দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 চেক-ইন তারিখ ছিল ক্যোয়ারির তারিখের 61-90 দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 চেক-ইন তারিখ ছিল ক্যোয়ারির তারিখের ৯১-১২০ দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 চেক-ইন তারিখ ছিল ক্যোয়ারির তারিখের ১২১-১৫০ দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 চেক-ইন তারিখ ছিল ক্যোয়ারির তারিখের ১৫১-১৮০ দিন পরে।
ADVANCE_BOOKING_WINDOW_DAYS_OVER_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 ৪-৭ রাত থাকা।
LENGTH_OF_STAY_NIGHTS_8_TO_14 ৮-১৪ রাত থাকার ব্যবস্থা।
LENGTH_OF_STAY_NIGHTS_15_TO_21 ১৫-২১ রাত থাকার ব্যবস্থা।
LENGTH_OF_STAY_NIGHTS_22_TO_30 ২২-৩০ রাত থাকার ব্যবস্থা।
LENGTH_OF_STAY_NIGHTS_OVER_30 ৩০ রাতের বেশি সময় ধরে থাকা।

দখল

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

এনামস
OCCUPANCY_UNSPECIFIED নির্দিষ্ট করা হয়নি।
OCCUPANCY_1 একক ব্যক্তি।
OCCUPANCY_2 দুইজন।
OCCUPANCY_3 তিনজন।
OCCUPANCY_4 চারজন।
OCCUPANCY_OVER_4 ৪ জনের বেশি।