属性

このページでは、属性と子要素の説明、値、要件について説明します。これらの値は民泊施設のみに適用されます。

一般的な XML 構造は、ホテル リスティング フィードと同様の形式です。ホテルリスト XML リファレンスをご覧ください。

以下の必須項目が含まれていない場合、リスティングは自動的に無効になります。

  • 必須の XML 子要素: id、name、latitude、longitude、address。
  • 必須属性: capacity と website。リスティング フィードの民泊施設の直接リンクを参照してください。これにより、ユーザーは宿泊施設のウェブサイトにアクセスできます。

必須の XML 子要素について詳しくは、XML 子要素をご覧ください。

民泊の詳細については、民泊固有の属性をご覧ください。

最後に、Google が他のソースから属性の値が民泊リスティングのフィードで指定されている値と異なると判断した場合、Google はリスティングの値を表示します。たとえば、リスティングの写真からキッチンがあると Google が判断した場合、kitchen 属性がないか No に設定されていても、Google はそのリスティングにキッチンがあるとみなします。これらの属性は「推定属性」と呼ばれ、推定の精度に高い信頼性がある場合にのみ表示されます。

<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 Required レビューのタイプ。次のいずれかの値に設定します。
  • editorial: ウェブサイトまたは他のレビュー機関によるレビュー。
  • user: エンドユーザーによるレビュー。

子要素

<review> 要素には次の子要素があります。

子要素 必須 型 説明
<link> Optional string レビューへのリンク。この要素には「http://」または「https://」を含めます。
<title> Optional string （エディタ レビューのみ）レビューのタイトル。
<author> Optional string レビューの投稿者（例: 「Susan von Trapp」）。レビューにクレジット表記がない場合は、レビューが表示されているウェブサイトやパブリケーションの名前にすることもできます。
<rating> Optional string レビューのスコアを表す 0 ～ 10 の浮動小数点数。例: 「8.9」。
<body> Optional string レビューのテキスト。この要素には HTML を含めないでください。
<date month="MM" day="DD" year="YYYY"/> Optional Object （ユーザー レビューのみ）レビューの日付。この要素の次の属性を使用して指定します。
  • day: 月の日。例: 「7」。
  • month: 月。1 = 1 月、... 12 = 12 月。
  • year: 4 桁の年。例: 「2023」。

たとえば、2023 年 6 月 7 日は次のように記述します。

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object （ユーザー レビューのみ）レビュー投稿者がレビュー対象のリスティングを訪問した日付。形式は <date> と同じです。

たとえば、2023 年 6 月 7 日は次のように記述します。

<servicedate month="6" day="7" year="2023"/>

最低限必要である <servicedate> の年と月が指定されていないレビューは、表示されないことがあります。日は必須ではありません。

例

次の例に、エディタとユーザーのレビューを含むリスティングが含まれるホテルリストの一部を示します。

<?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="2023"/>
      </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="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

attribute_name プレースホルダの値

次の表に、<client_attr name="attribute_name"> 要素の attribute_name に有効な値の一覧を示します。ただし、独自の attribute_name がある場合は、それを提供することをおすすめします。

attribute_name の値 必須 説明 有効なコンテンツの値
capacity Required 宿泊施設で対応可能な宿泊客の最大数。この値は、「number_of_bedrooms」以上である必要があります。 Non-negative integer value
website Required 物件のウェブサイトの URL。 Free text
partner_hygiene_link Strongly recommended リスティングの衛生状態に関する詳細情報を提供する、外部のパートナー サイトへのリンク。 Free text (the site's URL)
number_of_bathrooms Strongly recommended 浴室の数。 Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended 寝室の数。 Non-negative integer value
number_of_beds Strongly recommended 全部屋のベッド数。 Non-negative integer value
self_checkin_checkout Recommended 宿泊施設でセルフ チェックインとセルフ チェックアウトが許可されているかどうか。 Yes/No/Unknown
rating Strongly recommended 宿泊施設の評価の集計を表す浮動小数点数。この数値は、通常は 0 ～ 5、0 ～ 10、0 ～ 100 の範囲ですが、評価システムを表す任意の範囲を使用できます。 Non-negative float value
rating_num Strongly recommended 宿泊施設の評価の数。 Non-negative integer value
rating_scale Strongly recommended 宿泊施設の最大評価。たとえば、rating_scale が 5 の場合、プロパティの rating は 3 または 4 にする必要があります。

注: 指定しない場合、デフォルトの rating_scale は 0 ～ 10 です。

 Non-negative integer value
instant_bookable Strongly recommended 宿泊施設をご購入手続きですぐに予約できるかどうか。代替手段は承認待ちです。 Yes/No/Unknown
description Strongly recommended プロパティの固有の特性を説明する自由形式のテキスト Free text
category Strongly recommended ヴィラ、バンガロー、キャビン、アパートなどの宿泊施設のタイプ Free text
ac Recommended 宿泊施設にエアコンがあるかどうか。 Yes/No/Unknown
beach_access Recommended 宿泊施設の近くに公共のビーチがあるかどうか。 Yes/No/Unknown
check_in_time Recommended 宿泊施設にチェックインする正確な時刻。HHMM、HH:MM、HH:MM:SS 形式を使用します。たとえば、午後 2 時または午後 2 時 0 分ではなく、14:00 を使用します。その他の形式は解析されず、表示されません。 Time
check_out_time Recommended 宿泊施設からチェックアウトする正確な時刻。HHMM、HH:MM、HH:MM:SS 形式を使用できます。たとえば、11am や 11:00am ではなく 11:00 を使用します。その他の形式は解析されず、表示されません。 Time
child_friendly Recommended 宿泊施設がお子様に適しているかどうか。 Yes/No/Unknown
crib Recommended 宿泊施設にベビーベッドが用意されているかどうか。 Yes/No/Unknown
elevator Recommended 宿泊施設にエレベーターがあるかどうか。 Yes/No/Unknown
gym_fitness_equipment Recommended 宿泊施設にジムやフィットネス設備があるかどうか。 Yes/No/Unknown
heating Recommended 宿泊施設に暖房があるかどうか。 Yes/No/Unknown
hot_tub Recommended 宿泊施設に温水浴槽があるかどうか。 Yes/No/Unknown
ironing_board Recommended 宿泊施設でアイロン台を利用できるかどうか。 Yes/No/Unknown
kitchen Recommended 宿泊施設にキッチンがあるかどうか。 Yes/No/Unknown
microwave Recommended 宿泊施設で電子レンジを利用できるかどうか。 Yes/No/Unknown
min_days_advance_purchase Recommended 宿泊施設を事前に予約できる最小日数。 Non-negative integer value
min_night_stay Recommended 宿泊客が宿泊施設を予約できる最小泊数。 Positive integer (more than zero)
max_night_stay Recommended 宿泊客が宿泊施設を予約できる最大泊数。 Positive integer (more than zero)
outdoor_grill Recommended 宿泊施設にグリルがあるかどうか。 Yes/No/Unknown
oven_stove Recommended 宿泊施設にストーブがあるかどうか。 Yes/No/Unknown
parking_type Recommended 施設で利用可能な駐車場のタイプ。 Free/Paid/None
patio Recommended 宿泊施設にテラスがあるかどうか。 Yes/No/Unknown
pets_allowed Recommended 一部またはすべての客室で宿泊客はペット（介助動物ではない犬や猫）を同伴できる。 Yes/No/Unknown
pool_type Recommended 宿泊施設で利用できるプールのタイプ（プールへのアクセス）。 Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended 部屋のタイプ。サポートされる値は ENTIRE_PLACE のみです。 ENTIRE_PLACE
smoking_free_property Recommended 宿泊施設が禁煙であるかどうか。 Yes/No/Unknown
special_service_level Recommended リスティングのサービスレベルが特別なものかどうか。例: verified、luxury、premium Yes/No/Unknown
square_footage Recommended 宿泊施設の面積（平方フィート）。 Non-negative float value
square_meters Recommended 宿泊施設の面積（平方メートル）。 Non-negative float
tv Recommended 宿泊施設にテレビがあるかどうか。 Yes/No/Unknown
washer_dryer Recommended 宿泊施設に洗濯機があるかどうか。 Yes/No/Unknown
wheelchair_accessible Recommended 宿泊施設が車椅子対応であるかどうか。 Yes/No/Unknown
internet_type Recommended 宿泊施設で提供される Wi-Fi インターネット アクセスの種類。 Free/Paid/None
airport_shuttle Optional 空港や他のターミナルへの送迎を提供するかどうか。 Yes/No/Unknown
balcony Optional 宿泊施設にバルコニーがあるかどうか。 Yes/No/Unknown
fire_place Optional 宿泊施設に暖炉があるかどうか。 Yes/No/Unknown
free_breakfast Optional 宿泊施設で無料の朝食が提供されるかどうか。 Yes/No/Unknown
host_description Optional 民泊施設のホストの説明。 Free text
host_language Optional ホストが話すことができる言語。 言語コードのカンマ区切りのリスト（例: de、en）
host_name Optional 民泊ホストの名前。 Free text
host_response_rate Optional ホストの平均返信率。 Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional ホストの平均応答時間。 Free text
license_num Optional 世界の特定の地域では、宿泊施設のライセンス番号（観光客またはビジネス客向け）を表示する必要があります。これには繰り返しが生じる可能性があります。複数のライセンスが存在する場合は、コンテキストの形でライセンスの当局を追加することをおすすめします（例: 「Paris: 123456ABC」）。 Free text
number_of_half_bathrooms Optional ハーフバスルームの数。 Non-negative integer value
number_of_living_rooms Optional リビングルームの数。 Non-negative integer value
private_beach_access Optional 宿泊施設に専用のプライベート ビーチがあるかどうか。 Yes/No/Unknown
refund_policy Optional プロパティの払い戻しポリシー。 Free text

XML 子要素

次の XML 子要素が必要です。

子要素 必須 型 説明
<country> Strongly recommended string このリスティングが存在する国。値は ISO 3116 の 2 文字の国コードで指定する必要があります。たとえば、米国は US、カナダは CA です。
    <country>US</country>
<id> Required string 宿泊施設の一意の識別子。各バケーション レンタルには、サイトに固有の ID が必要です。また、この ID は絶対に再利用しないでください。
<latitude> Required float ホテル所在地の緯度。次に例を示します。
    <latitude>37.423738</latitude>

この値は、Google Maps API などの GeoCoding ツールを使用して生成できます。
<longitude> Required float ホテル所在地の経度。次に例を示します。
    <longitude>-122.090101</longitude>

この値は、Google Maps API などの GeoCoding ツールを使用して生成できます。
<name> Required string プロパティの名前。最大 300 文字。
<address> Required string or Object

宿泊施設の正式な物理的所在地（文字列）。住所には町名と番地を含める必要があります。存在しない場合は、住所にプラスコードを含める必要があります。該当する場合は、建物名、部屋番号も含めます。

または、「複合」住所を指定することもできます。<component> 子要素を使用して、住所の次の各部分を記述します。

  • addr1: メインの番地。
  • addr2: 必要な場合は、部屋番号を含む 2 番目の番地。
  • city: 都市。
  • province: 必要に応じて、州、地域、都道府県。
  • postal_code: 郵便番号。
  • country: 国。

私書箱や郵便物受け取り専用住所は、正式な物理的住所とは見なされません。

完全な住所の例を次に示します。

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

プラスコードを使用した完全な住所の例を次に示します。

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

次の点に注意してください。

  • 冗長な情報: 無関係な情報を含めたり、住所の構成要素を繰り返したりしないでください。
  • 町名と番地が記載されていない: 住所には町名と番地が必要です。
の <date> 要素を閉じていることを確認してください。

民泊リスティングの例

<?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">18733 Clark Way</component>
      <component name="addr2">#C10</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>
    <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>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</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/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="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</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="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</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">No</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="max_night_stay">7</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">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">ENTIRE_PLACE</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</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>