この記事では、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 でホテルリスト フィードを作成するには:
- ファイルの要件を確認します。
- ホテルリスト 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 はサポートされていません)。