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

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

खास जानकारी

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

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

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

इसके अलावा, ये काम भी किए जा सकते हैं:

प्रॉपर्टी में कमरे का टाइप और पैकेज जोड़ें.

अहम जानकारी: हर प्रॉपर्टी में ज़्यादा से ज़्यादा 3,000 कमरे हो सकते हैं. हर प्रॉपर्टी के लिए, पैकेज की संख्या की एक अलग सीमा भी 3,000 है. <Transaction> मैसेज का इस्तेमाल इन कामों के लिए किया जा सकता है कमरे के टाइप या पैकेज हटाएं.
प्रॉपर्टी से कमरे का टाइप और पैकेज हटाएं.

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

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

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

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

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

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

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

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

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

उदाहरण

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

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

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

ध्यान दें: Google "आईडी" का इस्तेमाल करता है कमरे के टाइप और पैकेज (किराये का प्लान) के आइडेंटिफ़ायर के लिए; जबकि, OTA एक्सएमएल "कोड" का इस्तेमाल करता है. आपको अपने आईडी का इस्तेमाल करना होगा, क्योंकि 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>

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

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

ब्यौरा

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

समाधान

अपडेट किया गया लेन-देन से जुड़ा मैसेज भेजें, जिसमें बताया गया हो कि कौनसे प्रॉडक्ट शामिल किए गए हैं <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>