Method: accounts.freeBookingLinksReportViews.query

বন্ধ করা হয়েছে: PropertyPerformanceReportService.QueryPropertyPerformanceReport ব্যবহার করুন, যার পরিবর্তে ইম্প্রেশন রিপোর্টিংও রয়েছে। একটি নির্দিষ্ট অ্যাকাউন্টের জন্য একটি বিনামূল্যে বুকিং লিঙ্ক রিপোর্ট জিজ্ঞাসা করার (পাওয়ার, ফিল্টার করার এবং সেগমেন্ট করার) ক্ষমতা প্রদান করে।

HTTP অনুরোধ

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

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

পথের পরামিতি

পরামিতি
name

string

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

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

পরামিতি
filter

string

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

date ক্ষেত্রটি আবশ্যক। অন্যান্য সমস্ত ক্ষেত্র ঐচ্ছিক।

date ক্ষেত্রের মানগুলি অন্তর্ভুক্ত এবং অবশ্যই YYYY-MM-DD ফর্ম্যাটে হতে হবে। সবচেয়ে পুরনো গ্রহণযোগ্য তারিখ হল 2021-03-09; আগের তারিখের মানগুলি জোর করে 2021-03-09 করা হবে।

partnerHotelDisplayName এর মানগুলি কেস-অসংবেদনশীলভাবে মেলানো হয়।

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

  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • partnerHotelDisplayName = 'hotel A'
  • partnerHotelDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

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

স্ট্রিং মান হল কমা দ্বারা পৃথক করা ক্ষেত্রগুলির একটি তালিকা। বৈধ ক্ষেত্রগুলি হল: date , userRegionCode , deviceType , partnerHotelId এবং partnerHotelDisplayName । এখানে নির্দিষ্ট করা ক্ষেত্রগুলি কেবল ফ্রিবুকিংলিংকস রেজাল্টে অন্তর্ভুক্ত।

pageSize

integer

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

pageToken

string

পূর্ববর্তী participationReportViews.query অনুরোধ থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পাওয়ার জন্য এটি প্রদান করুন।

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

অনুরোধের মূল অংশ

অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

প্রতিক্রিয়া মূল অংশ

বন্ধ করা হয়েছে: পরিবর্তে PropertyPerformanceReportService দিয়ে QueryPropertyPerformanceReportResponse ব্যবহার করুন। FreeBookingLinksReportService.QueryFreeBookingLinksReport এর জন্য প্রতিক্রিয়া বার্তা।

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

JSON উপস্থাপনা 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
results[]

object ( FreeBookingLinksResult )

কোয়েরির সাথে মেলে এমন ফলাফলের তালিকা।

nextPageToken

string

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

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

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

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

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

ফ্রিবুকিংলিঙ্কসফলাফল

বন্ধ করা হয়েছে: পরিবর্তে PropertyPerformanceReportService সহ PropertyPerformanceResult ব্যবহার করুন। একটি অ্যাকাউন্টের জন্য বিনামূল্যে বুকিং লিঙ্ক পরিসংখ্যান অনুসন্ধানের ফলাফল উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
ক্ষেত্র
date

object ( Date )

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

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

userRegionCode

string

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

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

deviceType

enum ( Device )

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

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

partnerHotelId

string

পার্টনারের হোটেল আইডি।

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

partnerHotelDisplayName

string

সঙ্গীর হোটেলের নাম।

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

clickCount

string ( int64 format)

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