প্রশ্ন & ইঙ্গিত XML রেফারেন্স

এই বিভাগটি Google XML-ভিত্তিক ইঙ্গিত অনুরোধ বার্তা , ইঙ্গিত প্রতিক্রিয়া বার্তা এবং ক্যোয়ারী বার্তাগুলির জন্য একটি রেফারেন্স প্রদান করে৷

<Hint> (ইঙ্গিত প্রতিক্রিয়া বার্তা)

একটি ইঙ্গিত প্রতিক্রিয়া বার্তার মূল উপাদান। ইঙ্গিত প্রতিক্রিয়া বার্তাগুলি নির্দিষ্ট করে যে কোন হোটেল বা ভ্রমণসূচীর সংমিশ্রণগুলি পুনরায় নির্ধারণ করা উচিত৷ তারা Google থেকে একটি ইঙ্গিত অনুরোধ বার্তা আপনার প্রতিক্রিয়া.

একটি ইঙ্গিত প্রতিক্রিয়া বার্তা শুধুমাত্র সেই হোটেলগুলিকে নির্দিষ্ট করা উচিত যেগুলির দাম শেষবার Google আপনার সার্ভার থেকে একটি সফল ইঙ্গিত প্রতিক্রিয়া পাওয়ার পর থেকে পরিবর্তিত হয়েছে৷

মূল পয়েন্ট: আপনি যদি ইঙ্গিত প্রতিক্রিয়া বার্তাগুলি প্রয়োগ না করেন, তাহলে Google-এর Query বার্তাগুলি আপনার হোটেল তালিকা ফিডে চিহ্নিত সমস্ত সম্পত্তির জন্য ডেটা অনুরোধ করে৷

ইঙ্গিত প্রতিক্রিয়া বার্তাগুলি নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে তা নির্দিষ্ট করার জন্য যে হোটেল এবং ভ্রমণের জন্য Google পুনরায় মূল্য নির্ধারণ করবে:

• সঠিক যাত্রাপথ : চেক-ইন তারিখ এবং থাকার দৈর্ঘ্যের সংমিশ্রণ।

• চেক-ইন তারিখের ব্যাপ্তি : চেক-ইন তারিখের একটি পরিসর নির্দিষ্ট করে, প্রথম চেক-ইন তারিখ দিয়ে শুরু হয় এবং শেষ চেক-ইন তারিখ দিয়ে শেষ হয়।

• বিস্তৃত অবস্থান (বা পরিসীমা ভ্রমণপথ )

এই পদ্ধতিগুলির প্রতিটির জন্য ইঙ্গিত প্রতিক্রিয়া বার্তার জন্য একটি ভিন্ন বাক্য গঠনের প্রয়োজন।

আরও তথ্যের জন্য, ইঙ্গিত প্রতিক্রিয়া বার্তাগুলির সাথে পরামর্শ করুন৷

সিনট্যাক্স

ইঙ্গিত প্রতিক্রিয়া বার্তার প্রকারের উপর নির্ভর করে <Hint> উপাদানটি বিভিন্ন সিনট্যাক্স ব্যবহার করে:

সঠিক ভ্রমণপথ

নিম্নলিখিত একটি ইঙ্গিত প্রতিক্রিয়া বার্তায় সঠিক ভ্রমণসূচীর জন্য সিনট্যাক্স দেখায়:

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>hotel_ID</Property>
    ...
    <Stay>
      <CheckInDate>checkin_date</CheckInDate>
      <LengthOfStay>number_of_nights</LengthOfStay>
    </Stay>
  </Item>
  ...
</Hint>

চেক ইন রেঞ্জ

নিম্নলিখিতটি একটি ইঙ্গিত প্রতিক্রিয়া বার্তায় চেক-ইন রেঞ্জের জন্য সিনট্যাক্স দেখায়:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <Property>hotel_ID</Property>
    [...]

    <!-- Required -->
    <FirstDate>first_checkin_date</FirstDate>
    <!-- Required -->
    <LastDate>last_checkin_date</LastDate>
  </Item>
  ...
</Hint>

রেঞ্জেড থাকে

নিম্নলিখিত একটি ইঙ্গিত প্রতিক্রিয়া বার্তায় পরিসীমা থাকার জন্য সিনট্যাক্স দেখায়:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <Property>hotel_ID</Property>
    [...]

    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>first_date</FirstDate>

      <!-- Optional -->
      <LastDate>last_date</LastDate>
    </StaysIncludingRange>
  </Item>
  ...
</Hint>

গুণাবলী

<Hint> উপাদানটিতে একটি ঐচ্ছিক বৈশিষ্ট্য রয়েছে: id । প্রদান করা হলে, এটি এই <Hint> উপর ভিত্তি করে পাঠানো <Query> বার্তাগুলিতে hintId বৈশিষ্ট্য হিসাবে অন্তর্ভুক্ত করা হয়।

শিশু উপাদান

<Hint> উপাদানটিতে নিম্নলিখিত শিশু উপাদান রয়েছে:

শিশু উপাদান	প্রয়োজন?	টাইপ	ইঙ্গিত প্রতিক্রিয়া টাইপ	বর্ণনা
<CheckInDate>	Required	Date	সঠিক ভ্রমণপথ	ভ্রমণপথের জন্য চেক-ইন তারিখ।
<FirstDate>	Required	Date	চেক-ইন ব্যাপ্তি এবং পরিসরের ভ্রমণপথ	একটি চেক-ইন পরিসর বা পরিসীমা থাকার জন্য তারিখ সীমার প্রথম তারিখ ইঙ্গিত প্রতিক্রিয়া বার্তা। তারিখগুলি অন্তর্ভুক্ত।
<Item>	Required	Object	সব	হোটেল/যাত্রাপথ আপডেট করার জন্য একটি ধারক।
<LastDate>	Required*	Date	চেক-ইন ব্যাপ্তি এবং পরিসরের ভ্রমণপথ	একটি চেক-ইন পরিসর বা পরিসীমা থাকার জন্য তারিখ পরিসরের শেষ তারিখ ইঙ্গিত প্রতিক্রিয়া বার্তা। তারিখগুলি অন্তর্ভুক্ত। * এই উপাদান পরিসীমা থাকার জন্য ঐচ্ছিক.
<LengthOfStay>	Required	integer	সঠিক ভ্রমণপথ	একটি ধনাত্মক পূর্ণসংখ্যা হিসাবে প্রকাশ করা ভ্রমণপথের রাতের সংখ্যা।
<Property>	Required	string	সব	একটি হোটেলের আইডি, হোটেল তালিকার মতো একই আইডি ব্যবহার করে। আপনি একটি একক <Item> ব্লকে কতগুলি <Property> উপাদান নির্দিষ্ট করতে পারেন তা নির্দেশিত প্রতিক্রিয়া বার্তার প্রকার দ্বারা নির্ধারিত হয়: সঠিক যাত্রাপথ: 100টি হোটেল পর্যন্ত। চেক-ইন রেঞ্জ: আপনি যদি আপনার <QueryControl> বার্তায় <MultipleItineraries> "checkin_range" এ সেট করেন। রেঞ্জড স্টে: আপনি যদি আপনার <QueryControl> মেসেজে <MultipleItineraries> কে "affected_dates" সেট করেন।
<Stay>	Required	Object	সঠিক ভ্রমণপথ	একটি সঠিক ভ্রমণসূচী ইঙ্গিত প্রতিক্রিয়া বার্তায় <CheckinDate> এবং <LengthOfStay> উপাদানগুলির জন্য একটি ধারক। প্রতিটি <Item> শুধুমাত্র একটি <Stay> থাকতে পারে।
<StaysIncludingRange>	Required	Object	বিস্তৃত ভ্রমণপথ	একটি পরিসীমা থাকার ইঙ্গিত প্রতিক্রিয়া বার্তায় <FirstDate> এবং <LastDate> উপাদানগুলির জন্য একটি ধারক।

উদাহরণ

সঠিক ভ্রমণপথ

নিম্নলিখিত উদাহরণটি একটি একক সম্পত্তি একটি ইঙ্গিত প্রতিক্রিয়া বার্তার জন্য একাধিক ভ্রমণপথ সংজ্ঞায়িত করে:

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>4</LengthOfStay>
    </Stay>
  </Item>
</Hint>

চেক ইন রেঞ্জ

নিম্নলিখিত উদাহরণে দুটি হোটেল উল্লেখ করা হয়েছে যেগুলির মূল্য পরিবর্তিত হয়েছে এবং আবার আনা উচিত৷ Google 12345 এবং 67890 বৈশিষ্ট্যের জন্য 3 জুলাই থেকে 6 জুলাইয়ের মধ্যে সমস্ত ভ্রমণপথ পায়:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Property>67890</Property>
    <FirstDate>2018-07-03</FirstDate>
    <LastDate>2018-07-06</LastDate>
  </Item>
</Hint>

রেঞ্জেড থাকে

নিম্নলিখিত উদাহরণটি পরিসীমাবদ্ধ থাকার দুটি ভিন্ন ব্যবহার দেখায়, একটি রাত্রির জন্য এবং অন্যটি এক রাতের জন্য:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <!-- Google fetches prices for all itineraries (first and last date are set) -->
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
      <LastDate>2018-07-06</LastDate>
    </StaysIncludingRange>
  </Item>

  <!-- Google fetches prices for a single night (first date only) -->
  <Item>
    <Property>67890</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
    </StaysIncludingRange>
  </Item>
</Hint>

এই উদাহরণগুলির প্রতিটির জন্য, Google একটি <Query> এর সাথে প্রতিক্রিয়া জানায়, এবং তারপরে আপনাকে একটি <Transaction> দিয়ে প্রতিক্রিয়া জানাতে হবে যাতে নির্দিষ্ট হোটেল/ভ্রমণপথের মূল্য আপডেট অন্তর্ভুক্ত থাকে।

<HintRequest>

একটি ইঙ্গিত অনুরোধ বার্তার মূল উপাদান। Google আপনার সার্ভারে একটি ইঙ্গিত অনুরোধ বার্তা পাঠায় এবং একটি প্রতিক্রিয়া আশা করে যা হোটেল এবং ভ্রমণপথগুলিকে নির্দিষ্ট করে যার দামগুলি শেষ সময় থেকে Google আপনার সার্ভার থেকে একটি সফল ইঙ্গিত প্রতিক্রিয়া পেয়েছে৷

যদি দামের কোনো পরিবর্তন হয়, তাহলে Google একটি <Query> পাঠায় যা নির্দেশিত হোটেল এবং ভ্রমণপথের জন্য আপডেট করা মূল্যের ডেটা নিয়ে আসে।

আরও তথ্যের জন্য, পরামর্শ অনুরোধ বার্তা .

মূল পয়েন্ট: ইঙ্গিত অনুরোধ বার্তা স্কিমা একটি ইঙ্গিত অনুরোধ বার্তার গঠন এবং সীমাবদ্ধতা সংজ্ঞায়িত করে।

সিনট্যাক্স

<HintRequest> উপাদানটি নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

সিনট্যাক্স

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
  <LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>

গুণাবলী

<HintRequest> উপাদানটির কোনো বৈশিষ্ট্য নেই।

শিশু উপাদান

<HintRequest> উপাদানটিতে নিম্নলিখিত শিশু উপাদান রয়েছে:

শিশু উপাদান	টাইপ	বর্ণনা
<LastFetchTime>	DateTime	শেষবার যে Google একটি ইঙ্গিত অনুরোধ বার্তায় একটি ইঙ্গিত প্রতিক্রিয়া বার্তা পেতে সফল হয়েছিল৷ যদি এই সময়টি আপনি আপনার সার্ভারে দাম আপডেট করার শেষ সময়ের চেয়ে পুরানো হয়, তাহলে আপনাকে একটি ইঙ্গিত প্রতিক্রিয়া বার্তার সাথে প্রতিক্রিয়া জানাতে হবে যা উল্লেখ করে কোন হোটেলগুলি পরিবর্তিত হয়েছে৷ যদি সাম্প্রতিক সফলভাবে আনা না হয়ে থাকে, তাহলে এটি একটি নির্দিষ্ট ব্যবধানের মান সেট করা হবে (বড় ব্যাকলগ সহ আরও গুরুতর সমস্যা এড়াতে)। বর্তমান নির্দিষ্ট ব্যবধান মান 1000 সেকেন্ড, কিন্তু পরিবর্তন সাপেক্ষে. আরও তথ্যের জন্য, ইঙ্গিত প্রতিক্রিয়া বার্তা দেখুন।

উদাহরণ

নিম্নলিখিত উদাহরণটি একটি ইঙ্গিত অনুরোধ বার্তা দেখায়:

ইঙ্গিত অনুরোধ বার্তা

নিম্নলিখিত উদাহরণটি একটি ইঙ্গিত অনুরোধ বার্তা দেখায়:

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
  <LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>

<Query>

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

মূল্য নির্ধারণ ক্যোয়ারী বার্তা

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

যখন আপনার সার্ভার একটি মূল্যের ক্যোয়ারী বার্তা পায়, তখন এটি একটি <Transaction> বার্তার সাথে প্রতিক্রিয়া জানায় যাতে অনুরোধ করা মূল্যের তথ্য রয়েছে।

আরও তথ্যের জন্য, মূল্য সংক্ষিপ্ত বিবরণ দেখুন।

তিনটি বিশেষ ধরনের Query বার্তা রয়েছে:

• লাইভ মূল্য: Google একটি নির্দিষ্ট ব্যবহারকারীর অনুরোধে সাড়া দেয়, একটি রিয়েল-টাইম মূল্য আপডেটের জন্য জিজ্ঞাসা করে। যখন অংশীদাররা একটি Live pricing query মেসেজ পায়, তখন অংশীদারদের উচিত একটি <Transaction> মেসেজের সাথে সাড়া দেওয়া যাতে <Result> উপাদানে অনুরোধ করা মূল্য সংক্রান্ত তথ্য থাকে।

  মূল পয়েন্ট: নতুন অনুসন্ধান অভিজ্ঞতার কারণে, EEA ব্যবহারকারীদের জন্য লাইভ কোয়েরি আর উপলব্ধ নেই।

• প্রসঙ্গ মূল্যের সাথে: ঐতিহাসিকভাবে জনপ্রিয় প্রসঙ্গগুলির উপর ভিত্তি করে Google তার মূল্য ক্যাশে আপডেট করে। আপনি যখন একটি With context query বার্তা পাবেন, তখন আপনাকে একটি <Transaction> বার্তার সাথে প্রতিক্রিয়া জানাতে হবে যাতে <Result> উপাদানগুলিতে অনুরোধ করা মূল্যের তথ্য রয়েছে।

• মেটাডেটা: Google নির্দিষ্ট হোটেলের জন্য রুম এবং রুম বান্ডেলের জন্য মেটাডেটা আপডেটের অনুরোধ করে। আপনি যখন একটি Metadata Query বার্তা পান, তখন আপনাকে একটি <Transaction> বার্তা দিয়ে প্রতিক্রিয়া জানাতে হবে যা <PropertyDataSet> উপাদানগুলিতে রুম এবং রুম বান্ডেল সম্পর্কে ডেটা নির্দিষ্ট করে। আরও তথ্যের জন্য, রুম বান্ডেল মেটাডেটা পড়ুন।

সিনট্যাক্স

<Query> উপাদান নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

মূল্যের প্রশ্ন

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
</Query>

লাইভ মূল্য

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
  <!-- See documentation below for <Context> -->
  <Context>
   ...
  </Context>
</Query>

প্রসঙ্গ সহ

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyContextList>
    <PropertyContext>
      <Property>hotel_id</Property>
      ...
      <!-- See documentation below for <Context> -->
      <Context>
      ...
      </Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

মেটাডেটা

<HotelInfoProperties>
  <Property>property_ID</Property>
  ...
</HotelInfoProperties>

মূল পয়েন্ট: Query বার্তা স্কিমা একটি কোয়েরি বার্তার গঠন এবং সীমাবদ্ধতা সংজ্ঞায়িত করে।

গুণাবলী

<Query> উপাদানটিতে একটি বৈশিষ্ট্য থাকতে পারে: latencySensitive .

latencySensitive বৈশিষ্ট্য ঐচ্ছিক। প্রদান করা হলে এবং true সেট করা হলে, এটি নির্দেশ করে যে ক্যোয়ারীটি একটি Live Pricing Query । latencySensitive অ্যাট্রিবিউট সহ Google-এর কাছে প্রশ্ন পাঠাতে, আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজার (TAM)-এর সাথে যোগাযোগ করুন।

শিশু উপাদান

<Query> উপাদানটিতে নিম্নলিখিত শিশু উপাদান রয়েছে:

শিশু উপাদান	প্রশ্নের ধরন	টাইপ	বর্ণনা
<AffectedNights>	Pricing	integer	বিস্তৃত থাকার জন্য রাতের সংখ্যা। এই উপাদানটি শুধুমাত্র পরিবর্তিত মূল্যের সাথে ব্যবহৃত রেঞ্জড স্টে প্রাইসিং প্রশ্নের জন্য ব্যবহার করা হয়।
<Checkin>	Pricing	Date	একটি নির্দিষ্ট মূল্য পরিবর্তনের তারিখ।
<Context>	Pricing (Live Pricing Queries only)	<Context>	লাইভ প্রাইসিং কোয়েরির জন্য, কিছু নির্দিষ্ট প্যারামিটার উল্লেখ করে যার অধীনে ক্যোয়ারী করা হয়। শিশু উপাদান অন্তর্ভুক্ত: <Occupancy> : অতিথির মোট সংখ্যা <OccupancyDetails> > : অতিথিদের ধরন, যেমন প্রাপ্তবয়স্ক বা শিশু <UserCountry> : যে দেশে ব্যবহারকারী অবস্থিত <UserDevice> : অতিথিরা হোটেল অনুসন্ধান করতে যে ধরনের ডিভাইস ব্যবহার করেন, যেমন "mobile ," " tablet ," বা " desktop ।" <Context> উপাদানটি একটি একক অনুরোধে পুনরাবৃত্তি হতে পারে, বিভিন্ন দখলের জন্য অনুসন্ধানের অনুমতি দেয়। চাইল্ড উপাদান, সিনট্যাক্স এবং উদাহরণগুলির একটি তালিকার জন্য <Context> দেখুন।
<FirstDate>	Pricing	Date	যাত্রাপথের একটি পরিসরের শুরুর তারিখ যেখানে মূল্য প্রযোজ্য। এই উপাদানটি শুধুমাত্র চেক-ইন ডেট রেঞ্জ মূল্যের প্রশ্নগুলির জন্য ব্যবহৃত হয় যা পরিবর্তিত মূল্যের সাথে ব্যবহৃত হয়।
<HotelInfoProperties>	Metadata	string	এক বা একাধিক বৈশিষ্ট্য যার জন্য Google একটি মেটাডেটা Query মেসেজে আপডেট করা রুম এবং রুম বান্ডেল মেটাডেটা চায়। এই উপাদানটিতে এক বা একাধিক <Property> উপাদান থাকতে পারে যা হোটেলের সম্পত্তি আইডি নির্দিষ্ট করে।
<LastDate>	Pricing	Date	যাত্রাপথের একটি পরিসরের শেষ তারিখ যেখানে মূল্য প্রযোজ্য। এই উপাদানটি শুধুমাত্র চেক-ইন ডেট রেঞ্জ মূল্যের প্রশ্নগুলির জন্য ব্যবহার করা হয় যা পুল + ইঙ্গিতগুলির সাথে ব্যবহৃত হয়৷
<Nights>	Pricing	integer	একটি নির্দিষ্ট ভ্রমণের জন্য রাতের সংখ্যা, 30 পর্যন্ত।
<PropertyList>	Pricing	Object	হোটেলের জন্য এক বা একাধিক আইডি যার মূল্য আপডেটের প্রয়োজন। প্রতিটি হোটেলকে একটি <Property> উপাদানে সংজ্ঞায়িত করুন। মান হল একটি স্ট্রিং যা আপনার হোটেল তালিকার একটি হোটেল আইডির সাথে মেলে। যেমন: <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList>

উদাহরণ

মূল্যের প্রশ্ন

নিম্নলিখিত উদাহরণে একটি মূল্য নির্ধারণের ক্যোয়ারী মেসেজ দেখানো হয়েছে যা 23 মে, 2023 থেকে শুরু হওয়া হোটেলের একটি সেটের জন্য মূল্য আপডেটের অনুরোধ করে, যা 3 রাতের জন্য উপলব্ধ:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

লাইভ মূল্য প্রশ্ন

নিম্নলিখিত উদাহরণটি 500 মিলিসেকেন্ডের প্রতিক্রিয়া সময় সীমা সহ একটি লাইভ মূল্যের প্রশ্ন দেখায়:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="8"/>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

প্রসঙ্গ কোয়েরি সহ

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

মেটাডেটা প্রশ্ন

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

অতিরিক্ত উদাহরণের জন্য, পরিসীমা থাকা এবং চেক-ইন তারিখ পরিসরের মূল্যের প্রশ্নগুলি সহ, Query বার্তার উদাহরণগুলি দেখুন।

<Context>

<Context> উপাদানটি একটি Live pricing query জন্য তথ্য বর্ণনা করে, যার মধ্যে অতিথিদের সংখ্যা এবং প্রকার, ব্যবহারকারীর দেশ এবং ব্যবহারকারীর ডিভাইস রয়েছে।

একাধিক <Context> বিভিন্ন ব্যবহারকারী দেশ বা ব্যবহারকারী ডিভাইসের সাথে ব্যবহার করা হবে না। যখন একাধিক <Context> একাধিক দখলের জন্য অনুসন্ধান করতে ব্যবহৃত হয়, তখন সংশ্লিষ্ট সম্পত্তি বা ভ্রমণপথের জন্য একটি অতিরিক্ত রুম বান্ডেল হিসাবে প্রতিটি দখলের মূল্য প্রদান করুন। প্রতিটি সম্পত্তি বা ভ্রমণসূচীর একটি একক <Result> ব্লক থাকা উচিত যাতে একাধিক দখলের দাম অন্তর্ভুক্ত থাকে।

<Context> প্রশ্নের উত্তরের বিশদ বিবরণের জন্য, <OccupancyDetails> দেখুন।

সিনট্যাক্স

<Context> উপাদান নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

সিনট্যাক্স

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>date</Checkin>
  <Nights>number_of_nights</Nights>
  <DeadlineMs>number_of_milliseconds</DeadlineMs>
  <PropertyList>
    <Property>property_ID</Property>
  </PropertyList>
  <Context>
    <Occupancy>total_number_of_guests</Occupancy>
    <OccupancyDetails>
      <NumAdults>number_of_adults</NumAdults>
      <Children>
        <Child age=age_of_one_child_guest/>
        <Child age=age_of_one_child_guest/>
      </Children>
    </OccupancyDetails>
    <UserCountry>end_user_country</UserCountry>
    <UserDevice>user_device_type</UserDevice>
  </Context>
</Query>

শিশু উপাদান

<Context> উপাদানটিতে নিম্নলিখিত শিশু উপাদান রয়েছে:

শিশু উপাদান	প্রশ্নের ধরন	টাইপ	বর্ণনা
<Occupancy>	Pricing	integer	অতিথিদের মোট সংখ্যা নির্দিষ্ট করে। বাধ্যতামূলক না হলেও, <Occupancy> সাথে প্রশ্নের ফলে প্রতিটি <Occupancy> জন্য সংজ্ঞায়িত উপযুক্ত রুম বান্ডেল সহ একটি লেনদেনের বার্তা পাওয়া উচিত, কিন্তু যদি রুম বান্ডেলগুলি অনুপলব্ধ হয় তবে আপনাকে <Occupancy> অধিপত্য> উপাদান নির্দিষ্ট করার পরামর্শ দেওয়া হয়। দ্রষ্টব্য: <Occupancy> সবসময় একটি প্রশ্নে উপস্থিত নাও হতে পারে। এই ধরনের ক্ষেত্রে, আপনার সমস্ত দখলের মূল্য ফেরত দেওয়া উচিত।
<OccupancyDetails>	Pricing	Object	<Occupancy> এর আগে আছে। প্রকারের দ্বারা অতিথিদের নির্দিষ্ট করে, সহ: <NumAdults> : প্রাপ্তবয়স্ক অতিথিদের সংখ্যা <Children> এবং <Child=" age "> : কোন অতিথিরা শিশু (সাধারণত বয়স 0-17) তা নির্দিষ্ট করে এবং ঐচ্ছিকভাবে প্রতিটি শিশুর বয়স অন্তর্ভুক্ত করে। বাধ্যতামূলক না হলেও, <OccupancyDetails> এর সাথে প্রশ্নের ফলে প্রতিটি <Occupancy> জন্য সংজ্ঞায়িত উপযুক্ত রুম বান্ডেল সহ একটি লেনদেনের বার্তা পাওয়া উচিত, কিন্তু যদি রুম বান্ডেলগুলি অনুপলব্ধ হয় তবে এটি সুপারিশ করা হয় যে আপনি <OccupancyDetails> উপাদানটি নির্দিষ্ট করুন। দ্রষ্টব্য: <OccupancyDetails> সবসময় একটি প্রশ্নে প্রদর্শিত নাও হতে পারে। এই ধরনের ক্ষেত্রে, আপনার অনুমান করা উচিত যে সমস্ত অতিথিরা প্রাপ্তবয়স্ক।
<UserCountry>	Pricing	string	ব্যবহারকারীর অবস্থান অনুযায়ী ফিল্টার রেট। মান হল একটি 2-অক্ষরের দেশের কোড যেমন মার্কিন যুক্তরাষ্ট্রের জন্য "US" বা একটি অঞ্চল কোড, যেমন "EU" "। <UserCountry> সংজ্ঞায়িত কোয়েরির ফলে একটি লেনদেনের বার্তা পাওয়া উচিত যেখানে প্রশ্ন করা দেশের জন্য উপযুক্ত <Rates> ব্লক সংজ্ঞায়িত করা হয়েছে।
<UserDevice>	Pricing	string	ব্যবহারকারী যে ডিভাইস থেকে অনুসন্ধান করছেন তার ধরন অনুসারে রেট ফিল্টার করে। সম্ভাব্য মান: mobile desktop tablet <UserDevice> সংজ্ঞায়িত কোয়েরির ফলে একটি লেনদেন বার্তা পাওয়া উচিত যাতে অনুসন্ধান করা ডিভাইসের প্রকারের জন্য উপযুক্ত <Rates> ব্লক সংজ্ঞায়িত করা হয়।

উদাহরণ

দখল

নিম্নলিখিত উদাহরণটি <Context> -এর মধ্যে <Occupancy> জন্য একটি লাইভ মূল্যের প্রশ্ন দেখায়। লাইভ মূল্যের প্রশ্নটি 3 জন প্রাপ্তবয়স্ক অতিথির জন্য।

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

দখলের বিবরণ

নিচের উদাহরণটি <Context> এর মধ্যে <OccupancyDetails> সহ একটি লাইভ মূল্যের প্রশ্ন দেখায়। লাইভ মূল্যের প্রশ্নটি 4 জন অতিথির জন্য, যার মধ্যে 2 জন শিশু, এবং একটি মোবাইল ডিভাইস থেকে মার্কিন গেস্ট বুকিংয়ের ক্ষেত্রে প্রযোজ্য হার চায়:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="4"/>
        <Child age="12"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

একাধিক প্রসঙ্গ

নিম্নলিখিত উদাহরণটি একটি লাইভ মূল্যের প্রশ্নে একটি অতিরিক্ত <Context> উপাদানের ব্যবহার দেখায়।

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
  <Context>
    <Occupancy>6</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
      <Children>
        <Child age="6"/>
        <Child age="10"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>