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

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

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

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

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

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

  1. ホスティング要件の説明に沿って、Google がダウンロードできるようにファイルを準備します。
  2. テクニカル アカウント マネージャー（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 はサポートされていません）。