Trang tham khảo XML về Danh sách khách sạn

Danh sách khách sạn là một hoặc nhiều tệp XML liệt kê tất cả các khách sạn mà bạn sẽ cung cấp thông tin về giá. Bản thân tệp danh sách khách sạn không chứa thông tin về giá.

Phần tử gốc của danh sách khách sạn là phần tử <listings> chứa các phần tử <listing> mô tả các cơ sở lưu trú của bạn.

Bạn tạo một danh sách khách sạn trong quá trình triển khai ban đầu, rồi thêm hoặc loại bỏ khách sạn khỏi danh sách đó trong đợt bảo trì thông thường.

Đảm bảo tệp của bạn tuân thủ nguyên tắc về cú pháp. Ví dụ: sử dụng phương thức mã hoá UTF-8 và chỉ định giản đồ mã hoá này bằng cách thêm thuộc tính encoding vào thẻ XML.

Sau khi tạo một danh sách khách sạn, bạn có thể tải danh sách đó lên Google theo cách thủ công qua https://support.google.com/hotelprices/ hoặc lưu trữ danh sách đó trên máy chủ của bạn.

Tìm và khắc phục vấn đề về dữ liệu

Để tìm và khắc phục vấn đề về dữ liệu trong danh sách khách sạn, hãy tham khảo các bài viết sau:

Các yêu cầu đối với trang thông tin

Để đủ điều kiện sử dụng Google Quảng cáo khách sạn, mỗi cơ sở lưu trú trong danh sách khách sạn của bạn phải có:

  • Các phòng mà khách trả tiền có thể lưu trú
  • Vị trí thực tế và vị trí cố định đang mở cửa cho công chúng
  • Tường cố định và hệ thống ống nước
  • Thời gian lưu trú không quá 7 ngày

Một số ví dụ thường gặp về cơ sở lưu trú không đủ điều kiện gồm có du thuyền và căn hộ. Lý do là vì những cơ sở này thường không đáp ứng được các tiêu chí Listing requirements.

Nhà gỗ cắm trại và các cơ sở cắm trại khác có tường cố định, hệ thống ống nước và thiết bị điều hoà không khí (bao gồm cả lò sưởi đốt củi hoặc lò sưởi dùng khí prôpan) sẽ đủ điều kiện. Những loại nhà nghỉ ngoài trời không đủ điều kiện bao gồm:

  • Khu cắm trại có lều để khách lưu trú
  • Bãi đỗ xe RV nơi khách lái xe RV riêng đến

<listings>

<listings> là phần tử gốc trong một danh sách khách sạn, chứa một phần tử <language> và tối thiểu một phần tử <listing>.

Phần tử <listings> xuất hiện ở vị trí sau đây trong hệ thống phân cấp viết bằng XML của danh sách khách sạn:

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

Cú pháp

Phần tử <listings> sử dụng cú pháp sau:

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

Thuộc tính

Phần tử <listings> có các thuộc tính như sau:

Thuộc tính Bắt buộc? Mô tả
xmlns:xsi Bắt buộc Đặt thành http://www.w3.org/2001/XMLSchema-instance.
xsi:noNamespaceSchemaLocation Bắt buộc Đặt thành http://www.gstatic.com/localfeed/local_feed.xsd.

Phần tử con

Phần tử <listings> có các phần tử con sau đây:

Phần tử con Bắt buộc? Loại Mô tả
<language> Required string Ngôn ngữ dùng để viết nguồn cấp dữ liệu của bạn. Đặt giá trị của phần tử này thành mã ngôn ngữ gồm hai chữ cái. Ví dụ: en cho tiếng Anh.
<datum> Optional enum Phần tử này chỉ định hệ thống trắc địa hoặc mô hình tham chiếu cho toạ độ vĩ độ/kinh độ được cung cấp trong nguồn cấp dữ liệu. Nếu không có giá trị dữ liệu nào được cung cấp, giá trị mặc định cho phần tử này là WGS84, được hầu hết các thiết bị GPS hiện đại sử dụng. Hệ thống trắc địa Tokyo chỉ áp dụng cho các địa chỉ ở Nhật Bản.

Các giá trị hợp lệ cho phần tử này là:

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
Lưu ý: Để sử dụng giá trị mặc định của WGS84, đừng thêm phần tử <datum> vào danh sách khách sạn.
<listing> Required <listing> Một hoặc nhiều mục nhập mô tả từng khách sạn trong nguồn cấp dữ liệu. Xin lưu ý rằng mỗi khách sạn trong danh sách phải có một mã nhận dạng duy nhất trên trang web của bạn và bạn không được sử dụng lại mã nhận dạng này.

Ví dụ

Địa chỉ có cấu trúc

Ví dụ sau đây cho thấy một phần danh sách khách sạn có một địa chỉ theo cấu trúc:

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

Địa chỉ không theo cấu trúc

Ví dụ sau đây cho thấy một phần danh sách khách sạn có một địa chỉ không theo cấu trúc:

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

Nội dung không bắt buộc

Ví dụ sau đây cho thấy một phần danh sách khách sạn có một cơ sở lưu trú có <content> không bắt buộc:

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

Định nghĩa về khách sạn trong phần tử <listings> của danh sách khách sạn.

Phần tử <listing> xuất hiện ở vị trí sau đây trong hệ thống phân cấp viết bằng XML của Nguồn cấp dữ liệu danh sách khách sạn:

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

Cú pháp

Phần tử <listing> sử dụng cú pháp sau:

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

Thuộc tính

Phần tử <listing> không có thuộc tính nào.

Phần tử con

Phần tử <listing> có các phần tử con sau đây:

Phần tử con Bắt buộc? Loại Mô tả
<id> Required string Giá trị nhận dạng duy nhất của khách sạn.

Lưu ý: Giá trị này phải luôn là giá trị duy nhất trên trang web của bạn. Không sử dụng lại mã nhận dạng vì việc này có thể gây ra vấn đề khi bạn cố gắng giải quyết các vấn đề về việc so khớp cơ sở lưu trú.
<name> Required string Tên khách sạn. Ví dụ: 
<name>Belgrave House</name>
<address> Required Object or string

Vị trí thực tế đầy đủ của khách sạn.

Phần tử này có một thuộc tính duy nhất là format mà bạn phải đặt thành simple.

Ít nhất thì bạn phải cung cấp địa chỉ đường phố, thành phố, tiểu bang hoặc khu vực và mã bưu chính cho khách sạn. Sử dụng các phần tử con <component> để mô tả từng phần sau đây của địa chỉ:

  • addr1: Địa chỉ đường chính của khách sạn.
  • addr2: Địa chỉ đường phụ, nếu cần.
  • addr3: Phần thông tin thứ ba trong địa chỉ đường phố, nếu cần.
  • city: Tên thành phố nơi tọa lạc của khách sạn.
  • province: Tên tiểu bang, khu vực hoặc tỉnh nơi tọa lạc của khách sạn.
  • postal_code: Mã bưu chính của khách sạn.

Ví dụ:

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

Một cách khác là bạn có thể cung cấp địa chỉ "không theo cấu trúc", mặc dù cách này không được khuyến khích. Ví dụ:

<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>

Xin lưu ý rằng các địa chỉ hòm thư hoặc địa chỉ nhận thư khác không được coi là địa chỉ thực tế đầy đủ.
<country> Required string Quốc gia nơi tọa lạc của cơ sở lưu trú này. Giá trị phải là mã quốc gia gồm 2 chữ cái. Ví dụ: Hoa Kỳ là "US" và Canada là "CA". Ví dụ: 
<country>US</country>
<latitude> Required* float Vĩ độ tương ứng với vị trí của trang thông tin. Ví dụ: 
<latitude>37.423738</latitude>

Bạn có thể tạo giá trị này bằng các công cụ Mã hoá địa lý như API Google Maps.
<longitude> Required* float Kinh độ tương ứng với vị trí của trang thông tin. Ví dụ: 
<longitude>-122.090101</longitude>

Bạn có thể tạo giá trị này bằng các công cụ Mã hoá địa lý như API Google Maps.
<location_precision> Optional integer Độ chính xác tính theo mét cho vị trí của cơ sở lưu trú mà bạn cung cấp thông tin, khi vĩ độ và kinh độ của cơ sở này bị xáo trộn. Số không (0) có nghĩa là không có xáo trộn và đó là vị trí chính xác. Lưu ý: Phần tử này chỉ áp dụng cho Nhà nghỉ dưỡng cho thuê.
<phone> Required* string

Một hoặc nhiều số điện thoại liên hệ của khách sạn. Nếu cơ sở lưu trú là chi nhánh của doanh nghiệp, vui lòng cung cấp số điện thoại của riêng chi nhánh (không phải số điện thoại của trụ sở chính).

Thuộc tính type có thể là một trong những thuộc tính sau:

  • fax: Số điện thoại fax.
  • main: Số điện thoại chính.
  • mobile: Số điện thoại di động.
  • tdd: Số điện thoại Thiết bị viễn thông dành cho người khiếm thính (TDD).
  • tollfree: Số điện thoại gọi miễn phí.

Ví dụ:

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

Ít nhất thì bạn cần cung cấp loại main.
<category> Optional string Loại cơ sở lưu trú, chẳng hạn như khách sạn. Đối tác có thể sử dụng danh mục nội bộ bất kỳ để mô tả cơ sở lưu trú, chẳng hạn như "khách sạn dành cho thương gia", "khu nghỉ dưỡng", "nhà nghỉ" và các danh mục tương tự.
<content> Optional <content> Thông tin chi tiết không bắt buộc về cơ sở lưu trú, chẳng hạn như nội dung mô tả, thông tin xếp hạng và đặc điểm của cơ sở lưu trú.

* Bạn phải cung cấp một số điện thoại hoặc vĩ độ/kinh độ. Bạn nên xác định cả hai.

Ví dụ

Địa chỉ có cấu trúc

Ví dụ sau đây cho thấy một phần danh sách khách sạn có một địa chỉ theo cấu trúc:

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

Địa chỉ không theo cấu trúc

Ví dụ sau đây cho thấy một phần danh sách khách sạn có một địa chỉ không theo cấu trúc:

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

Nội dung không bắt buộc

Ví dụ sau đây cho thấy một phần danh sách khách sạn có một cơ sở lưu trú có <content> không bắt buộc:

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

Thêm thông tin về cơ sở lưu trú, chẳng hạn như thông tin xếp hạng, tiện nghi và các thông tin chi tiết khác. Phần tử <content> là phần tử không bắt buộc. Trong <content>, mọi phần tử con đều không bắt buộc.

Phần tử <content> xuất hiện ở vị trí sau đây trong hệ thống phân cấp viết bằng XML của Nguồn cấp dữ liệu danh sách khách sạn:

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

Cú pháp

Phần tử <content> sử dụng cú pháp sau:

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

Thuộc tính

Phần tử <content> không có thuộc tính nào.

Phần tử con

Phần tử <content> có các phần tử con sau đây:

Phần tử con Bắt buộc? Loại Mô tả
<text type="description"> Optional Object

Trang web có liên kết với cơ sở lưu trú của nhà cung cấp. Có các phần tử con sau đây:

  • <link>: Một đường liên kết đến nội dung mô tả. Thêm "http://" hoặc
    "https://" vào phần tử này (không bắt buộc).
  • <title>: Tiêu đề cho nội dung mô tả (không bắt buộc).
  • <author>: Tác giả của nội dung mô tả (không bắt buộc).
  • <body>: Nội dung mô tả (bắt buộc).
  • <date>: Ngày thêm nội dung mô tả (không bắt buộc).

    • Lưu ý: Các phần tử này phải xuất hiện theo thứ tự như trên.
<review type="[editorial|user]"> Optional <review>

Có bài đánh giá của người dùng hoặc bài đánh giá của người biên tập về cơ sở lưu trú. Cơ sở lưu trú của bạn có thể có số lượng bài đánh giá tuỳ ý thuộc một trong hai loại nêu trên.

Bạn không cần đưa tất cả các bài đánh giá về cơ sở lưu trú vào phần tử <listing>. Mục đích của phần tử này là để bạn cung cấp các bài đánh giá chọn lọc thể hiện được đặc điểm hoặc chất lượng của cơ sở lưu trú này.

Lưu ý quan trọng: Bạn chỉ nên gửi <review> cho tài khoản Nhà nghỉ dưỡng cho thuê. Hãy liên hệ với Giám đốc Quản lý Khách hàng về Kỹ thuật (TAM) để biết thêm thông tin.
<attributes> Optional Object

Chứa từ 0 phần tử con <client_attr> trở lên và cung cấp thông tin chi tiết về cơ sở lưu trú. Các phần tử con sử dụng cú pháp sau đây:

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

Bạn có thể tìm danh sách và nội dung mô tả các phần tử con trong <attributes>.

Tất cả phần tử <client_attr> đều không bắt buộc.

Nếu có phần tử con <website>, thì phần tử đó phải được đặt trước mọi phần tử <client_attr>.
<image> Optional Object Thẻ lặp lại chứa thông tin chi tiết về hình ảnh.

Ví dụ:

Ví dụ sau cho thấy một phần danh sách khách sạn có phần tử <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>

Bạn có thể sử dụng thẻ <attributes> để mô tả các tiện nghi của cơ sở lưu trú cũng như phân loại điểm xếp hạng cho cơ sở lưu trú.

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

Phần tử con

Phần tử con Bắt buộc? Mô tả
<website> Optional Trang web chính của khách sạn. Nếu có, bạn phải đặt phần tử này trước phần tử <client_attr> đầu tiên. Ví dụ: 
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional Một đặc điểm hoặc "thuộc tính" bổ sung của cơ sở lưu trú, có thể chỉ định bằng attribute_name hoặc attribute_name hiện được hỗ trợ cho Nhà nghỉ dưỡng cho thuê.

Giá trị cho phần giữ chỗ attribute_name

Bảng sau đây liệt kê các giá trị hợp lệ cho attribute_name trong phần tử <client_attr name="attribute_name">.

Giá trị cho attribute_name Mô tả Giá trị nội dung hợp lệ
alternate_hotel_id Giá trị nhận dạng thay thế cho cơ sở lưu trú của bạn. Việc có mã nhận dạng riêng biệt sẽ có ích nếu bạn cần dùng giá trị nhận dạng cơ sở lưu trú khác nhau trong thông tin nguồn cấp dữ liệu và trong công cụ đặt phòng. Giá trị bất kỳ dạng chuỗi
Không được dùng nữa: Mọi thuộc tính tuỳ chỉnh có dạng chuỗi văn bản. Người dùng sẽ không thấy những thuộc tính này.

Lưu ý quan trọng: Hãy liên hệ với Giám đốc Quản lý Khách hàng về Kỹ thuật (TAM) nếu bạn muốn sử dụng các biến CUSTOM.

 Giá trị bất kỳ dạng chuỗi
hotel_brand Thương hiệu của khách sạn này. Ví dụ: "Marriott" hoặc "Hilton". Thông tin này sẽ không hiển thị cho người dùng nhưng có thể được dùng để nhóm khách sạn. Giá trị bất kỳ dạng chuỗi
lodging Biểu thị được mã hoá của tất cả các trường có trong proto Lodging. Chuỗi được mã hoá Base64 của giao thức được mã hoá Lodging
num_reviews Số lượng bài đánh giá của trang thông tin.

Lưu ý quan trọng: Bạn chỉ nên gửi "num_reviews" cho nguồn cấp dữ liệu Nhà nghỉ dưỡng cho thuê.

 Số nguyên không âm bất kỳ.
rating Số thực cho biết điểm xếp hạng tổng hợp của cơ sở lưu trú. Số này thường trong khoảng 0 đến 5, 0 đến 10 hoặc 0 đến 100. Tuy nhiên, bạn có thể sử dụng bất kỳ phạm vi nào đại diện cho hệ thống xếp hạng của mình. Ví dụ: điểm xếp hạng của cơ sở lưu trú phải là 3 hoặc 4 đối với thang điểm xếp hạng là 5.

Lưu ý: Nếu bạn không chỉ định, thang điểm đánh giá mặc định là 0-10.

Giá trị cho phần giữ chỗ attribute_name của Nhà nghỉ dưỡng cho thuê

Hãy tham khảo Thuộc tính dành riêng cho nhà/căn hộ du lịch và ví dụ về XML.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

Hình ảnh được dùng để giới thiệu về cơ sở lưu trú trong mã nhận dạng cơ sở lưu trú. Tất cả hình ảnh bạn sử dụng phải tuân thủ những nguyên tắc sau:

  • Tỷ lệ khung hình nên dùng cho hình ảnh là 4:3.
  • Trình thu thập thông tin Googlebot Image phải có quyền truy cập vào URL của hình ảnh.

  • Nếu trang web của bạn có tệp robots.txt ở thư mục gốc, hãy xác minh rằng trang web có một trong hai lựa chọn bên dưới:

    1. Cho phép trình thu thập thông tin Googlebot thu thập nội dung trên trang web của bạn, bao gồm cả hình ảnh.

      • User-agent: Googlebot
      • Allow: /

    2. Cho phép trình thu thập thông tin Googlebot Image thu thập hình ảnh trên trang web của bạn.

      • User-agent: Googlebot-Image
      • Allow: /

  • Chúng tôi không được phép ảnh chụp màn hình của trang web hoặc hình ảnh. Hình ảnh phải là hình chụp hoặc ảnh gốc thực sự.

Thuộc tính

  • "ad" nếu hình ảnh là quảng cáo
  • "menu" nếu hình ảnh là thực đơn của nhà hàng
  • "photo" nếu hình ảnh là ảnh của doanh nghiệp
Tên thuộc tính Bắt buộc? Định dạng Mô tả
type Required Text

Hình ảnh phải là một trong những loại sau:
url Required Text URL của hình ảnh có kích thước đầy đủ. Sử dụng thuộc tính url để chỉ định hình ảnh bạn muốn sử dụng trên trang đó.
width Required A non-negative integer Chiều rộng của hình ảnh, tính bằng pixel (nên lớn hơn 720 pixel)
height Required A non-negative integer Chiều cao của hình ảnh, tính bằng pixel (nên lớn hơn 720 pixel)

Phần tử con

Phần tử con Bắt buộc? Mô tả
<link> Theo yêu cầu, nhưng sẽ là bắt buộc đối với trang thông tin ảnh tại địa phương. Thẻ này chứa URL hợp lệ mới nhất của trang có hình ảnh liên quan trên trang web của bạn. Thẻ này không chứa URL của chính hình ảnh đó. Ví dụ:
<link><http://www.example.com/magic_pizza/></link>
<title> Ðã yêu cầu Thẻ này chứa tiêu đề của hình ảnh. Ví dụ: 
<title>"Luxury Apartment"</title>
<author> Không bắt buộc Tên của tác giả nội dung. Giá trị có thể là tên người dùng hoặc tên đầy đủ theo định dạng "Tên Họ".
<date> Bắt buộc

Thẻ này xác định ngày tạo mục nội dung. Bạn phải nhập năm, tháng và ngày theo trình tự như ví dụ sau:

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

Ví dụ:

Ví dụ sau đây cho thấy một phần danh sách khách sạn có các thẻ hình ảnh:

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

Nguyên tắc về cú pháp

Khi tạo danh sách khách sạn bằng XML, hãy sử dụng những nguyên tắc sau:

  • Xác thực tệp XML của Danh sách khách sạn bằng Giản đồ XSD của Google.

  • Sử dụng phương thức mã hoá UTF-8. Chỉ định giản đồ mã hoá này bằng cách thêm thuộc tính encoding vào thẻ XML, như trong các ví dụ bên dưới.

  • Bạn có thể chỉ định các giá trị dữ liệu trong nguồn cấp dữ liệu của mình bằng các phần CDATA. Nếu dùng các phần CDATA, bạn không được dùng mã thoát để biểu thị các ký tự đặc biệt.

  • Hãy sử dụng mã thoát cho các giá trị dữ liệu không nằm trong phần CDATA, bao gồm cả URL. Bạn có thể sử dụng mã thực thể hoặc mã ký tự để biểu thị các ký tự đặc biệt này. Sau đây là bảng liệt kê các mã thực thể và mã ký tự phổ biến mà bạn có thể sử dụng:

    Ký tự Thực thể Mã ký tự
    Dấu và (&) &amp; &#38;
    Dấu nháy đơn (') &apos; &#39;
    Dấu ngoặc kép (") &quot; &#34;
    Lớn hơn (>) &gt; &#62;
    Nhỏ hơn (<) &lt; &#60;

  • Bỏ qua các phần tử XML không chứa dữ liệu. Ví dụ: Nếu bạn không có vĩ độ và kinh độ của khách sạn, thì bạn không nên thêm các phần tử <latitude/> và <longitude/> bị trống.

  • Không sử dụng HTML trong các phần tử XML trong bất kỳ trường hợp nào (ngay cả khi đã dùng mã thoát).

  • Để xác thực nguồn cấp dữ liệu trước khi tải lên, bạn có thể sử dụng giản đồ XSD cho nguồn cấp dữ liệu cục bộ http://www.gstatic.com/localfeed/local_feed.xsd.

  • Để sử dụng nhận xét trong nguồn cấp dữ liệu, hãy chèn nhận xét giữa hai thẻ <!-- và -->, như ví dụ sau đây:

    <!-- This is a comment -->