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

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

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

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

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

ইঙ্গিত প্রতিক্রিয়া বার্তাগুলি নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে তা নির্দিষ্ট করার জন্য যে হোটেল এবং ভ্রমণের জন্য 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 -->
    <!-- Can be > 1 if MultipleItineraries is "checkin_range" in your
         QueryControl message -->
    <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 -->
    <!-- Can be > 1 if MultipleItineraries is "affected_dates" in your
         QueryControl message -->
    <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>

মনে রাখবেন যে একটি চেক-ইন রেঞ্জ বার্তার জন্য একটি একক <Item> এ একাধিক বৈশিষ্ট্য নির্দিষ্ট করতে সক্ষম হওয়ার জন্য, <QueryControl> -এ <MultipleItineraries> -এর মান অবশ্যই "checkin_range" এ সেট করতে হবে।

রেঞ্জেড থাকে

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

<!-- 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>

মনে রাখবেন যে একটি রেঞ্জড স্টে মেসেজ একটি একক <Item> -এ একাধিক বৈশিষ্ট্য নির্দিষ্ট করতে সক্ষম হওয়ার জন্য, <QueryControl> -এ <MultipleItineraries> -এর মান অবশ্যই "affected_dates" এ সেট করতে হবে।

এই উদাহরণগুলির প্রতিটির জন্য, 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-এর কাছ থেকে মূল্য বা মেটাডেটা আপডেটের অনুরোধ। এগুলি পুল এবং পরিবর্তিত মূল্য বিতরণ মোড উভয়ের সাথেই ব্যবহৃত হয়।

Query বার্তা তিন ধরনের আছে:

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

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

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

আরও তথ্যের জন্য, মূল্যের প্রশ্নগুলির জন্য মূল্যের ওভারভিউ এবং মেটাডেটা প্রশ্নের জন্য রুম বান্ডেল মেটাডেটা দেখুন।

তিনটি ভিন্ন ধরনের জন্য সিনট্যাক্স নীচে বর্ণিত হয়েছে।

বাক্য গঠন

<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> উপাদানটিতে একটি বৈশিষ্ট্য থাকতে পারে: latencySensitive .

latencySensitive বৈশিষ্ট্য ঐচ্ছিক। প্রদান করা হলে এবং true সেট করা হলে, এটি নির্দেশ করে যে ক্যোয়ারীটি একটি Live Pricing QuerylatencySensitive অ্যাট্রিবিউট সহ 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>

উদাহরণ

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

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

<?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> সবসময় একটি প্রশ্নে উপস্থিত নাও হতে পারে। এই ধরনের ক্ষেত্রে, আপনার সমস্ত দখলের মূল্য ফেরত দেওয়া উচিত।

<OccupancyDetails> Pricing Object <Occupancy> এর আগে আছে। প্রকারের দ্বারা অতিথিদের নির্দিষ্ট করে, সহ:

  • <NumAdults> : প্রাপ্তবয়স্ক অতিথিদের সংখ্যা
  • <Children> এবং <Child=" age "> : কোন অতিথিরা শিশু (সাধারণত বয়স 0-17) তা নির্দিষ্ট করে এবং ঐচ্ছিকভাবে প্রতিটি শিশুর বয়স অন্তর্ভুক্ত করে।
  • বাধ্যতামূলক না হলেও, <OccupancyDetails> -এর প্রশ্নের ফলে প্রতিটি <Occupancy> কোয়েরির জন্য সংজ্ঞায়িত উপযুক্ত রুম বান্ডেল সহ একটি লেনদেন বার্তা পাওয়া উচিত।

    দ্রষ্টব্য: <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>