Attributes

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

일반적인 XML 구조는 호텔 등록정보 피드와 유사한 형식을 갖습니다. 호텔 목록 XML 참조를 참고하세요.

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

  • 필수 XML 하위 요소: id, name, latitude, longitude, address
  • 필수 속성: capacity 및 website 등록정보 피드의 공유숙박 직접 링크를 참고하세요. 이렇게 하면 사용자가 숙박 시설 웹사이트를 방문할 수 있습니다.

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

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

마지막으로 Google에서 다른 소스를 통해 속성의 값이 공유숙박 등록정보 피드에 지정된 값과 다르다고 판단하면 등록정보의 값을 표시합니다. 예를 들어 Google이 등록정보의 사진에서 주방이 있다고 판단했지만 kitchen 속성이 없거나 No로 설정된 경우 Google은 등록정보에 주방이 있다고 간주합니다. 이러한 속성을 '추론된 속성'이라고 하며 추론 정확성에 대한 신뢰도가 높은 경우에만 표시됩니다.

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시 00분 대신 14:00을 사용하세요. 다른 모든 형식은 파싱되거나 표시되지 않습니다. Time
check_out_time Recommended 숙박 시설에서 체크아웃하는 정확한 시간입니다. HHMM, HH:MM 또는 HH:MM:SS 형식이 허용됩니다. 예를 들어 오전 11시 또는 오전 11시 00분 대신 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 전 세계 일부 지역의 숙박 시설에 대해 표시해야 하는 라이선스 번호 (관광 또는 비즈니스)입니다. 라이선스 번호는 반복될 수 있으며 라이선스가 여러 개인 경우 라이선스 권한을 환경설정에 추가하는 것이 좋습니다(예: '파리: 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: 필요한 경우 아파트 동호수를 포함한 보조 상세 주소입니다.
  • 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>

다음은 피하세요.

  • 중복 정보: 불필요한 정보나 주소 구성요소를 반복해서 포함하지 마세요.
  • 도로 주소 누락: 주소에는 도로명과 번지가 있어야 합니다.

공유숙박 등록정보 예

<?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>