ক্যোয়ারী বার্তা

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

ক্যোয়ারী বার্তার মূল উপাদান হল <Query> ।

ক্যোয়ারী বার্তার গঠন বার্তার ধরনের উপর নির্ভর করে:

  • মূল্য নির্ধারণ: Google একটি ক্যোয়ারী বার্তা পাঠায় যা নির্দিষ্ট হোটেলের জন্য মূল্য আপডেটের অনুরোধ করে।

  • মেটাডেটা: Google একটি ক্যোয়ারী বার্তা পাঠায় যা নির্দিষ্ট হোটেলের রুম এবং প্যাকেজ তথ্য সম্পর্কে ডেটা অনুরোধ করে।

আপনার প্রাথমিক কনফিগারেশনের সময় Google ক্যোয়ারী মেসেজ এবং লাইভ প্রাইসিং ক্যোয়ারির জন্য যে এন্ডপয়েন্ট ব্যবহার করে তা আপনি নির্ধারণ করেন। আরও তথ্যের জন্য, আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজার (TAM) এর সাথে যোগাযোগ করুন৷

Google একটি ক্যোয়ারী বার্তা পাঠায় একটি HTTP POST অনুরোধ হিসাবে Content-Type হেডারকে "application/xml" এ সেট করে এবং User-Agent হেডার Google-HotelAdsPrices এ সেট করে। Google-TravelAds-Live এর মাধ্যমে প্রাইস এন্ডপয়েন্ট ইন্টিগ্রেশনের ম্যানুয়াল পরীক্ষার সময় এই নিয়মের ব্যতিক্রম ঘটে। এই নমুনা প্রশ্নে User-Agent শিরোনাম থাকতে পারে বা নাও থাকতে পারে।

কোয়েরি বার্তাগুলির জন্য বিস্তারিত বিন্যাস কোয়েরি XML রেফারেন্সে পাওয়া যাবে।

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

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

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

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

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

  1. লাইভ মূল্য: যদি সক্ষম করা থাকে, প্রশ্নগুলি পাঠানো হয় যখন কোনও ব্যবহারকারী সক্রিয়ভাবে নির্দিষ্ট সম্পত্তি বা ভ্রমণসূচীর সংমিশ্রণের জন্য মূল্য ব্রাউজ করে এবং প্রতিক্রিয়া জানানোর জন্য আপনার একটি নির্দিষ্ট সময়সীমা থাকে।

  2. প্রসঙ্গ সহ: যদি সক্ষম করা থাকে, Google আপনাকে যে প্রতিটি প্রশ্ন পাঠায় তাতে ব্যবহারকারীর প্রসঙ্গ সুপারিশগুলি অন্তর্ভুক্ত করা হয় এবং সুপারিশগুলি প্রদত্ত সম্পত্তি বা ভ্রমণপথের সংমিশ্রণগুলির জন্য অনুসন্ধানকারী ব্যবহারকারীদের সবচেয়ে সাধারণ ধরনের প্রতিফলিত করে৷ এই সুপারিশগুলি অনুসরণ করা আপনার প্রতিক্রিয়াগুলির কার্যকারিতা বাড়াতে পারে।

  3. মেটাডেটা: এটি নির্দিষ্ট বৈশিষ্ট্যের জন্য রুম এবং প্যাকেজ সম্পর্কে বিশদ বিবরণের জন্য একটি অনুরোধ।

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

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

সমস্ত লাইভ মূল্যের ক্যোয়ারী অনুরোধের একটি প্রতিক্রিয়া সময় সীমা থাকে যা সাধারণত 4000 মিলিসেকেন্ড পর্যন্ত হয়। এই সীমাটি লাইভ মূল্যের ক্যোয়ারী অনুরোধে উল্লেখ করা হয়েছে। যদি সময়সীমার মধ্যে একটি প্রতিক্রিয়া প্রদান করা না যায়, তবে এটি নির্দিষ্ট সুযোগের জন্য একটি মিস অংশগ্রহণের ফলে। যাইহোক, আমরা যাইহোক একটি মূল্য প্রদান করার সুপারিশ করি যাতে এটি ক্যাশে করা যায় এবং ভবিষ্যতের সুযোগের জন্য ব্যবহার করা যায়। প্রতিক্রিয়ার জন্য সংযোগটি দশ মিনিটের জন্য বা অংশীদারের কনফিগারেশনে উল্লেখ করা হিসাবে খোলা থাকে।

লাইভ মূল্যের প্রশ্নগুলিও প্রাসঙ্গিক এবং নিম্নলিখিত প্যারামিটারগুলির জন্য মূল্য পুনরুদ্ধার করতে পারে: ব্যবহারকারীর দেশ, ডিভাইসের ধরন, দখল (অতিথির সংখ্যা), এবং সেই অতিথিরা প্রাপ্তবয়স্ক বা শিশু কিনা। লাইভ মূল্য নির্ধারণের প্রশ্নের সাথে, আপনি আরও আপ-টু-ডেট দাম দেখাতে পারেন যা গ্রাহকের অনুসন্ধানের সাথে মেলে।

লাইভ মূল্যের প্রশ্নগুলি মূল্য আপডেটের জন্য একটি গৌণ প্রক্রিয়া হতে বোঝানো হয়। পুল বা পরিবর্তিত মূল্যের মাধ্যমে পুনঃমূল্য নির্ধারণের প্রাথমিক প্রক্রিয়া এখনও। লাইভ মূল্যের প্রশ্নগুলি সেই শূন্যস্থানগুলি পূরণ করতে সাহায্য করে যেখানে Google-এর কাছে হোটেল বা ভ্রমণপথের সংমিশ্রণের মূল্য নেই৷

লাইভ মূল্যের প্রশ্ন ব্যবহার করার নিয়ম

  • প্রদত্ত ভ্রমণসূচীর জন্য কোনও ক্যাশে করা ডেটা বিদ্যমান নেই কারণ অনুরোধ করা ভ্রমণপথটি অস্বাভাবিক, যেমন তারিখগুলি ভবিষ্যতে অনেক দূরে বা হোটেলটি খুব কমই অনুসন্ধান করা হয়৷

  • অনুরোধ করা তারিখটি একটি নন-ডিফল্ট তারিখ।

: দ্রষ্টব্য: ডিফল্ট তারিখগুলি লাইভ মূল্যের প্রশ্নগুলির জন্য যোগ্য নয়৷ লাইভ মূল্যের প্রশ্ন শুধুমাত্র অ-ডিফল্ট তারিখের জন্য অনুরোধ করা হয়.

Google সাধারণত একটি লাইভ মূল্যের ফলাফল ক্যাশ করে যাতে একই হোটেল বা ভ্রমণসূচী আবার জিজ্ঞাসা করা না হয়। এটি একক হোটেল বা ভ্রমণপথের সংমিশ্রণের পাশাপাশি মাল্টি-হোটেল বা একক ভ্রমণের সংমিশ্রণের অনুরোধ করতে পারে।

প্রসঙ্গ বৈশিষ্ট্য সহ লাইভ মূল্য Google কে ব্যবহারকারীর ডিভাইসের ধরন, তারা যে দেশ থেকে অনুসন্ধান করছে এবং শিশুদের সহ বাসিন্দাদের সংখ্যার উপর ভিত্তি করে নির্দিষ্ট লাইভ মূল্যের অনুরোধ পাঠাতে সক্ষম করে। ক্যোয়ারী বার্তা এবং লেনদেন বার্তা উভয়ই <Context> উপাদান অন্তর্ভুক্ত করার জন্য প্রসারিত করা হয়েছে যা ক্যোয়ারী প্যারামিটারগুলিকে সংজ্ঞায়িত করে। প্রসঙ্গ সহ লাইভ প্রাইসিং কোয়েরি থেকে প্রাপ্ত দামগুলি একটি রুম বান্ডেল হিসাবে ক্যাশে করা যেতে পারে, যদি এটি একটি নির্দিষ্ট দখলের জন্য একটি মূল্য হয় এবং একটি শর্তসাপেক্ষ রেট হিসাবে, যদি এটি একটি ব্যবহারকারীর দেশ বা ব্যবহারকারীর ডিভাইসের জন্য হয়৷

প্রসঙ্গ প্রশ্ন সঙ্গে

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

মেটাডেটা ক্যোয়ারী বার্তা

মেটাডেটা ক্যোয়ারী বার্তাগুলিতে নির্দিষ্ট বৈশিষ্ট্যগুলির জন্য রুম এবং প্যাকেজ তথ্য সম্পর্কে বিশদ বিবরণ রয়েছে৷

আপনি যখন একটি মেটাডেটা কোয়েরি বার্তা পাবেন, তখন আপনাকে একটি <Transaction> বার্তা দিয়ে প্রতিক্রিয়া জানাতে হবে যেটি <Result> উপাদানগুলিতে অনুরোধ করা বৈশিষ্ট্যগুলির জন্য মূল্য নির্দিষ্ট করে।

আরও তথ্যের জন্য, রুম এবং প্যাকেজ মেটাডেটা সংজ্ঞায়িত করা দেখুন।

কন্ট্রোল প্রশ্ন

এই বিভাগটি বর্ণনা করে যে আপনি কীভাবে নিয়ন্ত্রণ করেন কোন বৈশিষ্ট্য এবং ভ্রমণপথগুলি Google থেকে ক্যোয়ারী বার্তাগুলির বিষয় হতে পারে৷

ভ্রমণের সীমানা

আপনি <ItineraryCapabilities> ব্যবহার করে মূল্যের প্রশ্নের সম্ভাব্য সীমানা নির্ধারণ করেন। আপনি নিয়মগুলি সংজ্ঞায়িত করেন যা তারিখের পরিসর এবং আপনার সমর্থন করার সর্বোচ্চ দৈর্ঘ্য নির্ধারণ করে।

আপনি <MaxAdvancePurchase> এবং <MaxLengthOfStay> এর জন্য ডিফল্ট মান সেট করতে পারেন যা সমস্ত হোটেল বা ভ্রমণপথের সংমিশ্রণে প্রযোজ্য। এছাড়াও আপনি হোটেলের গ্রুপের জন্য এই সেটিংস সংজ্ঞায়িত করতে পারেন।

প্রশ্ন বার্তা উদাহরণ

এই বিভাগটি মূল্য নির্ধারণের ক্যোয়ারী বার্তা এবং একটি মেটাডেটা ক্যোয়ারী বার্তার বেশ কয়েকটি উদাহরণ দেখায়। কোয়েরি XML রেফারেন্সে অতিরিক্ত উদাহরণ পাওয়া যায়।

নমুনা ভ্রমণসূচী

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

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

এই উদাহরণে প্রতিটি হোটেলের জন্য মূল্য আপডেটের অনুরোধ করা হয়েছে:

5/23/18 - 6/26/18

লাইভ মূল্যের প্রশ্নের উদাহরণ

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

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

এই উদাহরণটি একটি একক হোটেলের জন্য মূল্যের অনুরোধ করে:

6/23/23 - 6/25/23

এই প্রশ্নের একটি নমুনা লেনদেন বার্তার প্রতিক্রিয়া মূল্য এবং রুম ইনভেন্টরি (লেনদেন) XML রেফারেন্সে পাওয়া যাবে।

প্রসঙ্গ ক্যোয়ারী উদাহরণ সহ

নিম্নলিখিত উদাহরণটি প্রসঙ্গ ক্যোয়ারী সহ একটি উদাহরণ দেখায়:

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

প্রসঙ্গ প্রশ্নগুলির সাথে শুধুমাত্র ব্যবহারকারীর দেশের প্রসঙ্গ নির্দিষ্ট করে। ভবিষ্যতে, এই ধরনের প্রশ্নগুলি ব্যবহারকারীর ডিভাইস এবং দখলকেও নির্দিষ্ট করতে পারে।

চেক-ইন তারিখ ব্যাপ্তি

যদি আপনি পরিবর্তিত মূল্য ব্যবহার করেন, তাহলে ক্যোয়ারী বার্তার কাঠামো নির্ভর করে আপনি চেক-ইন তারিখের ব্যাপ্তি, সঠিক ভ্রমণপথ বা পরিসীমা ভ্রমণের জন্য ব্যবহার করেন এমন ইঙ্গিত প্রকারের উপর। এই ধরনের প্রতিটি ইঙ্গিত সম্পর্কে আরও তথ্যের জন্য, ইঙ্গিত প্রতিক্রিয়া বার্তা দেখুন।

নিম্নলিখিত উদাহরণটি চেক-ইন তারিখের ব্যাপ্তির জন্য একটি মূল্য <Query> বার্তা দেখায়:

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

এই উদাহরণটি নিম্নলিখিত থাকার জন্য (প্রতিটি হোটেলের জন্য) মূল্য আপডেটের অনুরোধ করে:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

রেঞ্জড স্টেস

নিম্নোক্ত উদাহরণ রেঞ্জেড থাকার জন্য একটি মূল্য <Query> বার্তা দেখায়:

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

এই উদাহরণে প্রতিটি হোটেলের জন্য মূল্য আপডেটের অনুরোধ করা হয়েছে:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

প্লাস প্রদত্ত রাতের আগে শুরু হওয়া (তবে অন্তর্ভুক্ত) থাকা:

5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

মেটাডেটা ক্যোয়ারী মেসেজ

নিম্নলিখিত উদাহরণটি একটি <Query> বার্তা দেখায় যা ঘরের জন্য মেটাডেটা আপডেটের অনুরোধ করে এবং বিভিন্ন বৈশিষ্ট্যের জন্য প্যাকেজ তথ্য:

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

আপনি একটি লেনদেন বার্তা সহ এই ধরনের ক্যোয়ারী বার্তার উত্তর দেন যা রুম এবং প্যাকেজ মেটাডেটা সংজ্ঞায়িত করে। আরও তথ্যের জন্য, রুম এবং প্যাকেজ মেটাডেটা সংজ্ঞায়িত করা দেখুন।