次の方法で共有

メタデータ トランザクション メッセージを作成する

  • [アーティクル]

会議室バンドルを使用する場合は、通常、会議室とパッケージのデータのみを含むトランザクション メッセージを作成します。 メタデータに別のメッセージを使用する方が、スケジュール データと同じメッセージに含めるよりも優れています。これは、スケジュール データほど頻繁に変更されないため、スケジュール データの領域が解放されるためです。

トランザクション メッセージは、100 MB の非圧縮データまたは 10 MB の圧縮データ (GZip 圧縮を使用) に制限されます。 ネットワーク トラフィックを減らすには、圧縮されたデータを送信する必要があります。

トランザクション メッセージには、追加または更新しているメタデータのみが含まれている必要があります。最後にメッセージを送信した後に変更されていないメタデータは含めないでください。

ドキュメントでは UTF-8 エンコードを使用する必要があり、 Transaction XSD に準拠している必要があります。

重要

ホテル価格広告のすべてのポリシーを読み、従う必要があります。 ポリシーの一覧については、「 パイロット プログラム ポリシー」を参照してください。

注:

Bingでは、すべての Transaction XSD 要素がサポートされているわけではありません。 Bingは、サポートされていないメッセージ内の要素または属性を無視します。 トランザクション メッセージリファレンスには、Bingがサポートする要素と属性のみが含まれています。

注:

メッセージは、Transaction XSD で定義された順序で (または参照に示されているように) 要素を指定する必要があります。

重要

旅程で会議室とパッケージをインラインで指定することもできますが、非効率的で冗長な可能性があり、旅程に使用できる領域が減るため、お勧めしません。

最上位の Transaction 要素

会議室データとパッケージ データBingを提供するには、Transaction メッセージを含む XML ドキュメントを作成します。 メッセージには、最上位レベルの Transaction 要素が 1 つ含まれています。

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

属性と id 属性をtimestamp指定する必要があります。

属性は timestamp 、メッセージを送信する時刻を識別する必要があります。 Bingでは、タイム スタンプを使用して、最新のメタデータのみが処理されるようにします。 たとえば、タイム スタンプが 14:10 のメッセージを処理し、タイムスタンプが 14:09 のメッセージを処理Bing場合、Bingは 14:10 メッセージに含まれていない 14:09 メッセージのメタデータのみを処理します。

属性は id 、広告主へのメッセージを一意に識別するユーザー定義 ID です。 広告主は ID を使用して、ホテルフィードの状態レポートの一覧のメッセージを識別します。

メタデータの指定

要素には Transaction 、メタデータを定義するプロパティごとに 1 つずつ、 PropertyDataSet 要素の一覧が含まれています。 メッセージには、新しいメタデータまたは変更されたメタデータのみを含める必要があります。

プロパティ 12345 の要素を次に示します PropertyDataSet 。 ID は Property 、ホテル フィード ファイル内のプロパティの ID と一致する必要があります。 任意の数の および 要素をRoomDataPackageData指定できます。

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

プロパティで RoomData 使用できる会議室と容量の種類ごとにオブジェクトを指定します。 次の例は、指定できるすべての要素を示しています。 提供できる情報が多いほど良くなりますが、必要な要素は RoomID と Nameのみです。 省略可能ですが、常に を含める Capacity必要があります。 ほとんどの場合、パッケージで指定されていない限りも含めます Occupancy (たとえば、2 つの新婚旅行パッケージ)。

  <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 アメニティの各パッケージにオブジェクトを指定します。 パッケージでは と Occupancy を指定Capacityできますが、通常は それらを にRoomData含めます。 ただし、パッケージが 2 人用の新婚旅行パッケージなど、占有率に基づいている場合は を に含めますOccupancyPackageData。 必要なアメニティは払い戻し可能のみです。 この例では、ブール値を指定する複数の方法を示します。

  <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 プルする」を参照してください。

旅程でメタデータを使用する方法については、「 会議室バンドルの使用」を参照してください。