이 페이지에서는 속성 및 하위 요소의 설명, 값, 요구사항을 다룹니다. 이 값은 공유숙박 속성에만 적용됩니다.
일반적인 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 | 리뷰 유형입니다. 다음 값 중 하나로 설정합니다.
|
하위 요소
<review> 요소에는 다음과 같은 하위 요소가 있습니다.
| 하위 요소 | 필수 여부 | 유형 | 설명 |
|---|---|---|---|
| <link> | Optional | string | 리뷰 링크 이 요소에 'http://' 또는 'https://'를 포함합니다. |
| <title> | Optional | string | (편집자 리뷰만 해당) 리뷰 제목입니다. |
| <author> | Optional | string | 리뷰 작성자입니다(예: '수잔 폰 트랩'). 크레딧이 없는 경우 리뷰가 표시되는 웹사이트 또는 출판물의 이름일 수도 있습니다. |
| <rating> | Optional | string | 리뷰 점수를 나타내는 0~10 (포함)의 부동 소수점 숫자입니다. 예: '8.9' |
| <body> | Optional | string | 리뷰 텍스트입니다. 이 요소에는 HTML이 포함되어서는 안 됩니다. |
| <date month="MM" day="DD" year="YYYY"/> | Optional | Object | (사용자 리뷰만 해당) 리뷰 날짜입니다. 이 요소의 다음 속성으로 지정합니다.
예를 들어 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인 경우 속성 등급은 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: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 |
| 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 | 숙박 시설에 TV가 있는지 여부. | 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 | 숙박 시설의 전체 실제 위치입니다(문자열). 주소에는 도로명과 번호가 포함되어야 합니다. 주소에 플러스 코드가 포함되어야 합니다. 해당하는 경우 아파트 동호수도 포함해야 합니다. 또는 '복합' 주소를 제공할 수 있습니다.
사서함 또는 기타 우편 전용 주소는 완전한 실제 주소로 간주되지 않습니다. 다음은 완전한 주소의 예입니다. <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> 다음은 피하세요.
|
공유숙박 등록정보 예
<?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>