Thiết lập danh sách khách sạn ở định dạng tệp XML

Để thiết lập danh sách khách sạn, bạn có thể sử dụng một trong những cách sau:

  • Cung cấp tệp CSV hoặc XML
  • Tải tệp lên từ Hotel Center
  • Lưu trữ tệp trên máy chủ

Hướng dẫn này mô tả cách thiết lập danh sách khách sạn bằng tệp XML và lưu trữ nguồn cấp dữ liệu XML trên máy chủ của bạn để Google tải các tệp XML của bạn xuống theo lịch biểu được yêu cầu. Để biết các phương pháp thiết lập danh sách khách sạn khác, hãy xem bài viết Cách thiết lập quỹ phòng của khách sạn.

Giới thiệu về danh sách khách sạn ở định dạng tệp XML

Tệp danh sách khách sạn chứa dữ liệu mô tả (chẳng hạn như tên cơ sở lưu trú, địa chỉ, vị trí được mã hoá địa lý) được sắp xếp theo cơ sở lưu trú cho tất cả các cơ sở lưu trú trong tài khoản Hotel Center.

Dưới đây là một ví dụ rất cơ bản về tệp danh sách khách sạn ở định dạng tệp XML. Ví dụ này chỉ cho thấy một trong nhiều phần tử <listing> được chỉ định trong tệp. Mỗi phần tử <listing> đại diện cho một thuộc tí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>
    <!-- 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>

Tạo danh sách khách sạn ở định dạng tệp XML

Để tạo nguồn cấp dữ liệu danh sách khách sạn ở định dạng XML, hãy làm theo các bước sau:

  1. Xem lại các yêu cầu về tệp.

  2. Viết mã cho tệp của bạn như mô tả trong phần Tài liệu tham khảo XML về Danh sách khách sạn.

  3. Xác thực các tệp bằng giản đồ nguồn cấp dữ liệu danh sách khách sạn.

Sau khi xác thực tệp, hãy lưu trữ nguồn cấp dữ liệu trên máy chủ của bạn. Ngoài ra, bạn có thể tải danh sách lên Hotel Center theo cách thủ công.

Lưu trữ nguồn cấp dữ liệu XML trên máy chủ của bạn

Khi dùng phương thức phân phối Lấy danh sách khách sạn, bạn có thể lưu trữ một danh sách khách sạn trên máy chủ và Google sẽ tìm nạp nguồn cấp dữ liệu theo tần suất mà bạn muốn. Sau khi bạn tạo danh sách khách sạn và xác thực tệp XML của danh sách đó, hãy làm như sau:

  1. Chuẩn bị tệp cho Google như mô tả trong Yêu cầu về việc lưu trữ.

  2. Hãy liên hệ với Giám đốc Quản lý Khách hàng về Kỹ thuật (TAM) của bạn để thiết lập các thông tin sau:

    • Lịch tải xuống của Google, thường là mỗi tuần một lần
    • URL tải xuống và các yêu cầu về việc xác thực

Nếu không có lỗi, danh sách khách sạn của bạn sẽ được xuất bản và tất cả các cơ sở lưu trú khớp thành công trong Google Maps sẽ hiển thị trong tài khoản Hotel Center của bạn, trong thẻ Cơ sở lưu trú.

Nếu có lỗi, Google sẽ chia sẻ lỗi với bạn để bạn có thể sửa lỗi và chuẩn bị tệp để tải xuống lại.

Yêu cầu về việc lưu trữ

Hãy tuân thủ các yêu cầu sau đây khi lưu trữ nguồn cấp dữ liệu XML:

Yêu cầu đối với máy chủ

  • Máy chủ phải có thể truy cập được thông qua giao thức HTTP hoặc HTTPS.

Yêu cầu về thư mục

Để đảm bảo rằng Google truy xuất được toàn bộ thông tin tổng quan nhanh về dữ liệu của bạn và không cố gắng tải các tệp chưa hoàn chỉnh xuống, hãy làm theo các nguyên tắc sau đây khi đăng tệp lên máy chủ HTTP:

  • Phát triển và xác thực các tệp XML của nguồn cấp dữ liệu trong một thư mục khác với thư mục mà Google tìm nạp, đó là: Không sử dụng thư mục download.

  • Sau khi bạn đã xác thực thành công các tệp XML của nguồn cấp dữ liệu, hãy tạo một đường liên kết tượng trưng từ thư mục tải xuống đến nguồn cấp dữ liệu mới tạo.

  • Nếu bạn đang cung cấp tệp .zip, hãy đưa các tệp XML vào thư mục gốc chứ không phải trong thư mục tải xuống.

Yêu cầu về tệp

  • Sử dụng tệp văn bản thuần tuý chứ không phải tệp có định dạng như tệp Microsoft Word.

  • Đảm bảo rằng tệp XML không nén không vượt quá 100 MB. Bạn có thể nén một hoặc nhiều tệp XML vào một tệp .zip duy nhất. Không có giới hạn đối với các tệp XML đã nén hoặc tệp .zip.

  • Đặt tên cho các tệp như sau:

    • Đối với tệp XML đơn lẻ, hãy sử dụng PARTNER_NAME_local.xml.
    • Đối với một hoặc nhiều tệp XML trong một tệp zip, hãy sử dụng PARTNER_NAME_local.xml.zip

    Bạn có thể đặt tên cho từng tệp XML trong tệp zip theo bất kỳ cách nào. Tuy nhiên, bạn nên thêm mã ngôn ngữ vào từng tên tệp.

Yêu cầu xác thực

  • Nếu muốn, bạn có thể bảo mật các tệp của mình bằng tên người dùng và mật khẩu bằng phương thức xác thực BASIC hoặc IARC.

  • Không hỗ trợ NTLM.