XML でホテルリストを設定する

ホテルリストを設定するには、次のいずれかの方法を使用します。

  • CSV ファイルまたは XML ファイルを提供する
  • Hotel Center からファイルをアップロードする
  • サーバーでファイルをホストする

このガイドでは、XML ファイルを使用してホテルリストを設定し、サーバーで XML フィードをホストして、Google がリクエストされたスケジュールで XML ファイルをダウンロードできるようにする方法を説明します。ホテルリストを設定するその他の方法については、ホテル在庫の設定方法をご覧ください。

XML のホテルリストについて

ホテルリスト ファイルには、Hotel Center アカウントに含まれるすべての宿泊施設の説明データ（宿泊施設名、住所、ジオコーディングの場所など）が宿泊施設ごとにまとめられています。

XML ファイル形式のホテルリスト ファイルのごく基本的な例を以下に示します。この例では、ファイルで指定されている複数の <listing> 要素のうち 1 つのみを示しています。各 <listing> 要素はプロパティを表します。

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">6 Acacia Ave</component>
      <component name="addr2">Floor 5</component>
      <component name="city">London</component>
      <component name="province">Greater London</component>
      <component name="postal_code">SW1W 9TQ</component>
    </address>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

XML でホテルリストを作成する

XML でホテルリスト フィードを作成する手順は次のとおりです。

  1. ファイルの要件を確認します。

  2. ホテルリスト XML リファレンスの説明に沿って、ファイルをコーディングします。

  3. ホテルリスト フィードのスキーマを使用してファイルを検証します。

ファイルを検証したら、サーバーでフィードをホストします。また、手動で Hotel Center にリストをアップロードすることもできます。

XML フィードをサーバーでホストする

ホテルリスト pull 配信方法では、サーバーでホテルリストをホストできます。Google は指定された頻度でフィードを取得します。ホテルリストを作成して XML ファイルを検証したら、次の手順を行います。

  1. ホスティングの要件の説明に沿って、ファイルを Google 用に準備します。

  2. テクニカル アカウント マネージャー（TAM）に連絡して、以下を設定します。

    • Google のダウンロード スケジュール（通常は週 1 回）
    • ダウンロード URL と認証の要件

エラーがなければ、ホテルリストは公開され、Google マップで一致したすべての宿泊施設が Hotel Center アカウントの [宿泊施設] タブに表示されます。

エラーが発生した場合は、Google がエラーをユーザーと共有します。これにより、エラーを修正し、ファイルを再度ダウンロードする準備を整えることができます。

ホスティング要件

XML フィードをホストする際は、次の要件を遵守してください。

サーバーの要件

  • サーバーには HTTP または HTTPS でアクセスできる必要があります。

ディレクトリの要件

Google がデータの完全なスナップショットを取得し、不完全なファイルをダウンロードしようとすることがないように、HTTP サーバーにファイルを送信する際は次のガイドラインに従ってください。

  • フィードの XML ファイルは、Google がフェッチするディレクトリ以外のディレクトリで開発および検証します。つまり、download ディレクトリは使用しないでください。

  • フィードの XML ファイルが正常に検証されたら、ダウンロード ディレクトリから新しく作成したフィードへのシンボリック リンクを作成します。

  • .zip ファイルを提供する場合は、XML ファイルをダウンロード ディレクトリではなくルートレベルに含めます。

ファイルの要件

  • Microsoft Word ファイルのようなフォーマット済みファイルではなく、書式なしテキスト ファイルを使用してください。

  • 圧縮されていない XML ファイルが 100 MB を超えないようにしてください。単一または複数の XML ファイルは、単一の .zip ファイルに圧縮できます。圧縮された XML ファイルまたは .zip ファイルには上限はありません。

  • ファイルに名前を付けます。

    • 単一の XML ファイルの場合は、PARTNER_NAME_local.xml を使用します。
    • zip 内の 1 つまたは複数の XML ファイルの場合は、PARTNER_NAME_local.xml.zip を使用します。

    zip 内の XML ファイルには任意の名前を付けることができますが、各ファイル名に言語コードを追加することをおすすめします。

認証要件

  • 必要に応じて、BASIC 認証または DIGEST 認証を使用し、ユーザー名とパスワードでファイルを保護できます。

  • NTLM はサポートされていません。