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

この記事では、XML でホテルリストを作成し、リクエストしたスケジュールどおりに Google がダウンロードするようサーバーで XML フィードをホストする（ホテルリストプルとも呼ばれる）方法について説明します。ホテルリストを設定するその他の方法については、ホテル在庫の設定方法をご覧ください。

この記事のトピックは次のとおりです。

XML 形式のホテルリストについて
XML でホテルリストを作成する
サーバーで XML フィードをホストする

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

ホテルリストファイルには、Hotel Center アカウント内のすべての宿泊施設に関する、宿泊施設の名前、住所、ジオコードの場所などを、宿泊施設別に整理して記述したデータが含まれています。

XML ファイル形式のホテルリストファイルの初歩的なサンプルを以下に示します。このサンプルでは、ファイルで指定されている複数の <listing> 要素のうち 1 つのみを示します。各 <listing> 要素は宿泊施設を表します。

サポートされている言語ごとに個別のファイルが必要です。言語は <language> 要素で指定します。

<?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">666 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>UK</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 でホテルリストフィードを作成するには:

ファイルの要件を確認します。
ホテルリスト XML リファレンスの説明に沿って、ファイルをコーディングします。
ホテルリストフィードのスキーマを使用してファイルを検証します。

ファイルの検証が成功したら、次のセクションの説明に沿って、サーバーでフィードをホストします。Hotel Center でリストをアップロードすることを決定した場合は、代わりにホテルリストのアップロードをご覧ください。

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

ホテルリストをサーバー上でホストできます。Google は、お客様が選択した頻度でサーバーからフィードを定期的にダウンロード（「取得」）します。この配信方法は、ホテルリストプルとも呼ばれます。

ホテルリストを作成して XML ファイルを検証したら、次の操作を行います。

ホスティング要件の説明に沿って、Google がダウンロードできるようにファイルを準備します。
テクニカルアカウントマネージャー（TAM）に次の作業を依頼します。

取得スケジュールを決定します。Google は定期的な間隔で（通常は 1 週間に一度）利用可能なファイルを自動的に取得し、取り込みます。
ダウンロード URL と認証の要件を提供します。

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

エラーがある場合は、Google はエラー情報をお客様と共有するため、お客様はエラーを修正し、再ダウンロードに向けてファイルを準備することができます。

ホスティング要件

このセクションでは、XML フィードをホストするための要件を示します。

サーバーの要件
ディレクトリの要件
ファイルの要件
認証の要件

サーバーの要件

XML フィードをサーバー上でホストします。サーバーは HTTP または HTTPS 経由でアクセスできる必要があります。

ディレクトリの要件

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

Google がコンテンツを取得しないディレクトリ（つまり「ダウンロード」ディレクトリにはないディレクトリ）で、フィードの XML ファイルの開発と検証を行います。
フィードの XML ファイルを正常に検証したら、Google がコンテンツをダウンロードするディレクトリにシンボリックリンクを作成します。シンボリックリンクは、新たに作成されたフィードにリンクしている必要があります。
zip ファイルを提供する場合は、ダウンロードディレクトリ内ではなく、ルートレベルで XML ファイルを含めてください。

ファイルの要件

Google がコンテンツを取得しないディレクトリにファイルを作成します。
（書式設定が含まれるファイル（Microsoft Word ファイルなど）ではない）書式なしテキストファイルを使用します。
圧縮されていない単一の XML ファイルは 100 MB を超えないようにします。1 つまたは複数の XML ファイルを 1 つの .zip ファイルに圧縮できます。zip 圧縮する XML ファイルや .zip ファイル自体にはサイズ制限はありません。
次の形式に沿ってファイルに名前を付けます。

<partner_name>_local.xml（単一の XML ファイルの場合）
<partner_name>_local.xml.zip（zip 内に 1 つまたは複数の XML ファイルが含まれる場合）。zip 内の個々の XML ファイルには任意の方法で名前を付けることができますが、ファイル名ごとに言語コードを追加することをおすすめします。

認証の要件

必要に応じて、BASIC 認証と DIGEST 認証のいずれかを使用して、ユーザー名とパスワードによりファイルを保護できます（現時点では NTLM はサポートされていません）。