ホテルリストは、料金情報を提供する対象であるすべてのホテルをリストした 1 つ以上の XML ファイルです。ホテルリスト ファイル自体に料金情報は含まれません。
ホテルリストのルート要素は <listings>
要素です。この要素には、宿泊施設を説明する <listing>
要素が含まれます。
初期実装の一環としてホテルリストを作成してから、定期的なメンテナンスの一環としてホテルリストでホテルの追加や削除を行います。
ホテルリストを作成したら、Hotel Center を使用して手動で Google にアップロードするか、自社のサーバーでホストします。
リスティング要件
ホテルリスト内の宿泊施設が Google ホテル広告に表示されるには、宿泊施設が次の条件を満たしている必要があります。
- 宿泊客が滞在できる有料の客室がある
- 一般開放されており、物理的な設備と固定の住所がある
- 壁と水道設備が頑丈に固定されている
- 最短滞在期間が 7 日以下である
対象外となる宿泊施設の一般的な例としては、クルージング、アパートなどがあります(通常は上記の条件を満たさないため)。
壁、水道設備、空調設備(薪ストーブやプロパンガスの暖房を含む)が頑丈に固定されているキャンピング キャビンなどのキャンプ場が対象となります。以下の屋外宿泊施設は対象外です。
- 宿泊客がテントに滞在するキャンプ場
- 宿泊客が自分の RV 車を利用する RV パーク
<listings>
<listings>
はホテルリストのルート要素であり、<language>
要素と少なくとも 1 つの <listing>
が含まれます。
<listings>
要素は、ホテルリストの XML 階層内の次の場所にあります。
+<listings>
+ <language> +<listing>
構文
<listings>
要素の構文は次のとおりです。
<?xml version="1.0" encoding="UTF-8"?> <listings xmlns:xsi="xsi" xsi:noNamespaceSchemaLocation="schema_xsd"> <language>language_code</language> <listing>listing</listing> ... </listings>
属性
<listings>
要素には次の属性があります。
属性 | 必須 | 説明 |
---|---|---|
xmlns:xsi |
必須 | 「http://www.w3.org/2001/XMLSchema-instance」に設定します。 |
xsi:noNamespaceSchemaLocation |
必須 | 「https://www.gstatic.com/localfeed/local_feed.xsd」に設定します。 |
子要素
<listings>
要素には次の子要素があります。
子要素 | 必須 | 型 | 説明 |
---|---|---|---|
<language> |
必須 | String | フィードが記述されている言語。この要素の値は、2 文字の言語コードに設定します。たとえば、英語には「en」が対応します。 |
<listing> |
必須 | <listing> |
フィード内の各ホテルを説明する 1 つ以上のエントリ。リスト内の各ホテルには、サイトに固有の ID が必要です。また、この ID は絶対に再利用しないでください。 |
例
構造化された住所
次の例に、構造化された住所が含まれるホテルリストの一部を示します。
<?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 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>666 Acacia Ave, Floor 5, Boston, MA, 02472</address> <country>US</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>
オプションのコンテンツ
次の例に、<content>
(省略可)を含むリスティングが含まれるホテルリストの一部を示します。
<?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> <id>123456</id> <name>My Apartment</name> <address format="simple"> <component name="addr1">1 Sandstone Building</component> <component name="city">Los Angeles</component> <component name="postal_code">90210</component> <component name="province">CA</component> </address> <country>US</country> <latitude>40.730610</latitude> <longitude>-73.935242</longitude> <phone type="main">12345678</phone> <category>hotel</category> <!-- You can use whatever property type categories you wish --> <content> <text type="description"> <link>https://examplelisting.com/listings/12345</link> <title>3 bedrooms with ocean views</title> <body>Stay in this newly renovated 3BR house with ocean views.</body> <date month="7" day="23" year="2017"/> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE.COM</author> <rating>8</rating> <body>This place is really good.</body> </review> <review type="user"> <link>https://exampleperson.org/reviews/82</link> <author>Susan von Trapp</author> <rating>6</rating> <body>Not a bad place, but I prefer to be closer to the beach.</body> <date day="6" month="7" year="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com</website> <client_attr name="rating">8.2</client_attr> <client_attr name="star_rating">4</client_attr> <client_attr name="num_reviews">14</client_attr> <client_attr name="air_conditioned">Yes</client_attr> <client_attr name="has_beach_access">No</client_attr> <client_attr name="has_free_breakfast">Yes</client_attr> <client_attr name="has_spa">No</client_attr> <client_attr name="number_of_rooms">5</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> <client_attr name="kitchen_availability">Available in all rooms</client_attr> <client_attr name="parking_type">No payment required</client_attr> <client_attr name="swimming_pool_type">Indoors</client_attr> <client_attr name="wifi_type">Paid</client_attr> </attributes> <image type="photo" url="https://image_url"> <link>https://image_url</link> <title>Main hotel picture</title> </image> </content> </listing> ... </listings>
<listing>
ホテルリスト <listings>
要素内のホテル定義。
<listing>
要素は、ホテルリスト フィードの XML 階層の次の場所にあります。
+ <listings>
+ <language>
+ <listing>
構文
<listing>
要素の構文は次のとおりです。
<?xml version="1.0" encoding="UTF-8"?> <listings ... > <listing> <!-- Specify <listing>'s child elements in the order shown below. --> <id>hotel_ID</id> <name>hotel_name</name> <address> <component name="addr1">street_address_1</component> <component name="addr2">street_address_2</component> <component name="city">city_name</component> <component name="province">province_name</component> <component name="postal_code">postal_code</component> </address> <!-- You can also define an address freeform, although this is not recommended: --> <!-- <address>freeform_address</address> --> <country>country_code</country> <latitude>hotel_latitude</latitude> <longitude>hotel_longitude</longitude> <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone> <category>hotel</category> <!-- You can use whatever property type categories you wish --> <content>content</content> </listing> </listings>
属性
<listing>
要素には属性はありません。
子要素
<listing>
要素には次の子要素があります。
子要素 | 必須 | 型 | 説明 |
---|---|---|---|
<id> |
必須 | String | ホテルの一意の ID。 |
<name> |
必須 | String | ホテルの名前。たとえば次のようになります。
<name>Belgrave House</name> |
<address> |
必須 | オブジェクトまたは文字列 | ホテルの正式な物理的所在地。 この要素は、「simple」に設定する必要がある単一の属性 少なくとも、ホテルの番地、市区町村、都道府県 / 州、郵便番号を指定する必要があります。
たとえば、次のようになります。 <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> または、「自由形式」の住所を指定することもできますが、おすすめしません。たとえば、次のようになります。 <address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address> 私書箱や郵便物受け取り専用住所は、正式な物理的住所とは見なされません。 |
<country> |
必須 | String | このリスティングが存在する国。ISO 3116 の大文字 2 文字の国コードで値を指定してください。例: 日本であれば「JP」、米国であれば「US」。たとえば次のようになります。
<country>US</country> |
<latitude> |
必須* | Float | ホテル所在地の緯度。例:
<latitude>37.423738</latitude> この値は、Google Maps API などの GeoCoding ツールを使用して生成できます。 |
<longitude> |
必須* | Float | ホテル所在地の経度。例:
<longitude>-122.090101</longitude> この値は、Google Maps API などの GeoCoding ツールを使用して生成できます。 |
<location_precision> |
任意 | Integer | 宿泊施設の緯度と経度が難読化されている場合に、送信される宿泊施設の位置情報の精度(メートル単位)。ゼロ(0)は難読化が行われておらず、正確な位置情報であることを意味します。注: この要素は民泊にのみ適用されます。 |
<phone> |
必須* | String | ホテルの 1 つ以上の連絡先電話番号。リスティングが企業の支店の場合は、(本社の電話番号ではない)支店の所在地に固有の電話番号を指定してください。
たとえば、次のようになります。 <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> 少なくとも、 |
* 電話番号または経緯度のいずれかを必ず指定してください。両方を定義することをおすすめします。 | |||
<category> |
任意 | String | ホテルなどの宿泊施設のタイプ。パートナーは、「ビジネス ホテル」、「リゾート」、「モーテル」など、宿泊施設を説明するための任意の内部カテゴリを使用できます。 |
<content> |
任意 | <content> |
宿泊施設の説明、評価、特長など、リスティングに使用されるオプションの詳細情報。 |
例
構造化された住所
次の例に、構造化された住所が含まれるホテルリストの一部を示します。
<?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 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>666 Acacia Ave, Floor 5, Boston, MA, 02472</address> <country>US</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>
オプションのコンテンツ
次の例に、<content>
(省略可)を含むリスティングが含まれるホテルリストの一部を示します。
<?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> <id>123456</id> <name>My Apartment</name> <address format="simple"> <component name="addr1">1 Sandstone Building</component> <component name="city">Los Angeles</component> <component name="postal_code">90210</component> <component name="province">CA</component> </address> <country>US</country> <latitude>40.730610</latitude> <longitude>-73.935242</longitude> <phone type="main">12345678</phone> <category>hotel</category> <!-- You can use whatever property type categories you wish --> <content> <text type="description"> <link>https://examplelisting.com/listings/12345</link> <title>3 bedrooms with ocean views</title> <body>Stay in this newly renovated 3BR house with ocean views.</body> <date month="7" day="23" year="2017"/> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE.COM</author> <rating>8</rating> <body>This place is really good.</body> </review> <review type="user"> <link>https://exampleperson.org/reviews/82</link> <author>Susan von Trapp</author> <rating>6</rating> <body>Not a bad place, but I prefer to be closer to the beach.</body> <date day="6" month="7" year="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com</website> <client_attr name="rating">8.2</client_attr> <client_attr name="star_rating">4</client_attr> <client_attr name="num_reviews">14</client_attr> <client_attr name="air_conditioned">Yes</client_attr> <client_attr name="has_beach_access">No</client_attr> <client_attr name="has_free_breakfast">Yes</client_attr> <client_attr name="has_spa">No</client_attr> <client_attr name="number_of_rooms">5</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> <client_attr name="kitchen_availability">Available in all rooms</client_attr> <client_attr name="parking_type">No payment required</client_attr> <client_attr name="swimming_pool_type">Indoors</client_attr> <client_attr name="wifi_type">Paid</client_attr> </attributes> <image type="photo" url="https://image_url"> <link>https://image_url</link> <title>Main hotel picture</title> </image> </content> </listing> ... </listings>
<content>
リスティングに関する情報(評価、レビュー、設備などの詳細情報)を追加します。<content>
要素は省略可です。<content>
内では、すべての子要素は省略可です。
<content>
要素は、ホテルリスト フィードの XML 階層の次の場所にあります。
+ <listings>
+ <language>
+ <listing>
+ <content>
構文
<content>
要素の構文は次のとおりです。
<?xml version="1.0" encoding="UTF-8"?> <listings ... > <listing> <content> <!-- Specify <text>'s child elements in the order shown below. --> <text type="description"> <link>listing_link</link> <title>listing_title</title> <author>listing_author</author> <body>listing_description</body> <date month="MM" day="DD" year="YYYY"/> </text> <!-- 0 or more reviews: --> <review type="[editorial|user]"> ... </review> <!-- 0 or more attributes: --> <attributes> <website>https://hotel.example.com</website> <client_attr name="air_conditioned">[No|Yes]</client_attr> <client_attr name="all_inclusive_available">[No|Yes]</client_attr> <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr> <client_attr name="child_friendly">[No|Yes]</client_attr> <client_attr name="custom_0">custom_attribute_0</client_attr> <client_attr name="custom_1">custom_attribute_1</client_attr> <client_attr name="custom_2">custom_attribute_2</client_attr> <client_attr name="custom_3">custom_attribute_3</client_attr> <client_attr name="custom_4">custom_attribute_4</client_attr> <client_attr name="has_affiliated_golf_course">[No|Yes]</client_attr> <client_attr name="has_airport_shuttle">[No|Yes]</client_attr> <client_attr name="has_bar_or_lounge">[No|Yes]</client_attr> <client_attr name="has_beach_access">[No|Yes]</client_attr> <client_attr name="has_business_center">[No|Yes]</client_attr> <client_attr name="has_fitness_center">[No|Yes]</client_attr> <client_attr name="has_free_breakfast">[No|Yes]</client_attr> <client_attr name="has_hot_tub">[No|Yes]</client_attr> <client_attr name="has_laundry_service">[No|Yes]</client_attr> <client_attr name="has_restaurant">[No|Yes]</client_attr> <client_attr name="has_room_service">[No|Yes]</client_attr> <client_attr name="has_spa">[No|Yes]</client_attr> <client_attr name="hotel_brand">hotel_brand</client_attr> <client_attr name="kitchen_availability">[Available in all rooms|Available in some rooms| Not available]</client_attr> <client_attr name="number_of_rooms">rooms_per_unit</client_attr> <client_attr name="num_reviews">number_of_reviews</client_attr> <client_attr name="parking_type">[No payment required|Paid|Not available]</client_attr> <client_attr name="pets_allowed">[No|Yes]</client_attr> <client_attr name="rating">aggregate_rating</client_attr> <client_attr name="star_rating">[1|2|3|4|5]</client_attr> <client_attr name="smoke_free_property">[No|Yes]</client_attr> <client_attr name="swimming_pool_type">[Indoors|Outdoors|Indoors and outdoors|Not available]</client_attr> <client_attr name="wheelchair_accessible">[No|Yes]</client_attr> <client_attr name="wifi_type">[Not available|No payment required|Paid]</client_attr> </attributes> <!-- a picture of the hotel or property--> <image type="photo" url="https://image_url"> <link>https://image_url</link> <title>Main Hotel Picture</title> </image> </content> </listing> ... </listings>
属性
<content>
要素には属性はありません。
子要素
<content>
要素には次の子要素があります。
子要素 | 必須 | 型 | 説明 |
---|---|---|---|
<text |
任意 | オブジェクト | プロバイダのリスティングに関連付けられているウェブページ。 次の子要素があります:
注: これらの要素は上記の順序にする必要があります。 |
<review |
任意 | <review> |
リスティングのユーザー レビューまたはエディタ レビューが含まれます。リスティングには、どちらのレビューでも、任意の数だけ含めることができます。
|
<attributes> |
任意 | オブジェクト | 宿泊施設に関する詳細情報を提供する 0 個以上の <client_attr name="attribute_name">attribute_value<client_attr> 子要素のリストと説明については、 すべての
|
<image> |
任意 | オブジェクト | 繰り返しタグ。詳細な画像情報が含まれます。 |
例
次の例に、<content>
要素が含まれるホテルリストの一部を示します。
<?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> <id>123456</id> <name>My Apartment</name> <address format="simple"> <component name="addr1">1 Sandstone Building</component> <component name="city">Los Angeles</component> <component name="postal_code">90210</component> <component name="province">CA</component> </address> <country>US</country> <latitude>40.730610</latitude> <longitude>-73.935242</longitude> <phone type="main">12345678</phone> <category>hotel</category> <!-- You can use whatever property type categories you wish --> <content> <text type="description"> <link>https://examplelisting.com/listings/12345</link> <title>3 bedrooms with ocean views</title> <body>Stay in this newly renovated 3BR house with ocean views.</body> <date month="7" day="23" year="2017"/> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE.COM</author> <rating>8</rating> <body>This place is really good.</body> </review> <review type="user"> <link>https://exampleperson.org/reviews/82</link> <author>Susan von Trapp</author> <rating>6</rating> <body>Not a bad place, but I prefer to be closer to the beach.</body> <date day="6" month="7" year="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com</website> <client_attr name="rating">8.2</client_attr> <client_attr name="star_rating">4</client_attr> <client_attr name="num_reviews">14</client_attr> <client_attr name="air_conditioned">Yes</client_attr> <client_attr name="has_beach_access">No</client_attr> <client_attr name="has_free_breakfast">Yes</client_attr> <client_attr name="has_spa">No</client_attr> <client_attr name="number_of_rooms">5</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> <client_attr name="kitchen_availability">Available in all rooms</client_attr> <client_attr name="parking_type">No payment required</client_attr> <client_attr name="swimming_pool_type">Indoors</client_attr> <client_attr name="wifi_type">Paid</client_attr> </attributes> <image type="photo" url="https://image_url"> <link>https://image_url</link> <title>Main hotel picture</title> </image> </content> </listing> ... </listings>
<review>
ユーザー レビューまたはエディタ レビューが含まれます。<listing>
要素にリスティングのすべてのレビューを含める必要はありません。この要素は、このリスティングの特長や品質を示す特定のレビューを含めるためのものです。
<review>
要素は、ホテルリスト フィードの XML 階層の次の場所にあります。
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
構文
<review>
要素の構文は次のとおりです。
<?xml version="1.0" encoding="UTF-8"?> <listings ... > <listing> <content> ... <!-- Specify <review>'s child elements in the order shown below. --> <review type="editorial"> <link>review_link</link> <title>review_title</title> <!-- Title is for reviews of type "editorial" only --> <author>review_author</author> <rating>review_rating</rating> <body>review_text</body> <date>review_date</date> <servicedate>review_servicedate</servicedate> </review> <review type="user"> <link>review_link</link> <author>review_author</author> <date month="MM" day="DD" year="YYYY"/> <!-- Date is for reviews of type "user" only --> <servicedate month="MM" day="DD" year="YYYY"/> <!-- Service Date is for reviews of type "user" only --> <rating>review_rating</rating> <body>review_text</body> </review> </content> </listing> </listings>
属性
<review>
要素には次の属性があります。
属性 | 必須 | 説明 |
---|---|---|
type |
必須 | レビューのタイプ。次のいずれかの値に設定します。
|
子要素
<review>
要素には次の子要素があります。
子要素 | 必須 | 型 | 説明 |
---|---|---|---|
<link> |
任意 | String | レビューへのリンク。この要素には「http://」または「https://」を含めます。 |
<title> |
任意 | String | (エディタ レビューのみ)レビューのタイトル。 |
<author> |
任意 | String | レビューの投稿者(例: 「Susan von Trapp」)。レビューにクレジット表記がない場合は、レビューが表示されているウェブサイトやパブリケーションの名前にすることもできます。 |
<rating> |
任意 | String | レビューのスコアを表す 0~10 の浮動小数点数。例: 「8.9」。 |
<body> |
任意 | String | レビューのテキスト。この要素には HTML を含めないでください。 |
<date month="MM" day="DD" year="YYYY"/> |
任意 | オブジェクト | (ユーザー レビューのみ)レビューの日付。この要素の次の属性を使用して指定します。
たとえば、2017 年 6 月 7 日は次のように記述します。 <date month="6" day="7" year="2017"/> |
<servicedate month="MM" day="DD" year="YYYY"/> |
任意 | オブジェクト | (ユーザー レビューのみ)レビュー投稿者がレビュー対象のリスティングを訪問した日付。形式は上記の <date> と同じです。
たとえば、2017 年 6 月 7 日は次のように記述します。 <servicedate month="6" day="7" year="2017"/> |
なお、<title>
が <review>
の有効な子要素であるのはレビューの type
が editorial
である場合に限られ、<date>
が有効であるのは type
が user
である場合に限られます。
例
次の例に、エディタとユーザーのレビューを含むリスティングが含まれるホテルリストの一部を示します。
<?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> <id>123456</id> <name>My Apartment</name> <address format="simple"> <component name="addr1">1 Sandstone Building</component> <component name="city">Los Angeles</component> <component name="postal_code">90210</component> <component name="province">CA</component> </address> <country>US</country> <latitude>40.730610</latitude> <longitude>-73.935242</longitude> <phone type="main">12345678</phone> <category>hotel</category> <!-- You can use whatever property type categories you wish --> <content> <text type="description"> <link>https://examplelisting.com/listings/12345</link> <title>3 bedrooms with ocean views</title> <body>Stay in this newly renovated 3BR house with ocean views.</body> <date month="7" day="23" year="2017"/> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE.COM</author> <rating>8</rating> <body>This place is really good.</body> </review> <review type="user"> <link>https://exampleperson.org/reviews/82</link> <author>Susan von Trapp</author> <rating>6</rating> <body>Not a bad place, but I prefer to be closer to the beach.</body> <date day="6" month="7" year="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com</website> <client_attr name="rating">8.2</client_attr> <client_attr name="star_rating">4</client_attr> <client_attr name="num_reviews">14</client_attr> <client_attr name="air_conditioned">Yes</client_attr> <client_attr name="has_beach_access">No</client_attr> <client_attr name="has_free_breakfast">Yes</client_attr> <client_attr name="has_spa">No</client_attr> <client_attr name="number_of_rooms">5</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> <client_attr name="kitchen_availability">Available in all rooms</client_attr> <client_attr name="parking_type">No payment required</client_attr> <client_attr name="swimming_pool_type">Indoors</client_attr> <client_attr name="wifi_type">Paid</client_attr> </attributes> <image type="photo" url="https://image_url"> <link>https://image_url</link> <title>Main hotel picture</title> </image> </content> </listing> ... </listings>
<attributes>
<attributes>
タグを使用すると、宿泊施設の設備を説明し、宿泊施設の評価とレビューを分類することができます。
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
注: すべての属性は省略可能です。
子要素
子要素 | 必須 | 説明 | |
---|---|---|---|
<website> |
任意 | ホテルのメインのウェブサイト。存在する場合は、最初の <client_attr> 要素の前に配置する必要があります。例:
<website>https://hotel.example.com</website> |
|
<client_attr name="attribute_name"> |
任意 | 宿泊施設の追加の特性または「属性」。現在サポートされている attribute_name または民泊の attribute_name を使用して指定できます。
|
attribute_name プレースホルダの値
次の表に、<client_attr name="attribute_name">
要素の attribute_name
に有効な値の一覧を示します。
attribute_name の値 |
説明 | 有効なコンテンツの値 |
---|---|---|
air_conditioned |
この宿泊施設のすべての客室はエアコン完備である。 | はい / いいえ |
all_inclusive_available |
客室や料金に関する情報が利用できる。これには、客室だけでなく、滞在期間中の宿泊客用のすべての食事や飲み物(アルコール飲料を含む)が含まれる。 | はい / いいえ |
alternate_hotel_id |
宿泊施設の代替 ID。フィード情報用と予約エンジン用にそれぞれの宿泊施設 ID が必要な場合は、個別の ID があると便利です。 | 任意の文字列値 |
child_friendly |
お子様と一緒に旅行するご家族向けの特長(割引料金、簡易ベッドや子供サイズのベッド、保育施設、ベビーシッター サービス、施設内で遊べる子ども向けの娯楽施設や広場など)が 1 つ以上ある。 | はい / いいえ |
custom_[0-4] |
任意の文字列型のカスタム属性。これらはユーザーには表示されませんが、Google 広告キャンペーンでホテルをグループ化するために使用できます。カスタム属性として使用できるフィールドは 5 つあり、各フィールドは値が同じであっても個別の属性として扱われます。たとえば、custom_0 が「市内中心部」であるホテルと custom_4 が「市内中心部」であるホテルは同じグループに分類されません。 | 任意の文字列値 |
has_affiliated_golf_course |
この宿泊施設は、施設内にゴルフコースがあるか近くにゴルフコースを所有し、スタート時間の予約のほか、宿泊客向けにコースとの間で送迎を提供している。多くの場合、ゴルフコースを使用するには料金がかかります。 | はい / いいえ |
has_airport_shuttle |
この宿泊施設は空港送迎バスを無料または追加料金で提供している。複数のホテルで停留する送迎バスである可能性がありますが、このホテルに確実に停留すれば問題ありません。 | はい / いいえ |
has_bar_or_lounge |
アルコール飲料を提供する屋内 / 屋外のバーやラウンジがある。宿泊客が施設から外に出ることなくバーやラウンジに行けることが要件となります。 | はい / いいえ |
has_beach_access |
この宿泊施設には公道を横断することなく直接到達できるビーチがある。 | はい / いいえ |
has_business_center |
この宿泊施設には、施設内に、仕事用の作業スペース(無料または有料)が必要な宿泊客が利用できる、パソコン、インターネット アクセス、プリンタが用意されている部屋がある。 | はい / いいえ |
has_fitness_center |
この宿泊施設にはフィットネス センターがある。宿泊客が施設から外に出ることなくフィットネス センターに行けることが要件となります。 | はい / いいえ |
has_free_breakfast |
客室料金と曜日に関係なく、すべての宿泊客に無料で朝食が提供されている。ホテルに、朝食が無料である客室料金と、朝食が無料ではない客室料金がある場合、この属性には false を指定する必要があります。 |
はい / いいえ |
has_hot_tub |
客室の一部またはすべてにジェットバスやジャグジーがあるか、宿泊施設は施設内に温水浴槽がある。温水浴槽を利用するには追加料金が必要な場合があります。 | はい / いいえ |
has_laundry_service |
宿泊客はフロントデスクまたは客室内に洗濯物を置いておくと、洗濯済みの衣類を客室に返却してもらうことができる。このサービスには追加料金が必要な場合があります。コイン ランドリー施設は該当しません。 | はい / いいえ |
has_restaurant |
施設の屋内 / 屋外に座ってくつろげるレストランがある。宿泊客が施設から外に出ることなくレストランに行けることが要件となります。 | はい / いいえ |
has_room_service |
食べ物は施設内で調理され、スタッフにより客室まで直接届けられる。ルームサービスの時間には制限がある場合があります。追加料金がかかる場合があります。 | はい / いいえ |
has_spa |
宿泊施設にはスパがあり、マッサージ、サウナ、フェイシャル トリートメントのうち 1 つ以上のサービス(無料または有料)がある。宿泊客が施設から外に出ることなくスパに行けることが要件となります。 | はい / いいえ |
hotel_brand |
このホテルが所属するブランド。「Marriott」や「Hilton」などです。これはユーザーには表示されませんが、Google 広告キャンペーンでホテルをグループ化したりホテルアイコンを設定したりするために使用できます。 | 任意の文字列値 |
kitchen_availability |
宿泊客が客室で温かい料理を調理したり、食べ物を冷蔵したりできるキッチンが用意されている。 |
|
number_of_rooms |
このフィールドには、リスティング ID に関連付けられた単位の総数が一覧表示されます。 注: この数値は、料金と在庫フィードのデータに基づく予約単位あたりの料金を表すものではありません。 | 負ではない任意の整数。 |
num_reviews |
リスティングのレビューの数。 | 負ではない任意の整数。 |
parking_type |
駐車場が利用可能かどうか、無料と有料のどちらであるかを示す。 |
|
pets_allowed |
一部またはすべての客室で宿泊客はペット(介助動物ではない犬や猫)を同伴できる。 | はい / いいえ |
rating |
宿泊施設の評価の集計を表す浮動小数点数。 | この数値は、通常は 0~5、0~10、0~100 の範囲ですが、評価システムを表す任意の範囲を使用できます。 |
smoke_free_property |
宿泊施設は全館禁煙である。 | はい / いいえ |
star_rating |
評価機関からリスティングに付けられた星の数。 | 1、2、3、4、5。 |
swimming_pool_type |
宿泊施設で水泳プールが利用可能かどうか、また利用可能である場合はプールのタイプを示す。 |
|
wheelchair_accessible |
この宿泊施設は車椅子対応のバリアフリーである。 | はい / いいえ |
wifi_type |
宿泊施設の全体(特定の区域に限定されない)で使用できる無線インターネット(Wi-Fi)サービスが提供されているかどうかを示す。 無料の場合と利用料金がかかる場合があります。 |
|
民泊の attribute_name プレースホルダの値
以下に、<client_attr name="attribute_name">
要素の attribute_name
に有効な値の一覧を示します。ただし、パートナーはその他独自の attribute_name
を指定してもかまいません。これらの値は民泊施設のみに適用されます。
attribute_name の値 |
必須 | 説明 | 有効なコンテンツの値 |
---|---|---|---|
capacity |
必須 | 宿泊施設で対応可能な宿泊客の最大数。 | 非負整数 |
min_days_between_stays |
省略可(強く推奨) | 前の滞在客が退去した後、空室にする必要がある「バッファ日」の最小数。 | 非負整数 |
enhanced_cleaning_practices |
省略可(強く推奨) | (パートナー サイトに説明を掲載して)宿泊施設で習慣的な清掃が行われているかどうか。 | はい / いいえ |
partner_hygiene_link |
省略可(強く推奨) | リスティングの衛生状態に関する詳細情報を提供する、外部のパートナー サイトへのリンク。 | 自由形式のテキスト(サイトの URL) |
number_of_bathrooms |
省略可(強く推奨) | 浴室の数。 | 負ではない浮動小数点値(1、1.5、2 など) |
number_of_bedrooms |
省略可(強く推奨) | 寝室の数。 | 負ではない整数値 |
number_of_beds |
省略可(強く推奨) | (全部屋の)ベッド数。 | 負ではない整数値 |
self_checkin_checkout |
省略可(強く推奨) | 宿泊施設でセルフ チェックインとセルフ チェックアウトが許可されているかどうか。 | はい / いいえ |
rating_num |
省略可(強く推奨) | 宿泊施設の評価の数。 | 非負整数 |
ac |
任意 | 宿泊施設にエアコンがあるかどうか。 | はい / いいえ |
airport_shuttle |
任意 | ホストが空港などのターミナルとの間で送迎サービスを提供しているかどうか。 | はい / いいえ |
balcony |
任意 | 宿泊施設にバルコニーがあるかどうか。 | はい / いいえ |
beach_access |
任意 | 宿泊施設に近い公共のビーチにアクセスできるかどうか。 | はい / いいえ |
cancellation_policy |
任意 | 自由形式のテキストによる、キャンセル ポリシーの説明。 | 自由形式のテキスト |
cancellation_policy_type |
任意 | パートナーは、任意のタイプのポリシー名を指定できます。Google はパートナーと連携して、Google が推奨するタイプにその名前をマッピングします(カスタムタイプを指定する場合は、5 カテゴリ程度に制限して、タイプの説明をアカウント マネージャーに伝えてください)。 ホストが承諾したキャンセル ポリシーの推奨タイプ:
|
緩 / 中 / 強 / 厳格 / 払い戻しなし |
check_in_time |
任意 | 宿泊施設にチェックインする時刻。 | 自由形式のテキスト |
check_out_time |
任意 | 宿泊施設からチェックアウトする正確な時刻。 | 自由形式のテキスト |
child_friendly |
任意 | 宿泊施設がお子様に適しているかどうか。 | はい / いいえ |
crib |
任意 | 宿泊施設にベビーベッドが用意されているかどうか。 | はい / いいえ |
elevator |
任意 | 宿泊施設にエレベーターがあるかどうか。 | はい / いいえ |
fire_place |
任意 | 宿泊施設に暖炉があるかどうか。 | はい / いいえ |
free_breakfast |
任意 | 宿泊施設で無料の朝食が提供されるかどうか。 | はい / いいえ |
gym_fitness_equipment |
任意 | 宿泊施設にジムやフィットネス設備があるかどうか。 | はい / いいえ |
heating |
任意 | 宿泊施設に暖房があるかどうか。 | |
hot_tub |
任意 | 宿泊施設に温水浴槽があるかどうか。 | はい / いいえ |
instant_bookable |
任意 | 宿泊施設をご購入手続きですぐに予約できるかどうか。代替手段は承認待ちです。 | はい / いいえ |
ironing_board |
任意 | 宿泊施設でアイロン台を利用できるかどうか。 | はい / いいえ |
kitchen |
任意 | 宿泊施設にキッチンがあるかどうか。 | はい / いいえ |
license_num |
任意 | 世界の特定の地域では、宿泊施設のライセンス番号(観光客またはビジネス客向け)を表示する必要があります。これには繰り返しが生じる可能性があります。複数のライセンスが存在する場合は、コンテキストの形でライセンスの当局を追加することをおすすめします(例: 「Paris: 123456ABC」)。 | 自由形式のテキスト |
microwave |
任意 | 宿泊施設で電子レンジを利用できるかどうか。 | はい / いいえ |
minimum_days_advance_purchase |
任意 | 宿泊施設を事前に予約できる最小日数。 | 非負整数 |
minimum_night_stay |
任意 | 宿泊客が宿泊施設を予約できる最小泊数。 | 正の整数(1 以上) |
max_night_stay |
任意 | 宿泊客が宿泊施設を予約できる最大泊数。 | 正の整数(1 以上) |
number_of_living_rooms |
任意 | リビングルームの数。 | 負ではない整数値 |
outdoor_grill |
任意 | 宿泊施設にグリルがあるかどうか。 | はい / いいえ |
oven_stove |
任意 | 宿泊施設にストーブがあるかどうか。 | はい / いいえ |
parking_type |
任意 | 施設で利用可能な駐車場のタイプ。 | 有料 / 無料 / なし |
patio |
任意 | 宿泊施設にパティオがあるかどうか。 | はい / いいえ |
pets_allowed |
任意 | 一部またはすべての客室で宿泊客はペット(介助動物ではない犬や猫)を同伴できる。 | はい / いいえ |
pool_type |
任意 | 宿泊施設で利用できるプールのタイプ(プールへのアクセス)。 | 屋内、屋外、屋内 / 屋外、なし |
private_beach_access |
任意 | 宿泊施設からプライベート ビーチに独占的にアクセスできるかどうか。 | はい / いいえ |
room_type |
任意 | 宿泊施設のタイプ(Google と共有する情報)。 注: 現時点では、全体のみを使用できます。 |
全体、相部屋、個室 |
smoking_free_property |
任意 | 宿泊施設が禁煙であるかどうか。 | はい / いいえ |
square_footage |
任意 | 宿泊施設の面積。 | 負ではない浮動小数点数値 |
tv |
任意 | 宿泊施設にテレビがあるかどうか。 | はい / いいえ |
washer_dryer |
任意 | 宿泊施設に洗濯機があるかどうか。 | はい / いいえ |
wheelchair_accessible |
任意 | 宿泊施設が車椅子対応であるかどうか。 | はい / いいえ |
wifi_type |
任意 | 宿泊施設で提供される Wi-Fi インターネット アクセスの種類。 | 有料 / 無料 / なし |
host_language |
任意 | ホストが話すことができる言語。 | 言語コードのカンマ区切りのリスト(例: de,en) |
民泊の例
<?xml version="1.0" encoding="UTF-8"?> <listings> <language>en</language> <listing> <id>123456</id> <name>Apartment Name</name> <address format="simple"> <component name="addr1">Detailed Address</component> <component name="city">Mountain View</component> <component name="postal_code">94043</component> <component name="province">California</component> </address> <country>US</country> <latitude>37.4182515</latitude> <longitude>-122.0742354</longitude> <location_precision>500<location_precision> <phone type="main">12345678</phone> <category>vacation_villa</category> <date day="21" month="12" year="2017"/> <content> <text type="description"> <link>https://list_url</link> <title>Description Title</title> <body>Description Body</body> </text> <attributes> <website>https://hotel.example.com/123456</website> <client_attr name="capacity">7</client_attr> <client_attr name="cleaning_disinfection">Yes</client_attr> <client_attr name="min_days_between_stays">3</client_attr> <client_attr name="enhanced_cleaning_practices">Yes</client_attr> <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr> <client_attr name="number_of_bathrooms">2</client_attr> <client_attr name="number_of_bedrooms">3</client_attr> <client_attr name="number_of_beds">4</client_attr> <client_attr name="self_checkin_checkout">Yes</client_attr> <client_attr name="rating">4.8</client_attr> <client_attr name="rating_num">5373</client_attr> <client_attr name="ac">Yes</client_attr> <client_attr name="airport_shuttle">Yes</client_attr> <client_attr name="balcony">Yes</client_attr> <client_attr name="beach_access">Yes</client_attr> <client_attr name="cancellation_policy">50% deposit returnable before 4 weeks of arrival date, 100% refundable before 8 weeks of arrival</client_attr> <client_attr name="cancellation_policy_type">Moderate</client_attr> <client_attr name="check_in_time">3pm</client_attr> <client_attr name="check_out_time">11am</client_attr> <client_attr name="child_friendly">Yes</client_attr> <client_attr name="crib">Yes</client_attr> <client_attr name="elevator">Yes</client_attr> <client_attr name="fire_place">Yes</client_attr> <client_attr name="free_breakfast">Yes</client_attr> <client_attr name="gym_fitness_equipment">Yes</client_attr> <client_attr name="heating">Yes</client_attr> <client_attr name="hot_tub">Yes</client_attr> <client_attr name="instant_bookable">Yes</client_attr> <client_attr name="internet_type">Free</client_attr> <client_attr name="ironing_board">Yes</client_attr> <client_attr name="kitchen">Yes</client_attr> <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr> <client_attr name="license_num">Paris: 123456ABC</client_attr> <client_attr name="microwave">Yes</client_attr> <client_attr name="min_days_advance_purchase">2</client_attr> <client_attr name="min_night_stay">3</client_attr> <client_attr name="number_of_living_rooms">1</client_attr> <client_attr name="outdoor_grill">Yes</client_attr> <client_attr name="oven_stove">Yes</client_attr> <client_attr name="parking_type">Free</client_attr> <client_attr name="patio">Yes</client_attr> <client_attr name="pool_type">Indoors</client_attr> <client_attr name="private_beach_access">Yes</client_attr> <client_attr name="refund_policy">Cancellations made after 48 hours but before 24 hours prior to checkin will received a 50% refund</client_attr> <client_attr name="room_type">Entire Place</client_attr> <client_attr name="smoking_free_property">Yes</client_attr> <client_attr name="square_footage">1200</client_attr> <client_attr name="tv">Yes</client_attr> <client_attr name="washer_dryer">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> </attributes> </content> </listing> </listings>
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
画像は、リスティング ID で宿泊施設を表示するために使用されます。使用するすべての画像は、次のガイドラインに従う必要があります。
- 画像の推奨アスペクト比は 4:3 です。
- Googlebot 画像クローラが画像の URL にアクセスできる必要があります。
- サイトのルートレベルに robots.txt が含まれている場合は、下記に示す 2 つのオプションのいずれかが含まれることを確認します。
- Googlebot クローラがサイトのコンテンツ(画像を含む)をクロールできるようにします。
- User-agent: Googlebot
- Allow: /
- Googlebot 画像クローラがサイトの画像をクロールできるようにします。
- User-agent: Googlebot-Image
- Allow: /
- 画像またはウェブサイトのスクリーンショットは許可しません。画像は、オリジナルかつ実物の画像や写真にする必要があります。
属性
属性名 | 必須 | 形式 | 説明 |
---|---|---|---|
type |
必須 | テキスト | 画像には、以下のいずれかを指定する必要があります。
|
url |
必須 | テキスト | フルサイズの画像の URL。url 属性を使用して、そのページで使用する画像を指定します。 |
width |
必須 | 非負整数 | 画像の幅(ピクセル単位、720 ピクセル以上を推奨) |
height |
必須 | 非負整数 | 画像の高さ(ピクセル単位、720 ピクセル以上を推奨) |
子要素
子要素 | 必須 | 説明 |
---|---|---|
<link> |
リクエスト済み、ただしローカルの写真のリスティングに必須。 | このタグには、関連する画像が存在するサイト上のページの、有効かつ最新の URL が含まれます。画像自体の URL は含まれません。
例:<link><http://www.example.com/magic_pizza/></link> |
<title> |
リクエスト済み | このタグには画像のタイトルが含まれます。例:
<title>"Luxury Apartment"</title> |
<author> |
不要 | コンテンツの作成者の名前。値は、ユーザー名か、「名 姓」の形式の氏名で指定します。 |
<date> |
必須 | このタグは、コンテンツ項目が作成された日付を示します。次の例に示すように、年、月、日を入力する必要があります。 <date month="6" day="7" year="2017"/> |
例
次の例に、画像のタグが含まれるホテルリストの一部を示します。
<?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> <content> <review> </review> <attributes> </attributes> <image type="photo" url="https://image_url" width="400" height="300"> <link>https://image_url</link> <title>Apartment at Sandstone</title> <author>Jessica Landlord</author> <date month="6" day="7" year="2017"/> </image> </content> </listing> ... </listings>
構文のガイドライン
XML ベースのホテルリストを作成する場合は、以下のガイドラインを使用します。
- ホテルリストの XML ファイルを検証するには、Google の XSD スキーマを使用します。
- UTF-8 エンコードを使用します。このエンコード スキーマを指定するには、次の例に示すように、XML タグに
encoding
属性を含めます。 CDATA
セクションを使用して、フィード内にデータ値を指定できます。CDATA
セクションを使用する場合は、特殊文字をエスケープ処理しないでください。CDATA
セクションにないデータ値(URL など)には、エスケープ コードを使用します。エンティティ コードまたは文字コードのいずれかを使用して、これらの特殊文字を表すことができます。次の表に、使用できる共通のエンティティ コードと文字コードを示します。
文字 エンティティ 文字コード アンパサンド(&) & & 単一引用符(') ' ' 二重引用符(") " " より大きい(>) > > より小さい(<) < < - データを含まない XML 要素を削除します。たとえば、ホテルに緯度と経度を使用しない場合は、空の
<latitude/>
要素と<longitude/>
要素は含めないでください。 - どのような状況でも(エスケープ処理されている場合であっても)XML 要素で HTML は使用しないでください。
- アップロードの前にフィードを検証するには、ローカル フィード XSD「https://www.gstatic.com/localfeed/local_feed.xsd」を使用します。
- フィードでコメントを使用するには、次の例に示すように、
<!--
タグや-->
タグ内でコメントをラップします。<!-- This is a comment -->
- ユーザー
<review>
の<date>
要素は、必ず閉じてください。たとえば、次のようになります。<date day="2" month="12" year="2017"/>
データの問題を検出して修正する
ホテルリスト内のデータの問題を検出して修正するには、次のツールを使用します。
Hotel Center: