このページでは、属性と子要素の説明、値、要件について説明します。これらの値は民泊施設にのみ適用されます。
一般的な XML 構造はホテル リスティング フィードと同様の形式です。ホテルリスト XML リファレンスをご覧ください。
次の必須項目を含めない場合、リスティングは自動的に無効になります。
- 必須の XML 子要素:
id、name、latitude、longitude、address。 - 必須属性:
capacityとwebsite。- リスティング フィードのプロパティへの直接ウェブサイト リンクをご覧ください。これにより、ユーザーが宿泊施設のウェブサイトにアクセスする機会が得られます。
必須の XML 子要素の詳細については、XML 子要素をご覧ください。
民泊について詳しくは、民泊に固有の属性をご覧ください。
最後に、属性の値が民泊リスティングのフィードで指定されているものと異なることが他の情報源から判断された場合、リスティングの値が表示されます。たとえば、リスティングの写真からキッチンがあるものの、kitchen 属性が存在しないか No に設定されている場合、そのリスティングはキッチンがあるものとして扱われます。これらの属性は「推定属性」と呼ばれ、推論の精度に非常に自信がある場合にのみ表示されます。
属性 name プレースホルダの値
次の表に、<client_attr name="attribute_name"> 要素の attribute_name に有効な値の一覧を示します。ただし、可能であれば、追加の attribute_name を指定することをおすすめします。
attribute_name の値 |
必須かどうか | 説明 | 有効なコンテンツの値 |
|---|---|---|---|
| capacity | Required | 宿泊施設の収容人数の上限。この値は「number_of_rooms」以上にする必要があります。 | 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 | 宿泊施設に対して設定可能な最高評価 | 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 の形式を使用できます。たとえば、2pm や 2:00pm ではなく 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 |
| minimum_days_advance_purchase | Recommended | 宿泊施設を予約できる最短の日数。 | Non-negative integer value |
| minimum_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 |
| 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 文字（全角 150 文字）以内。 |
| <address> | Required | Object or string | 宿泊施設の物理的な場所。 この要素は単一の属性 少なくとも、宿泊施設の番地、市区町村、都道府県、地域、郵便番号を指定する必要があります。
次に例を示します。 <address format="simple"> <component name="addr1">6 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>6 Elm Ave Unit 3, Boston, MA, 02472</address> 私書箱や郵便物受け取り専用住所は、正式な物理的住所とは見なされません。 |
民泊リスティングの例
<?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="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="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="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="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="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>