호텔 목록 XML 참조

호텔 목록은 가격 정보를 제공할 모든 호텔을 나열하는 하나 이상의 XML 파일입니다. 호텔 목록 파일 자체에는 가격 정보가 포함되지 않습니다.

호텔 목록의 루트 요소는 숙박 시설을 설명하는 <listing> 요소가 포함된 <listings> 요소입니다.

초기 구현의 일부로 호텔 목록을 만든 다음 정기 유지보수의 일환으로 호텔 목록에서 호텔을 추가하거나 삭제합니다.

파일이 구문 가이드라인을 준수하는지 확인합니다. 예를 들어 UTF-8 인코딩을 사용하고 XML 태그에 encoding 속성을 포함하여 이 인코딩 스키마를 지정합니다.

호텔 목록을 만든 후 Hotel Center를 사용하여 Google에 직접 업로드하거나 서버에서 호스팅할 수 있습니다.

데이터 문제 찾기 및 해결하기

호텔 목록에서 데이터 문제를 찾아 해결하려면 다음 도움말을 참고하세요.

등록정보 요구사항

Google 호텔 광고를 게재하려면 호텔 목록의 숙박 시설에 다음이 포함되어야 합니다.

  • 투숙객이 머물 수 있는 객실
  • 대중에게 개방되어 있는 물리적으로 존재하는 고정된 위치
  • 고정 벽 및 배관
  • 최소 숙박 일수 7일 이하

부적격 숙박 시설의 일반적인 예로는 일반적으로 Listing requirements 기준을 충족하지 않는 크루즈와 아파트가 있습니다.

캠핑 통나무집 및 고정 벽, 배관 및 실내 온도 조절기 (장작 난로 또는 프로판 히터 포함)가 있는 기타 캠핑 시설은 대상입니다. 요건을 충족하지 않는 야외 숙박 시설은 다음과 같습니다.

  • 투숙객이 텐트를 칠 수 있는 캠핑장
  • 투숙객이 개인 RV를 가지고 오는 오토 캠핑장

<listings>

<listings>는 호텔 목록의 루트 요소로 <language> 요소와 하나 이상의 <listing>를 포함합니다.

<listings> 요소는 호텔 목록 XML 계층 구조의 다음 위치에 표시됩니다.

+ <listings>
    + <language>
    + <datum>
    + <listing>

문법

<listings> 요소는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language> language_code</language>
  <datum> datum_code </datum>
  <listing> listing</listing>
  ...
</listings>

속성

<listings> 요소는 다음과 같은 속성을 포함합니다.

속성 필수 여부 설명
xmlns:xsi 필수 http://www.w3.org/2001/XMLSchema-instance로 설정합니다.
xsi:noNamespaceSchemaLocation 필수 http://www.gstatic.com/localfeed/local_feed.xsd로 설정합니다.

하위 요소

<listings> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소 필수 여부 유형 설명
<language> Required string 피드가 작성된 언어입니다. 이 요소의 값을 2글자 언어 코드로 설정합니다. 예를 들어 영어의 경우 en입니다.
<datum> Optional enum 이 요소는 피드에서 제공된 위도/경도 좌표의 측지 데이터 또는 참조 모델을 지정합니다. 데이터 값이 제공되지 않으면 이 요소의 기본값은 WGS84이며 대부분의 최신 GPS 기기에서 사용됩니다. 도쿄 데이터는 일본의 주소에만 적용됩니다.

이 요소에 유효한 값은 다음과 같습니다.

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
참고: 기본값 WGS84을 사용하려면 호텔 목록에 <datum> 요소를 포함하지 마세요.
<listing> Required <listing> 피드의 각 호텔을 설명하는 하나 이상의 항목입니다. 목록의 각 호텔에는 사이트에 고유한 ID가 있어야 하며 이 ID는 재사용해서는 안 됩니다.

예시

구조화된 주소

다음 예는 구조화된 주소가 포함된 일부 호텔 목록을 보여줍니다.

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <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>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

자유 형식 주소

다음 예는 자유 형식 주소가 사용된 일부 호텔 목록을 보여줍니다.

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

선택적 콘텐츠

다음 예는 선택사항인 <content>가 포함된 등록정보가 있는 일부 호텔 목록을 보여줍니다.

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

<listing>

호텔 목록 <listings> 요소 내의 호텔 정의입니다.

<listing> 요소는 호텔 목록 피드 XML 계층 구조의 다음 위치에 표시됩니다.

+ <listings>
    + <language>
    + <listing>

문법

<listing> 요소는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <!-- Specify <listing>'s child elements in the order shown below. -->
    <id>hotel_ID</id>
    <name>hotel_name</name>
    <address>
      <component name="addr1">street_address_1</component>
      <component name="addr2">street_address_2</component>
      <component name="city">city_name</component>
      <component name="province">province_name</component>
      <component name="postal_code">postal_code</component>
    </address>
    <!-- You can also define an address freeform, although this is not recommended: -->
    <!-- <address>freeform_address</address> -->

    <country>country_code</country>
    <latitude>hotel_latitude</latitude>
    <longitude>hotel_longitude</longitude>
    <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>content</content>
  </listing>
</listings>

속성

<listing> 요소에 속성이 없습니다.

하위 요소

<listing> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소 필수 여부 유형 설명
<id> Required string 호텔의 고유 식별자입니다.

참고: 이 값은 항상 사이트에 대해 고유해야 합니다. ID를 재사용하지 마세요. 속성 일치 문제를 해결하려고 할 때 문제가 발생할 수 있습니다.

<name> Required string 호텔의 이름입니다. 예를 들면 다음과 같습니다.
<name>Belgrave House</name>
<address> Required Object or string

호텔의 실제 위치입니다.

이 요소는 format라는 단일 속성을 사용하며, 이 속성을 simple로 설정해야 합니다.

최소한 호텔의 상세 주소, 도시, 주 또는 지역, 우편번호는 제공해야 합니다. <component> 하위 요소를 사용하여 주소의 다음 각 부분을 설명합니다.

  • addr1: 호텔의 기본 상세 주소입니다.
  • addr2: 필요한 경우 보조 상세 주소입니다.
  • addr3: 필요한 경우 상세 주소의 3분의 1입니다.
  • 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, Boston, MA, 02472</address>

참고: 사서함 또는 기타 우편 전용 주소는 완전한 실제 주소로 간주되지 않습니다.

<country> Required string 이 등록정보가 위치한 국가입니다. 값은 2자리 국가 코드여야 합니다. 예를 들어 미국은 'US'이고 캐나다는 'CA'입니다. 예를 들면 다음과 같습니다.
<country>US</country>
<latitude> Required* float 목록의 위치에 해당하는 위도입니다. 예를 들면 다음과 같습니다.
<latitude>37.423738</latitude>

이 값은 Google 지도 API와 같은 GeoCoding 도구를 사용하여 생성할 수 있습니다.

<longitude> Required* float 목록의 위치에 해당하는 경도입니다. 예를 들면 다음과 같습니다.
<longitude>-122.090101</longitude>

이 값은 Google 지도 API와 같은 GeoCoding 도구를 사용하여 생성할 수 있습니다.

<location_precision> Optional integer 속성 위도와 경도가 난독화된 경우 미터 단위로 전송된 속성 위치의 정밀도입니다. 0은 난독화가 없으며 정확한 위치임을 의미합니다. 참고: 이 요소는 공유숙박에만 적용됩니다.
<phone> Required* string

호텔의 연락처 전화번호 중 하나 이상입니다. 비즈니스 지점인 경우 중앙 본사의 전화번호가 아닌 지점 위치의 전화번호를 제공하세요.

type 속성은 다음 중 하나일 수 있습니다.

  • fax: 팩스 전화번호입니다.
  • main: 기본 음성 전화번호입니다.
  • mobile: 휴대전화 번호입니다.
  • tdd: 청각 장애인을 위한 통신 기기 (TDD) 전화번호입니다.
  • tollfree: 수신자 부담 전화번호입니다.

예를 들면 다음과 같습니다.

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

최소한 main 유형을 제공해야 합니다.

<category> Optional string 숙박 시설 유형(예: 호텔) 파트너는 숙박 시설을 설명하는 데 필요한 모든 내부 카테고리(예: '비즈니스 호텔', '리조트', '모텔' 등)를 사용할 수 있습니다.
<content> Optional <content> 설명, 평점, 속성 등 목록에 사용되는 세부정보입니다(선택사항).

* 전화번호 또는 위도/경도가 필요합니다. 둘 다 정의하는 것이 좋습니다.

예시

구조화된 주소

다음 예는 구조화된 주소가 포함된 일부 호텔 목록을 보여줍니다.

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <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>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

자유 형식 주소

다음 예는 자유 형식 주소가 사용된 일부 호텔 목록을 보여줍니다.

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

선택적 콘텐츠

다음 예는 선택사항인 <content>가 포함된 등록정보가 있는 일부 호텔 목록을 보여줍니다.

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

<content>

평점 및 리뷰, 편의시설, 기타 세부정보와 같은 등록정보에 관한 정보를 추가합니다. <content> 요소는 선택사항입니다. <content> 내에서 모든 하위 요소는 선택사항입니다.

<content> 요소는 호텔 목록 피드 XML 계층 구조의 다음 위치에 표시됩니다.

+ <listings>
    + <language>
    + <listing>
        + <content>

문법

<content> 요소는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      <!-- Specify <text>'s child elements in the order shown below. -->
      <text type="description">
        <link>listing_link</link>
        <title>listing_title</title>
        <author>listing_author</author>
        <body>listing_description</body>
        <date month="MM" day="DD" year="YYYY"/>
      </text>
      <!-- 0 or more reviews: -->
      <review type="[editorial|user]">
        ...
      </review>
      <!-- 0 or more attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="custom_0">custom_attribute_0</client_attr>
        <client_attr name="custom_1">custom_attribute_1</client_attr>
        <client_attr name="custom_2">custom_attribute_2</client_attr>
        <client_attr name="custom_3">custom_attribute_3</client_attr>
        <client_attr name="custom_4">custom_attribute_4</client_attr>
        <client_attr name="hotel_brand">hotel_brand</client_attr>
        <client_attr name="num_reviews">number_of_reviews</client_attr>
        <client_attr name="rating">aggregate_rating</client_attr>
      </attributes>
      <!-- a picture of the hotel or property-->
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main Hotel Picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

속성

<content> 요소에 속성이 없습니다.

하위 요소

<content> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소 필수 여부 유형 설명
<text type="description"> Optional Object

제공업체의 비즈니스 정보와 연결된 웹페이지입니다. 다음 하위 요소를 포함합니다.

  • <link>: 설명의 링크입니다. 이 요소에는 'http://' 또는
    'https://'가 포함됩니다 (선택사항).
  • <title>: 설명의 제목입니다(선택사항).
  • <author>: 설명의 작성자입니다(선택사항).
  • <body>: 설명의 본문입니다(필수).
  • <date>: 설명의 날짜입니다 (선택사항).
  • 참고: 이러한 요소는 위의 순서대로 표시되어야 합니다.

<review type="[editorial|user]"> Optional <review>

비즈니스 정보의 사용자 리뷰 또는 전문가 리뷰가 포함됩니다. 비즈니스 정보에는 두 유형의 리뷰가 여러 개 포함될 수 있습니다.

<listing> 요소에 숙박 시설에 대한 모든 리뷰를 포함할 필요는 없습니다. 이 요소는 등록정보의 기능이나 품질을 설명하는 선택된 리뷰를 포함하기 위한 것입니다.

<attributes> Optional Object

속성에 관한 세부정보를 제공하는 <client_attr> 하위 요소를 0개 이상 포함합니다. 하위 요소는 다음 구문을 사용합니다.

<client_attr name="attribute_name">attribute_value<client_attr>

하위 요소의 목록과 설명은 <attributes>를 참고하세요.

모든 <client_attr> 요소는 선택사항입니다.

<website> 하위 요소가 있는 경우 이 요소는 <client_attr> 요소 앞에 배치되어야 합니다.

<image> Optional Object 자세한 이미지 정보가 포함된 반복되는 태그입니다.

다음 예는 <content> 요소가 포함된 일부 호텔 목록을 보여줍니다.

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

<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 리뷰 유형입니다. 다음 값 중 하나로 설정합니다.
  • editorial: 웹사이트 또는 기타 검토 기관의 리뷰입니다.
  • user: 최종 사용자의 리뷰입니다.

하위 요소

<review> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소 필수 여부 유형 설명
<link> Optional string 리뷰 링크 이 요소에는 'http://' 또는 'https://'가 포함됩니다.
<title> Optional string (전문가 리뷰만 해당) 리뷰의 제목입니다.
<author> Optional string 리뷰 작성자입니다(예: 'Susan von Trapp'). 신용을 받지 않은 경우 리뷰가 표시되는 웹사이트 또는 간행물의 이름일 수도 있습니다.
<rating> Optional string 리뷰 점수를 나타내는 0~10의 부동 소수점 숫자입니다. 예: '8.9'
<body> Optional string 리뷰 텍스트입니다. 이 요소에 HTML이 포함되어서는 안 됩니다.
<date month="MM" day="DD" year="YYYY"/> Optional Object (사용자 리뷰만 해당) 이 요소의 다음 속성을 사용하여 지정하는 리뷰 날짜입니다.
  • day: 일(예: '7')
  • month: 월(1 = 1월 ... 12 = 12월)
  • year: 4자리 연도입니다(예: '2023').

예를 들어 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>의 연도와 월이 포함되지 않은 리뷰는 표시되지 않을 수 있습니다. 요일은 필요하지 않습니다.

<title>은 리뷰의 typeeditorial인 경우에만 <review>의 유효한 하위 요소입니다. <date>typeuser인 경우에만 유효합니다.

다음 예는 비광고 및 사용자 리뷰가 포함된 등록정보가 포함된 일부 호텔 목록을 보여줍니다.

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

<attributes>

<attributes> 태그는 숙박 시설 편의시설을 설명하고 숙박 시설의 평점 및 리뷰를 분류하는 데 사용할 수 있습니다.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>

하위 요소

하위 요소 필수 여부 설명
<website> Optional 호텔의 기본 웹사이트입니다. 있는 경우 첫 번째 <client_attr> 요소 앞에 배치해야 합니다. 예:
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional 지원되는 attribute_name 또는 공유숙박의 attribute_name를 사용하여 지정할 수 있는 숙박 시설의 추가 특성 또는 '속성'입니다.

attribute_name 자리표시자 값

다음 표에는 <client_attr name="attribute_name"> 요소의 attribute_name에 유효한 값이 나와 있습니다.

attribute_name 설명 유효한 콘텐츠 값
alternate_hotel_id 숙박 시설의 대체 식별자입니다. 별도의 ID가 있으면 피드 정보에 하나의 숙박 시설 식별자가 필요하고 예약 엔진에 다른 숙박 시설 식별자가 필요할 수도 있습니다. 모든 문자열 값
custom_[0-4] 모든 문자열 유형의 맞춤 속성입니다. 사용자에게는 표시되지 않습니다. 모든 문자열 값
hotel_brand 이 호텔이 속한 브랜드입니다. 예: '메리어트' 또는 '힐튼' 사용자에게는 표시되지 않지만 호텔 그룹화에 사용할 수 있습니다. 모든 문자열 값
lodging Lodging proto에서 사용할 수 있는 모든 필드의 인코딩된 표현입니다. 인코딩된 Lodging proto의 Base64로 인코딩된 문자열
num_reviews 비즈니스 정보의 리뷰 수입니다. 음수가 아닌 모든 정수입니다.
rating 숙박 시설의 누계 평점을 나타내는 부동 소수점 수입니다. 이 숫자는 일반적으로 0~5, 0~10 또는 0~100이지만 평가 시스템을 나타내는 모든 범위를 사용할 수 있습니다.

공유숙박의 attribute_name 자리표시자 값

공유숙박 관련 속성 및 XML 예를 참고하세요.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>
            + <image>

이미지는 등록정보 ID에 숙박 시설을 표시하는 데 사용됩니다. 사용된 모든 이미지는 다음 가이드라인을 준수해야 합니다.

  • 이미지의 권장 가로세로 비율은 4:3입니다.
  • 이미지 URL은 Googlebot 이미지 크롤러가 액세스할 수 있어야 합니다.
  • 사이트에 루트 수준의 robots.txt가 포함되어 있으면 아래의 두 옵션 중 하나가 포함되어 있는지 확인합니다.

    1. Googlebot 크롤러가 사이트의 콘텐츠(이미지 포함)를 크롤링할 수 있도록 허용합니다.

      • User-agent: Googlebot
      • Allow: /
    2. Googlebot 이미지 크롤러가 사이트의 이미지를 크롤링할 수 있도록 허용합니다.

      • User-agent: Googlebot-Image
      • Allow: /
  • 이미지나 웹사이트의 스크린샷은 허용되지 않습니다. 이미지는 원본이며 실제 이미지 또는 사진이어야 합니다.

속성

  • "ad"(이미지가 광고인 경우)
  • "menu"(이미지가 음식점 메뉴인 경우)
  • "photo": 이미지가 비즈니스의 사진인 경우
속성 이름 필수 여부 형식 설명
type Required Text

이미지는 다음 중 하나여야 합니다.

url Required Text 원본 크기 이미지의 URL입니다. url 속성을 사용하여 해당 페이지에서 사용할 이미지를 지정합니다.
width Required A non-negative integer 픽셀 단위의 이미지 너비입니다. 720픽셀을 초과하는 것이 좋습니다.
height Required A non-negative integer 픽셀 단위의 이미지 높이입니다. 720픽셀을 초과하는 것이 좋습니다.

하위 요소

하위 요소 필수 여부 설명
<link> 요청되지만 지역 사진 목록의 경우에는 필수입니다. 이 태그에는 관련 이미지가 있는 사이트 페이지의 유효한 최신 URL이 포함됩니다. 이미지 자체의 URL은 포함되어 있지 않습니다. 예시:
<link><http://www.example.com/magic_pizza/></link>
<title> 요청됨 이 태그에는 이미지 제목이 포함됩니다. 예:
<title>"Luxury Apartment"</title>
<author> 요구되지 않음 콘텐츠 작성자의 이름입니다. 값은 사용자 이름이거나 '이름 성' 형식의 전체 이름일 수 있습니다.
<date> 필수

이 태그는 콘텐츠 항목이 생성된 날짜를 식별합니다. 다음 예시와 같이 연도, 월, 일을 입력해야 합니다.

<date month="6" day="7" year="2023"/>

다음 예는 이미지 태그가 있는 일부 호텔 목록을 보여줍니다.

<?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>
    <content>
      <review>
      </review>
      <attributes>
      </attributes>
      <image type="photo" url="https://image_url" width="400" height="300">
        <link>https://image_url</link>
        <title>Apartment at Sandstone</title>
        <author>Jessica Landlord</author>
        <date month="6" day="7" year="2023"/>
      </image>
    </content>
  </listing>
  ...
</listings>

구문 가이드라인

XML 기반 호텔 목록을 만들 때는 다음 가이드라인을 따르세요.

  • Google의 XSD 스키마를 사용하여 호텔 목록 XML 파일의 유효성을 검사합니다.

  • UTF-8 인코딩을 사용합니다. 아래 예와 같이 XML 태그에 encoding 속성을 포함하여 이 인코딩 스키마를 지정합니다.

  • CDATA 섹션을 사용하여 피드에 데이터 값을 지정할 수 있습니다. CDATA 섹션을 사용하는 경우 특수문자를 이스케이프 처리하지 마세요.

  • URL을 포함하여 CDATA 섹션에 없는 데이터 값에 이스케이프 코드를 사용합니다. 항목 코드나 문자 코드를 사용하여 이러한 특수문자를 나타낼 수 있습니다. 다음 표에는 사용 가능한 공통 항목 및 문자 코드가 나와 있습니다.

    문자 기반이란 항목 문자 코드
    앰퍼샌드 (&) &amp; &#38;
    작은따옴표 (') &apos; &#39;
    큰따옴표 (") &quot; &#34;
    초과 (>) &gt; &#62;
    미만 (<) &lt; &#60;
  • 데이터를 포함하지 않는 XML 요소는 생략합니다. 예를 들어 호텔의 위도와 경도가 없는 경우 빈 <latitude/><longitude/> 요소를 포함하면 안 됩니다.

  • 어떠한 상황에서도 XML 요소에 HTML을 사용하지 마세요 (이스케이프 처리된 경우에도 마찬가지).

  • 업로드하기 전에 피드를 확인하려면 로컬 피드 XSD http://www.gstatic.com/localfeed/local_feed.xsd를 사용하세요.

  • 피드에서 댓글을 사용하려면 다음 예와 같이 <!----> 태그로 댓글을 래핑합니다.

    <!-- This is a comment -->
    
  • 사용자 <review>에서 <date> 요소를 닫습니다. 예를 들면 다음과 같습니다.

    <date day="2" month="12" year="2017"/>