इस पेज का अनुवाद Cloud Translation API से किया गया है.

लेन-देन (प्रॉपर्टी डेटा) का मैसेज

खास जानकारी

ARI लेन-देन (प्रॉपर्टी डेटा) मैसेज हर प्रॉपर्टी के कमरे के टाइप और पैकेज (या रेट प्लान) के बारे में जानकारी देता है. हर रूम टाइप के डेटा में एक यूनीक आइडेंटिफ़ायर (RoomID), स्थानीय जगह के अनुसार नाम, ब्यौरा, और रूम की फ़ोटो के यूआरएल शामिल होते हैं. हर पैकेज डेटा में एक यूनीक आइडेंटिफ़ायर (PackageID), स्थानीय जगह के अनुसार नाम, ब्यौरा, व्यस्तता की जानकारी, और वैल्यू बढ़ाने वाली चीज़ें शामिल होती हैं.

लेन-देन से जुड़े मैसेज का इस्तेमाल करके, ये काम किए जा सकते हैं:

एक या उससे ज़्यादा प्रॉपर्टी के लिए डेटा तय करें.
हर प्रॉपर्टी के लिए, कमरे का टाइप और पैकेज की जानकारी तय करें.
प्रॉडक्ट के ऑफ़र कंट्रोल करना.

साथ ही, कार्रवाइयों को इन कामों के लिए सेट किया जा सकता है:

प्रॉपर्टी में रूम टाइप और पैकेज जोड़ें.
प्रॉपर्टी से, रूम टाइप और पैकेज हटाएं.

ट्रांज़ैक्शन मैसेज के उदाहरणों के लिए, लेन-देन (प्रॉपर्टी डेटा) उदाहरण देखें.

ज़रूरी और वैकल्पिक एलिमेंट

एक्सएमएल रेफ़रंस ज़रूरी और वैकल्पिक एलिमेंट की जानकारी देता है. एट्रिब्यूट और चाइल्ड एलिमेंट की जानकारी पाने के लिए, लेन-देन (प्रॉपर्टी डेटा) एलिमेंट और एट्रिब्यूट देखें.

सिंटैक्स और स्कीमा

लेन-देन वाला मैसेज बनाते समय, रेफ़रंस के तौर पर लेन-देन (प्रॉपर्टी डेटा) सिंटैक्स उदाहरण का इस्तेमाल करें. इससे यह पक्का किया जा सकेगा कि सही फ़ॉर्मैट का इस्तेमाल किया जा रहा है.

अपने फ़ीड को Google पर सबमिट करने से पहले, पब्लिश किए गए स्कीमा से अपने फ़ीड की पुष्टि करने के लिए, xmllint जैसे तीसरे पक्ष के किसी एक्सएमएल टूल का इस्तेमाल किया जा सकता है. लेन-देन से जुड़े मैसेज के स्कीमा के लिए, Hotel Ads स्कीमा देखें.

दिशा-निर्देश

लेन-देन से जुड़े मैसेज के लिए, यहां दिए गए दिशा-निर्देशों का पालन करें:

कार्रवाइयां:: delta: इसका इस्तेमाल, नए तरह के कमरे और पैकेज (रेट प्लान) जोड़ने या अपडेट करने के लिए करें.; overlay: इसका इस्तेमाल करके, किसी प्रॉपर्टी के सभी तरह के कमरों और पैकेज को नए सेट से बदलें. इसमें उन सभी तरह के कमरों और रेट प्लान की जानकारी शामिल होनी चाहिए जिन्हें आप बेचना चाहते हैं.
इन भाषाओं में उपलब्ध:: नाम, ब्यौरा, और कैप्शन फ़ील्ड के लिए एक से दो भाषाएं बताएं. जैसे, अंग्रेज़ी और ज़रूरत पड़ने पर, प्रॉपर्टी के लिए एक स्थानीय भाषा. ज़रूरत पड़ने पर, दो से ज़्यादा भाषाएं जोड़ी जा सकती हैं.
कमरों के टाइप और पैकेज:: रूम टाइप या पैकेज को अपडेट करते समय, आपको उस रूम टाइप या पैकेज से जुड़ी सभी जानकारी भेजनी होगी. उदाहरण के लिए, कोई फ़ोटो जोड़ते समय, आपको नाम और जानकारी भी शामिल करनी होगी.; <AllowablePackageIDs> और <AllowableRoomIDs> ज़रूरी नहीं हैं. अगर इसे सेट नहीं किया जाता है, तो कमरे का टाइप और किराया प्लान का कोई भी कॉम्बिनेशन बनाया जा सकता है. आपको अब भी कमरे के टाइप और रेट प्लान के आईडी का इस्तेमाल करके, कमरे के किराये और उपलब्धता की जानकारी भेजनी होगी. इन एलिमेंट की मदद से प्रॉडक्ट कंट्रोल किए जा सकते हैं. साथ ही, इन एलिमेंट की मदद से ऐसे कॉम्बिनेशन बंद किए जा सकते हैं जो अब आपके सिस्टम में काम नहीं करते.; जब भी रूम के टाइप या पैकेज में कोई बदलाव हो, तो Google को लेन-देन से जुड़ा मैसेज भेजें. इसके अलावा, ऐसे रूम टाइप या पैकेज के बारे में ज़रूरी जानकारी भी भेजें जिन्हें जोड़ना ज़रूरी है.

उदाहरण

इस सेक्शन में ज़रूरी और वैकल्पिक एलिमेंट का इस्तेमाल करके, ARI लेन-देन मैसेज का बुनियादी उदाहरण दिया गया है. कमरे के टाइप और पैकेज को जोड़ने या अपडेट करने के लिए, delta के लिए किसी कार्रवाई का इस्तेमाल किया जा सकता है, ताकि रूम के टाइप और पैकेज को जोड़ा या अपडेट किया जा सके. इसके अलावा, सभी तरह के कमरों और पैकेज की परिभाषाओं को बदलने के लिए, overlay वाली कार्रवाई का इस्तेमाल किया जा सकता है (इससे पुरानी एंट्री मिट जाती हैं).

आपको नाम, ब्यौरा, और कैप्शन फ़ील्ड के लिए एक से दो भाषाएं (अंग्रेज़ी और अगर ज़रूरी हो, तो प्रॉपर्टी के लिए एक स्थानीय भाषा) तय करनी होगी. इसके बाद, प्रॉपर्टी के डेटा की जानकारी जोड़ें. इसमें फ़ोटो के लिंक भी शामिल हैं.

<PropertyID> और <RoomID> के लिए, रेट प्लान और कमरे के टाइप (दोनों के हिसाब से) के लिए, उन ही आईडी का इस्तेमाल करें जिन्हें आपने अपने सिस्टम में इस्तेमाल किया है. यह पक्का करने के लिए कि Google आपके प्रॉडक्ट की कीमतें और डेटा सही तरीके से दिखा रहा है, आपके सिस्टम के साथ लगातार काम करना ज़रूरी है.

ध्यान दें: Google, रूम टाइप और पैकेज (रेट प्लान) के आइडेंटिफ़ायर के लिए, "आईडी" का इस्तेमाल करता है. वहीं, ओटीए एक्सएमएल, "कोड" का इस्तेमाल करता है. आपको अपने आईडी का इस्तेमाल करना होगा, क्योंकि Google उन्हें जनरेट नहीं करता. प्रॉपर्टी डेटा के लिए, कमरे का टाइप और रेट के लिए प्लान के आईडी, हर प्रॉपर्टी के लिए अलग-अलग होने चाहिए.

अपनी फ़ाइल तैयार करने के बाद, आपको इसे नीचे दिए गए एंडपॉइंट पर पोस्ट मैसेज के ज़रिए 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 कार्रवाई का इस्तेमाल कैसे करें, प्रॉपर्टी के मौजूदा डेटा में कमरे का टाइप और पैकेज जोड़ें, और कमरे के मौजूदा टाइप और पैकेज हटाने जैसे ज़्यादा उदाहरणों के लिए, लेन-देन (प्रॉपर्टी का डेटा) उदाहरण देखें.

कैसे करें

इस सेक्शन में उन स्थितियों के समाधान के बारे में बताया गया है जिनका सामना लेन-देन से जुड़े मैसेज भेजते समय हो सकता है.

पहली स्थिति: रूम टाइप का डेटा हटाने का तरीका

मैं किस तरह का कमरा और/या पैकेज का डेटा हटाऊं?

ब्यौरा

आपने प्रॉपर्टी के लिए कई तरह के कमरे भेजे हैं. इनमें किंग और क्वीन रूम भी शामिल हैं. रीमॉडल किए जाने के दौरान क्वीन रूम के सभी टाइप उपलब्ध नहीं हैं और सिर्फ़ किंग रूम टाइप उपलब्ध हैं.

समस्या का हल

आपको हटाए या बंद किए गए कमरे के टाइप और पैकेज आईडी के लिए, हर रात की उपलब्धता, किराये या इन्वेंट्री को अपडेट करने की ज़रूरत नहीं है.
अगर रूम का टाइप या पैकेज हटा दिया गया है या बंद कर दिया गया है, तो action="overlay" के साथ लेन-देन का एक नया मैसेज भेजें. इसमें सिर्फ़ ऐसे रूम टाइप और पैकेज की जानकारी शामिल होती है जो अब भी चालू हैं. हालांकि, इसमें हटाए गए रूम टाइप या पैकेज को शामिल नहीं किया जाता.

नमूना

यह एक्सएमएल स्निपेट, रूम टाइप को हटाने के लिए, 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>

दूसरी स्थिति: AllowableपैकेजID का इस्तेमाल करके प्रॉडक्ट को कंट्रोल करने का तरीका

अगर पैकेज को कमरे के टाइप के हिसाब से ग्रुप किया जाता है, तो मैं प्रॉडक्ट (कमरे के टाइप और पैकेज को मिलाकर) को कैसे कंट्रोल करूं?

ब्यौरा

आपके पास कुछ ऐसे पैकेज हैं जो सिर्फ़ कुछ खास तरह के कमरों के लिए ही उपलब्ध हैं. उदाहरण के लिए, अगर आपकी प्रॉपर्टी में चार तरह के कमरे (इसमें प्रेसिडेंशियल सुइट भी शामिल है) और छह अलग-अलग पैकेज हैं, लेकिन कुछ ही पैकेज ही प्रेसिडेंशियल सुइट के लिए ज़रूरी शर्तें पूरी करते हैं, तो आपके पास यह तय करने का विकल्प होता है कि वे किन कमरों के लिए ज़रूरी शर्तें पूरी करेंगे.

समस्या का हल

<AllowablePackageIDs> का इस्तेमाल करके, पैकेज में शामिल किए गए प्रॉडक्ट के बारे में बताने के लिए, 'लेन-देन' का अपडेट किया गया मैसेज भेजें.

नमूना

यह एक्सएमएल स्निपेट बताता है कि एक खास तरह के कमरे में इस्तेमाल किए जाने वाले पैकेज तय करने के लिए, <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>

तीसरी स्थिति: AllowableRoomIDs का इस्तेमाल करके, प्रॉडक्ट को कंट्रोल करने का तरीका

जब कमरे के टाइप को पैकेज के हिसाब से ग्रुप में बांटा जाता है, तब मैं प्रॉडक्ट (कमरे के टाइप और पैकेज को जोड़ना) को कैसे कंट्रोल करूं?

ब्यौरा

रूम टाइप और पैकेज का कॉम्बिनेशन अब प्रॉडक्ट के तौर पर नहीं बेचा जाता है या फिर आपको यह कंट्रोल करना है कि नए पैकेज में क्या शामिल हो. उदाहरण के लिए, आपको पैकेज के साथ सिर्फ़ कुछ खास तरह के कमरे तय करने हैं, जैसे कि समुद्र के नज़ारे वाले किंग और क्वीन रूम.

समस्या का हल

<AllowableRoomIDs> एलिमेंट का इस्तेमाल करके, पैकेज के साथ शामिल किए गए सटीक प्रॉडक्ट की जानकारी देने वाला 'लेन-देन' का अपडेट किया गया मैसेज भेजें.

नमूना

यह एक्सएमएल स्निपेट दिखाता है कि पैकेज में ओशन व्यू किंग और क्वीन रूम के टाइप बताने के लिए, <AllowableRoomID> को कैसे इस्तेमाल करें.

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