호텔 목록 XML 참조

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

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

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

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

호텔 목록을 만든 후 https://support.google.com/hotelprices/를 사용하여 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> 피드의 각 호텔을 설명하는 하나 이상의 항목입니다. 목록의 각 호텔에는 사이트에서 고유한 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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> 요소에 숙박 시설의 모든 리뷰를 포함할 필요는 없습니다. 이 요소는 이 등록정보의 기능이나 품질을 보여주는 선택된 리뷰를 포함하기 위한 것입니다.

요점: <review>는 숙박 시설 계정에만 전송해야 합니다. 자세한 내용은 기술계정 관리자 (TAM)에게 문의하세요.
<attributes> Optional Object

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

<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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>
            + <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 변수를 사용하려면 기술계정 관리자 (TAM)에게 문의하세요.

 모든 문자열 값
hotel_brand 이 호텔이 속한 브랜드입니다. 예: '메리어트' 또는 '힐튼' 사용자에게 표시되지는 않지만 호텔을 그룹화하는 데 사용할 수 있습니다. 모든 문자열 값
lodging Lodging 프로토에서 사용할 수 있는 모든 필드의 인코딩된 표현입니다. 인코딩된 Lodging 프로토의 Base64 인코딩 문자열
num_reviews 등록정보의 리뷰 수입니다.

핵심 사항: '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> is allowed in Vacation Rentals only -->
            + <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>
      <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 -->