이 페이지는 Cloud Translation API를 통해 번역되었습니다.

속성

이 페이지에서는 속성 및 하위 요소에 대한 설명, 값, 요구사항을 설명합니다. 이 값은 공유숙박 속성에만 적용됩니다.

일반적인 XML 구조는 호텔 등록정보 피드와 형식이 유사합니다. 호텔 목록 XML 참조를 확인하세요.

다음 필수 항목이 포함되지 않으면 등록정보가 자동으로 사용 중지됩니다.

필수 XML 하위 요소: id, name, latitude, longitude, address
필수 속성: capacity 및 website
- 등록정보 피드에서 속성으로 직접 연결되는 웹사이트 링크를 참조하세요. 이렇게 하면 사용자가 속성 웹사이트를 방문할 수 있습니다.

필수 XML 하위 요소에 관한 자세한 내용은 XML 하위 요소를 참고하세요.

공유숙박에 대한 자세한 내용은 공유숙박의 고유한 속성을 참고하세요.

마지막으로 Google이 다른 소스에서 속성 값이 공유숙박 등록정보의 피드에 지정된 값과 다르다고 판단하면 등록정보 값을 표시합니다. 예를 들어 비즈니스 정보 사진에서 키친이 있는 것으로 확인되었지만 kitchen 속성이 없거나 No로 설정된 경우 키친이 있는 비즈니스 정보로 간주합니다. 이러한 속성을 '추론된 속성'이라고 하며, 추론의 정확성이 매우 확신하는 경우에만 표시됩니다.

attribute_name 자리표시자 값

다음 표에는 <client_attr name="attribute_name"> 요소의 attribute_name에 유효한 값 목록이 나와 있습니다. 하지만 가능한 경우 attribute_name를 추가로 제공하는 것이 좋습니다.

`attribute_name` 값	필수 여부	설명	유효한 콘텐츠 값
capacity	Required	숙박 시설에 수용할 수 있는 최대 투숙객 수 이 값은 '침실_수' 이상이어야 합니다.	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시 대신 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	투숙객 1명이 숙박 시설을 예약할 수 있는 최대 숙박 일수입니다.	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	욕실 절반의 개수입니다.	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 지도 API와 같은 GeoCoding 도구를 사용하여 생성할 수 있습니다.
<longitude>	Required	float	목록의 위치에 해당하는 경도입니다. 예를 들면 다음과 같습니다. <longitude>-122.090101</longitude> 이 값은 Google 지도 API와 같은 GeoCoding 도구를 사용하여 생성할 수 있습니다.
<name>	Required	string	속성의 이름입니다. 최대 300자(영문 기준)
<address>	Required	Object or string	매물의 실제 위치입니다. 이 요소는 단일 속성 `format`를 사용하며, 이 속성은 `simple`로 설정해야 합니다. 최소한 숙박 시설의 상세 주소, 도시, 주/도, 지역, 우편번호는 제공해야 합니다. `<component>` 하위 요소를 사용하여 주소의 다음 각 부분을 설명합니다. `addr1`: 숙박 시설의 기본 상세 주소입니다. `addr2`: 필요한 경우 번지를 포함한 보조 상세 주소 `addr3`: 상세 주소의 세 번째 부분입니다. `city`: 숙박 시설이 있는 도시의 이름입니다. `province`: 속성의 주, 지역 또는 도 이름입니다. `postal_code`: 숙박 시설의 우편번호입니다. 예를 들면 다음과 같습니다. <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>