호텔 목록 XML 참조

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

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

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

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

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

데이터 문제 찾기 및 해결

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

제품 등록 요구사항.

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

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

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

고정된 벽, 배관, 기후 조절 장치 (장작 난로 또는 프로판 히터 포함)가 있는 캠핑 캐빈 및 기타 캠핑 시설은 자격 요건을 충족합니다. 자격 요건을 충족하지 않는 야외 숙박 시설은 다음과 같습니다.

  • 투숙객이 텐트에서 숙박하는 캠프장
  • 투숙객이 본인의 RV를 가져오는 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 피드가 작성된 언어입니다. 이 요소의 값을 두 자리 언어 코드로 설정합니다. 예를 들어 영어의 경우 en입니다.
<datum> Optional enum 이 요소는 피드에 제공된 위도/경도 좌표의 지리 좌표 기준 또는 참조 모델을 지정합니다. 데이텀 값을 제공하지 않으면 이 요소의 기본값은 WGS84이며, 이는 대부분의 최신 GPS 기기에서 사용됩니다. 도쿄 데이터는 일본 주소에만 적용됩니다.

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

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
참고: WGS84의 기본값을 사용하려면 호텔 목록에 <datum> 요소를 포함하지 마세요.
<listing> Required <listing> 피드의 각 호텔을 설명하는 항목 1개 이상 목록의 각 호텔에는 사이트에 고유한 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 Unit 3, 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: 필요한 경우 상세 주소의 세 번째 부분입니다.
  • 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>

참고: 사서함 또는 기타 우편 전용 주소는 완전한 실제 주소로 간주되지 않습니다.
<country> Required string 등록정보가 위치한 국가입니다. 값은 두 자리 국가 코드여야 합니다. 예를 들어 미국은 'US'이고 캐나다는 'CA'입니다. 예를 들면 다음과 같습니다. 
<country>US</country>
<latitude> Required* float 목록의 위치에 해당하는 위도입니다. 예를 들면 다음과 같습니다. 
<latitude>37.423738</latitude>

이 값은 Google Maps API와 같은 GeoCoding 도구로 생성할 수 있습니다.
<longitude> Required* float 목록의 위치에 해당하는 경도입니다. 예를 들면 다음과 같습니다. 
<longitude>-122.090101</longitude>

이 값은 Google Maps API와 같은 GeoCoding 도구로 생성할 수 있습니다.
<location_precision> Optional integer 숙박 시설 위도와 경도가 난독화된 경우 전송되는 숙박 시설 위치의 정밀도(미터)입니다. 0은 난독화가 적용되지 않았으며 정확한 위치임을 의미합니다. 참고: 이 요소는 공유숙박에만 적용됩니다.
<phone> Required* string

호텔의 연락처 전화번호 1개 이상 비즈니스 지점이라면 본사의 전화번호가 아닌 지점 위치의 전화번호를 입력하세요.

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 Unit 3, 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 리뷰 작성자입니다(예: '수잔 폰 트랩'). 크레딧이 없는 경우 리뷰가 표시되는 웹사이트 또는 게시물의 이름일 수도 있습니다.
<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>는 리뷰의 type가 editorial인 경우에만 <review>의 유효한 하위 요소이고 <date>는 type가 user인 경우에만 유효합니다.

예

다음 예는 기사 및 사용자 리뷰가 포함된 등록정보가 있는 부분적인 호텔 목록을 보여줍니다.

<?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 프로토의 Base64 인코딩 문자열
num_reviews 등록정보의 리뷰 수입니다. 음이 아닌 정수입니다.
rating 집계된 숙박 시설 평점을 나타내는 부동 소수점 수입니다. 이 숫자는 일반적으로 0~5, 0~10 또는 0~100이지만 평점 시스템을 나타내는 모든 범위를 사용할 수 있습니다. 예를 들어 rating_scale이 5인 경우 숙박 시설 평점은 3 또는 4여야 합니다.

참고: 지정되지 않은 경우 기본 rating_scale은 0~10입니다.

공유숙박의 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> 필수 아님 콘텐츠 작성자의 이름입니다. 값은 사용자 이름이거나 'Firstname Lastname' 형식의 전체 이름일 수 있습니다.
<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"/>