建立中繼資料交易訊息

發行項
12/21/2023

如果您使用會議室套件組合，通常您會建立只包含會議室和套件資料的交易訊息。針對中繼資料使用個別訊息，比將它包含在具有路線資料的相同訊息中更好，因為它不會像反復資料一樣頻繁地變更，而且會釋放行程資料的空間。

使用 GZip 壓縮) ，交易訊息限制為 100 MB 的未壓縮資料或 10 MB 的壓縮資料 (。若要減少網路流量，您應該傳送壓縮的資料。

交易訊息應該只包含您要新增或更新的中繼資料，不包含自上次傳送訊息以來未變更的中繼資料。

檔必須使用 UTF-8 編碼，而且必須符合交易 XSD。

重要事項

您必須閱讀並遵循所有旅館價格廣告原則。如需原則清單，請參閱試驗計畫原則。

注意事項

Bing 不支援所有交易 XSD 元素。 Bing 會忽略訊息中不支援的任何元素或屬性。交易訊息參考只包含 Bing 支援的元素和屬性。

注意事項

訊息必須以交易 XSD (中定義的順序或參考) 中所示來指定專案。

重要事項

雖然您可以使用路線來指定空間和套件內嵌，但不建議使用，因為其效率不佳、可能為備援，而且會減少路線可用的空間量。

最上層 Transaction 元素

若要提供 Bing 會議室和套件資料，請建立包含交易訊息的 XML 檔。訊息包含單一的最上層 Transaction 元素。

<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">

您必須指定 timestamp 和 id 屬性。

屬性 timestamp 應該會識別您提交訊息的時間。 Bing 會使用時間戳來確保它只處理最新的中繼資料。例如，如果 Bing 處理的時間戳記為 14：10 的訊息，然後處理時間戳記為 14：09 的訊息，Bing 只會處理 14：09 訊息中未包含在 14：10 訊息中的中繼資料。

id屬性是使用者定義的識別碼，可唯一識別訊息給廣告商。廣告商會使用識別碼來識別旅館摘要狀態報表清單中的訊息。

指定中繼資料

元素 Transaction 包含 PropertyDataSet 元素的清單，每個您定義中繼資料的屬性各一個。訊息應該只包含新的中繼資料或已變更的中繼資料。

下列顯示 PropertyDataSet 屬性 12345 的專案。標識 Property 符必須符合旅館摘要檔案中屬性的識別碼。您可以指定任意數目的 RoomData 和 PackageData 元素。

  <PropertyDataSet>
    <Property>88888</Property>
    <RoomData>. . .</RoomData>
    <RoomData>. . .</RoomData>
    <RoomData>. . .</RoomData>
    <PackageData>. . .</PackageData>
    <PackageData>. . .</PackageData>
  </PropertyDataSet>

RoomData針對屬性中可用的每個會議室和容量類型指定物件。下列範例顯示您可以指定的所有專案。您可以提供的資訊越多越好，但唯一必要的元素是 RoomID 和 Name 。雖然是選擇性的，但您也應該一律包含 Capacity 。在大部分情況下，您也會包含 Occupancy ，除非套件指定它 (例如，適用于兩個) 的 Honeymoon 套件。

  <RoomData>
    <RoomID>12345</RoomID>
    <Name>
      <Text text="Double queen room - Non-smoking" language="en" />
    </Name>
    <Description>
      <Text text="A spacious, non-smoking room with two queen beds" language="en" />
    </Description>
    <PhotoURL>
      <URL>https://mydomain.com/pic1.jpg</URL>
      <Caption>
        <Text text="Desk with USB outlets for charging your devices" language="en" />
      </Caption>
    </PhotoURL>
    <Capacity>4</Capacity>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
    </OccupancyDetails>
  </RoomData>

PackageData為您定義的每個設施套件指定物件。雖然您可以在套件中指定 Capacity 和 Occupancy ，但通常會將它們包含在中 RoomData 。不過，如果套件是以佔用量為基礎，例如適用于兩個的 Honeymoon 套件，則會 Occupancy 包含在 PackageData 中。唯一需要的設施是可退款。此範例示範您可以指定布林值的多種方式。

  <PackageData>
    <PackageID>67890</PackageID>
    <Name>
      <Text text="Standard" language="en" />
    </Name>
    <Description>
      <Text text="Standard room package that applies to most rooms" language="en" />
    </Description>
    <Capacity>4</Capacity>
    <Occupancy>2</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
    </OccupancyDetails>
    <ChargeCurrency>Web</ChargeCurrency>
    <Refundable available="true" refundable_until_days="2" refundable_until_time="17:00:00" />
    <BreakfastIncluded/>
    <ParkingIncluded>true</ParkingIncluded>
    <InternetIncluded>1</InternetIncluded>
    <MembershipBenefitsIncluded>
      <ProgramName>
        <Text text="Holiday" language="en" />
      </ProgramName>
      <ProgramLevel>
        <Text text="Platinum" language="en" />
      </ProgramLevel>
      <NightlyValue currency="USD">50.00</NightlyValue>
    </MembershipBenefitsIncluded>
    <CarRentalIncluded/>
    <MilesIncluded>
      <NumberOfMiles>1500</NumberOfMiles>
      <Provider>
        <Text text="Contoso" language="en" />
      </Provider>
    </MilesIncluded>
    <OnPropertyCredit currency="USD">25.00</OnPropertyCredit>
  </PackageData>

後續步驟

傳送交易訊息之前，請確定您的旅館摘要檔案是最新狀態。若要更新摘要檔案，請連絡您的 TAM。 TAM 將資料匯入 Bing 之後，您就可以開始傳送交易訊息。匯入資料之前傳送的交易訊息將會失敗。

將交易訊息傳送至 Bing 之前，請先驗證該訊息。如需詳細資訊，請參閱驗證您的交易訊息。

如需傳送 Bing 交易訊息的相關資訊，請參閱將交易訊息推送至 Bing 或具有 Bing 提取交易訊息。

如需在您的行程中使用中繼資料的相關資訊，請參閱使用會議室套件組合。

Share via

建立中繼資料交易訊息

最上層 Transaction 元素

指定中繼資料

後續步驟

其他資源