이 페이지에서는 속성 및 하위 요소의 설명, 값, 요구사항을 설명합니다. 이 값은 공유숙박 속성에만 적용됩니다.
일반적인 XML 구조는 호텔 등록정보 피드와 형식이 유사합니다. 호텔 목록 XML 참조를 참고하세요.
다음 필수 항목을 포함하지 않으면 등록정보가 자동으로 사용 중지됩니다.
- 필수 XML 하위 요소:
id
,name
,latitude
,longitude
,address
- 필수 속성:
capacity
및website
등록정보 피드의 공유숙박 직접 링크를 참고하세요. 이를 통해 사용자는 숙박 시설 웹사이트를 방문할 수 있습니다.
필수 XML 하위 요소에 관한 자세한 내용은 XML 하위 요소를 참고하세요.
공유숙박에 관한 자세한 내용은 공유숙박 고유 속성을 참고하세요.
마지막으로 Google이 다른 소스에서 속성 값이 공유숙박 등록정보의 피드에 지정된 값과 다르다고 판단하면 Google은 등록정보 값을 표시합니다. 예를 들어 Google이 비즈니스 정보의 사진에서
주방이 있다고 판단하지만 kitchen
속성이 없거나 No
로 설정된 경우
Google은 비즈니스 정보가 주방인 것으로 간주됩니다. 이러한 속성을 '추론된 속성'이라고 하며 추론 정확성에 대한 신뢰도가 높은 경우에만 표시됩니다.
attribute_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 형식이 허용됩니다. 예를 들어 오후 2시나 2:00시 대신 14:00을 사용하세요. 다른 모든 형식은 파싱되거나 표시되지 않습니다. | Time |
check_out_time | Recommended | 숙박 시설에서 체크아웃하는 정확한 시간입니다. HHMM, HH:MM 또는 HH:MM:SS 형식이 허용됩니다. 예를 들어 오전 11시나 오전 11시 대신 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 |
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 | 욕실 5개 수 | 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 | 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="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>