호텔 목록 XML 참조

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

호텔 목록의 루트 요소는 <listings> 요소로, 여기에는 <listing> 요소는 속성을 설명합니다.

초기 구현의 일환으로 호텔 목록을 만듭니다. 그런 다음 정기 유지보수의 일환으로 호텔을 추가하거나 삭제할 수 있습니다.

파일이 구문 가이드라인을 준수하는지 확인합니다. 예를 들어 UTF-8 인코딩을 사용하고 XML 태그의 encoding 속성입니다.

호텔 목록을 만든 후 호텔을 통해 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 피드가 작성된 언어입니다. 이 요소를 2자리 언어 코드를 반환합니다. 예를 들어 영어의 경우 en입니다.
<datum> Optional enum 이 요소는 문서에 대한 측지 데이터 또는 참조 모델을 지정합니다. 피드에 제공된 위도/경도 좌표입니다. 데이터 값이 없는 경우 제공된 경우 이 요소의 기본값은 WGS84이며 는 대부분의 최신 GPS 장치에서 사용됩니다. 도쿄 데이터는 일본에 등록된 주소여야 합니다.

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

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
를 통해 개인정보처리방침을 정의할 수 있습니다. 참고: 기본값 WGS84을 사용하려면 호텔 목록의 <datum> 요소
<listing> Required <listing> 피드의 각 호텔을 설명하는 하나 이상의 항목입니다. 참고: 목록의 각 호텔에 사이트 고유의 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 호텔의 고유 식별자입니다.

참고: 이 값은 항상 사이트에 대해 고유해야 합니다. 올바른 예시 사용하지 마세요. 숙박 시설 일치 문제를 해결할 수 있습니다.

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

P.O. 기타 우편 전용 주소는 전체 물리적 주소로 간주됩니다.

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

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

<longitude> Required* float 목록의 위치에 해당하는 경도입니다. 대상 예:
<longitude>-122.090101</longitude>

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

<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 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 리뷰 유형입니다. 다음 값 중 하나로 설정합니다. <ph type="x-smartling-placeholder">
    </ph>
  • editorial: 웹사이트 또는 기타 리뷰에 의한 리뷰 있습니다
  • user: 최종 사용자의 리뷰입니다.

하위 요소

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

하위 요소 필수 여부 유형 설명
<link> Optional string 리뷰 링크. 'http://'를 포함합니다. 또는 'https://' 이 요소가 포함됩니다.
<title> Optional string (전문가 리뷰만 해당) 리뷰 제목입니다.
<author> Optional string 리뷰 작성자 (예: 'Susan von Trapp') 또한 리뷰가 표시되는 웹사이트 또는 간행물의 이름 크레딧이 적용되지 않습니다.
<rating> Optional string 1을 나타내는 0 이상 10 이하의 부동 소수점 수 평점 점수도 여기에 포함됩니다. 예: '8.9'
<body> Optional string 리뷰의 텍스트입니다. 이 요소에는 HTML을 포함해서는 안 됩니다.
<date month="MM" day="DD" year="YYYY"/> Optional Object (사용자 리뷰만) 이 요소의 다음 속성을 나타냅니다. <ph type="x-smartling-placeholder">
    </ph>
  • 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>는 다음 경우에만 <review>의 유효한 하위 요소입니다. 리뷰의 typeeditorial이며, <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> 요소 앞에 올립니다. 예: <ph type="x-smartling-placeholder">
<website>https://hotel.example.com</website>
</ph>
<client_attr name="attribute_name"> Optional 추가 특성 또는 '속성' 속성 는 지원되는 attribute_name 또는 공유숙박의 경우 attribute_name

attribute_name 자리표시자의 값

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

attribute_name 설명 유효한 콘텐츠 값
alternate_hotel_id 숙박 시설의 대체 식별자입니다. 별도의 ID가 있으면 유용함 피드 정보에 하나의 속성 식별자가 필요할 수 있으며 예약 엔진의 다른 숙박 시설 식별자입니다. 모든 문자열 값
custom_[0-4] 모든 문자열 유형의 맞춤 속성입니다. 사용자에게는 표시되지 않습니다. 모든 문자열 값
hotel_brand 이 호텔이 속한 브랜드입니다. 예: '메리어트' 또는 '힐튼'. 사용자에게 표시되지 않지만 그룹화에 사용할 수 있습니다. 있습니다. 모든 문자열 값
lodging Lodging proto에 나와 있습니다. base64 인코딩 문자열로 인코딩된 프로토콜 Lodging
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> 요청됨 이 태그에는 이미지의 제목이 포함됩니다. 예: <ph type="x-smartling-placeholder">
<title>"Luxury Apartment"</title>
</ph>
<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 인코딩을 사용합니다. encoding을(를) 포함하여 이 인코딩 스키마를 지정합니다. 속성을 포함해야 합니다.

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

  • 다음을 포함하여 CDATA 섹션에 없는 데이터 값에 이스케이프 코드를 사용하세요. URL을 클릭합니다. 항목 코드 또는 문자 코드를 사용하여 사용할 수 있습니다. 다음 표에는 사용할 수 있는 일반적인 항목 및 문자 코드가 나와 있습니다.

    문자 항목 문자 코드
    앰퍼샌드 (&) &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 -->
    
  • 사용자의 <date> 요소를 닫아야 합니다. <review> 예를 들면 다음과 같습니다.

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