লেনদেন (সম্পত্তি ডেটা) বার্তা

ওভারভিউ

ARI লেনদেন (সম্পত্তি ডেটা) বার্তা প্রতিটি সম্পত্তির রুমের ধরন এবং প্যাকেজ (বা রেট প্ল্যান) সম্পর্কে তথ্য সংজ্ঞায়িত করে। প্রতিটি রুমের প্রকারের ডেটাতে একটি অনন্য শনাক্তকারী ( RoomID ), স্থানীয় নাম, বিবরণ এবং রুমের ফটোগুলির URL অন্তর্ভুক্ত থাকে৷ প্রতিটি প্যাকেজ ডেটাতে একটি অনন্য শনাক্তকারী ( PackageID ), স্থানীয় নাম, বিবরণ, দখল এবং মান-সংযোজন অন্তর্ভুক্ত থাকে।

আপনি নিম্নলিখিত কাজ করতে একটি লেনদেন বার্তা ব্যবহার করতে পারেন:

  • এক বা একাধিক বৈশিষ্ট্যের জন্য ডেটা সংজ্ঞায়িত করুন।
  • প্রতিটি সম্পত্তির জন্য রুমের ধরন এবং প্যাকেজ তথ্য সংজ্ঞায়িত করুন।
  • পণ্য অফার নিয়ন্ত্রণ.

এছাড়াও, আপনি নিম্নলিখিত কাজগুলি সেট করতে পারেন:

  • একটি সম্পত্তিতে একটি রুমের ধরন এবং প্যাকেজ যোগ করুন।
  • একটি সম্পত্তি থেকে একটি রুমের ধরন এবং প্যাকেজ সরান৷

লেনদেন বার্তার উদাহরণের জন্য, লেনদেন (সম্পত্তি ডেটা) উদাহরণ দেখুন।

প্রয়োজনীয় এবং ঐচ্ছিক উপাদান

XML রেফারেন্স প্রয়োজনীয় এবং ঐচ্ছিক উপাদানের বর্ণনা প্রদান করে। গুণাবলী এবং শিশু উপাদানগুলির বিশদ বিবরণের জন্য, লেনদেন (সম্পত্তি ডেটা) উপাদান এবং বৈশিষ্ট্যগুলি দেখুন।

সিনট্যাক্স এবং স্কিমা

আপনি সঠিক বিন্যাস অনুসরণ করছেন তা নিশ্চিত করতে লেনদেন বার্তা তৈরি করার সময় একটি রেফারেন্স হিসাবে লেনদেন (সম্পত্তি ডেটা) সিনট্যাক্স উদাহরণ ব্যবহার করুন।

আপনি একটি তৃতীয় পক্ষের XML টুল ব্যবহার করতে পারেন যেমন xmllint আপনার ফিডগুলিকে Google-এ জমা দেওয়ার আগে প্রকাশিত স্কিমাগুলির সাথে যাচাই করতে৷ লেনদেন বার্তা স্কিমার জন্য, হোটেল বিজ্ঞাপন স্কিমা দেখুন।

নির্দেশিকা

একটি লেনদেন বার্তার জন্য নিম্নলিখিত নির্দেশিকা ব্যবহার করুন:

কর্ম:

delta : নতুন রুমের ধরন এবং প্যাকেজ (রেট প্ল্যান) যোগ বা আপডেট করতে ব্যবহার করুন।

overlay : একটি নতুন সেট সহ একটি সম্পত্তির জন্য সমস্ত রুমের প্রকার এবং প্যাকেজ প্রতিস্থাপন করতে ব্যবহার করুন। আপনি এখনও বিক্রি করতে চান এমন সমস্ত রুমের প্রকার এবং রেট প্ল্যানের তথ্য অন্তর্ভুক্ত করতে হবে।

ভাষা সহযোগিতা:

নাম, বর্ণনা এবং ক্যাপশন ক্ষেত্রগুলির জন্য এক থেকে দুটি ভাষা (ইংরেজি, এবং প্রয়োজনে সম্পত্তির জন্য একটি স্থানীয় ভাষা) নির্দিষ্ট করুন। প্রয়োজনে আপনি দুটির বেশি ভাষা যোগ করতে পারেন।

রুমের ধরন এবং প্যাকেজ:

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

<AllowablePackageIDs> এবং <AllowableRoomIDs> ঐচ্ছিক, এবং সেট না থাকলে, রুমের ধরন এবং রেট প্ল্যানের যেকোনো সমন্বয় করা যেতে পারে। আপনাকে এখনও রুমের ধরন এবং রেট প্ল্যান আইডি সহ উপলব্ধতা এবং রেট পাঠাতে হবে। এই উপাদানগুলি আপনাকে পণ্যগুলিকে নিয়ন্ত্রণ করার পাশাপাশি আপনার সিস্টেম আর সমর্থন করে না এমন সমন্বয়গুলি নিষ্ক্রিয় করতে দেয়৷

যখনই রুমের ধরন বা প্যাকেজ পরিবর্তন হয়, বা রুমের ধরন বা প্যাকেজ সম্পর্কে গুরুত্বপূর্ণ বিবরণ যোগ করা প্রয়োজন তখনই Google কে একটি লেনদেন বার্তা আপডেট পাঠান।

উদাহরণ

এই বিভাগটি প্রয়োজনীয় এবং ঐচ্ছিক উপাদান ব্যবহার করে একটি ARI লেনদেন বার্তার একটি মৌলিক উদাহরণ প্রদান করে। রুমের ধরন এবং প্যাকেজগুলি যোগ বা আপডেট করতে, আপনি রুমের ধরন এবং প্যাকেজগুলি যোগ বা আপডেট করার জন্য delta জন্য একটি অ্যাকশন ব্যবহার করেন, অথবা সমস্ত রুমের ধরন এবং প্যাকেজ সংজ্ঞাগুলি প্রতিস্থাপন করতে (পুরানো এন্ট্রিগুলি মুছে ফেলার জন্য) overlay ব্যবহার করেন৷

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

<PropertyID> এবং <RoomID> এর জন্য, রেট প্ল্যান এবং রুমের ধরনগুলির জন্য (যথাক্রমে) আপনার সিস্টেমের মধ্যে যে আইডিগুলি ব্যবহার করেন সেগুলি ব্যবহার করুন৷ Google আপনার দাম এবং ডেটা সঠিকভাবে প্রদর্শন করছে তা নিশ্চিত করার জন্য আপনার সিস্টেমের সাথে সামঞ্জস্যতা গুরুত্বপূর্ণ।

একবার আপনি আপনার ফাইল প্রস্তুত করে নিলে, আপনাকে অবশ্যই একটি POST বার্তার মাধ্যমে নিম্নলিখিত এন্ডপয়েন্টে Google-এ পাঠাতে হবে: https://www.google.com/travel/hotels/uploads/property_data

কিভাবে বার্তাটি পুশ/পোস্ট করতে হয় সে সম্পর্কে আরও জানতে, পুশিং মেসেজ দেখুন।

একটি delta অ্যাকশন ব্যবহার করে কীভাবে লেনদেন বার্তা সেট করতে হয় তা নিম্নলিখিত উদাহরণটি দেখায়:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

আরও উদাহরণের জন্য, যেমন overlay অ্যাকশন কীভাবে ব্যবহার করবেন, বিদ্যমান সম্পত্তি ডেটাতে একটি রুমের ধরন এবং প্যাকেজ যোগ করুন এবং বিদ্যমান রুমের ধরন এবং প্যাকেজগুলি সরান, লেনদেন (সম্পত্তি ডেটা) উদাহরণ দেখুন।

কিভাবে-tos

এই বিভাগটি লেনদেন বার্তা পাঠানোর সময় আপনার সম্মুখীন হতে পারে এমন পরিস্থিতির সমাধান প্রদান করে।

দৃশ্যকল্প 1: কিভাবে রুম টাইপ ডেটা সরাতে হয়

আমি কিভাবে বিদ্যমান রুমের ধরন এবং/অথবা প্যাকেজ ডেটা সরিয়ে ফেলব?

বর্ণনা

আপনি সম্পত্তির জন্য কিং এবং কুইন রুম সহ একাধিক রুমের ধরন পাঠিয়েছেন। সমস্ত কুইন রুমের ধরন একটি পুনর্নির্মাণের সময় অনুপলব্ধ এবং শুধুমাত্র কিং রুমের প্রকারগুলি বর্তমানে উপলব্ধ।

সমাধান

  • রুম টাইপ এবং প্যাকেজ আইডি যেগুলি সরানো বা নিষ্ক্রিয় করা হয়েছে তার জন্য আপনাকে রাতের জন্য উপলব্ধতা, রেট বা ইনভেন্টরি আপডেট করার দরকার নেই৷
  • যদি রুমের ধরন বা প্যাকেজটি সরানো হয় বা নিষ্ক্রিয় করা হয়, তাহলে action="overlay" সহ একটি নতুন লেনদেন বার্তা পাঠান যাতে শুধুমাত্র সেই ঘরের ধরন এবং প্যাকেজগুলি অন্তর্ভুক্ত থাকে যা এখনও সক্রিয় রয়েছে এবং সরিয়ে দেওয়া রুমের ধরন বা প্যাকেজ বাদ দেয়৷

নমুনা

এই XML স্নিপেটটি দেখায় কিভাবে overlay অ্যাকশন ব্যবহার করে রুমের ধরন সরাতে হয়।

এখানে আসল delta অ্যাকশন রয়েছে যার মধ্যে কিং এবং কুইন রুমের ধরন রয়েছে:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

তারপরে আপনি কুইন রুমের ধরন সরাতে এবং কিং রুমের ধরন রাখতে overlay সেট করতে পারেন:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

দৃশ্যকল্প 2: কিভাবে AllowablePackageIDs ব্যবহার করে পণ্য নিয়ন্ত্রণ করা যায়

প্যাকেজগুলি রুমের ধরন অনুসারে গোষ্ঠীবদ্ধ হলে আমি কীভাবে পণ্যগুলি (রুমের ধরন এবং প্যাকেজের সংমিশ্রণ) নিয়ন্ত্রণ করব?

বর্ণনা

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

সমাধান

<AllowablePackageIDs> ব্যবহার করে প্যাকেজে কোন পণ্যগুলি অন্তর্ভুক্ত করা হয়েছে তা নির্দিষ্ট করে একটি আপডেট করা লেনদেন বার্তা পাঠান।

নমুনা

এই XML স্নিপেটটি দেখায় কিভাবে একটি নির্দিষ্ট রুমের প্রকারের সাথে ব্যবহৃত প্যাকেজগুলি নির্দিষ্ট করতে <AllowablePackageIDs> ব্যবহার করতে হয়। এখানে, পেন্টহাউস স্যুট রুম টাইপ শুধুমাত্র পেন্টহাউস সব-অন্তর্ভুক্ত প্যাকেজ বা বিনামূল্যে প্রাতঃরাশ প্যাকেজের অনুমতি দেয় যখন কিং স্যুট রুমের ধরন শুধুমাত্র কিং অল-ইনক্লুসিভ প্যাকেজ বা পোষ্য বন্ধুত্বপূর্ণ প্যাকেজকে অনুমতি দেয়।

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

দৃশ্য 3: কিভাবে AllowableRoomIDs ব্যবহার করে পণ্য নিয়ন্ত্রণ করা যায়

ঘরের ধরন প্যাকেজ দ্বারা গোষ্ঠীবদ্ধ হলে আমি কীভাবে পণ্যগুলি (রুমের ধরন এবং প্যাকেজের সংমিশ্রণ) নিয়ন্ত্রণ করব?

বর্ণনা

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

সমাধান

একটি আপডেট করা লেনদেন বার্তা পাঠান যা <AllowableRoomIDs> উপাদান ব্যবহার করে প্যাকেজের সাথে অন্তর্ভুক্ত সঠিক পণ্যগুলি নির্দিষ্ট করে।

নমুনা

এই XML স্নিপেটটি দেখায় কিভাবে <AllowableRoomID> ব্যবহার করতে হয় প্যাকেজে oceanview King এবং Queen রুমের ধরন নির্দিষ্ট করতে।

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>