Referensi XML Daftar Hotel

Daftar hotel adalah satu atau beberapa file XML yang mencantumkan semua hotel yang akan Anda memberikan informasi harga. File daftar hotel itu sendiri tidak berisi harga tidak akurat atau tidak sesuai.

Elemen root daftar hotel adalah elemen <listings> yang berisi Elemen <listing> yang mendeskripsikan properti Anda.

Anda membuat daftar hotel sebagai bagian dari penerapan awal, lalu menambah atau menghapus hotel sebagai bagian dari pemeliharaan rutin.

Pastikan file Anda sesuai dengan pedoman sintaksis. Misalnya, gunakan encoding UTF-8 dan tentukan skema encoding ini dengan menyertakan atribut encoding di tag XML Anda.

Setelah membuat daftar hotel, Anda dapat menguploadnya ke Google secara manual menggunakan Pusatkan atau hosting di Google Cloud Platform.

Menemukan dan memperbaiki masalah data

Untuk menemukan dan memperbaiki masalah data dalam daftar hotel Anda, lihat artikel berikut:

Persyaratan listingan

Agar memenuhi syarat untuk Google Iklan Hotel, properti dalam daftar hotel Anda harus memiliki hal berikut:

  • Kamar tempat tamu yang membayar bisa menginap
  • Kehadiran fisik dan lokasi tetap yang terbuka untuk umum
  • Dinding dan pipa saluran permanen
  • Persyaratan menginap minimum tidak lebih dari 7 hari

Contoh umum properti yang tidak memenuhi syarat meliputi kapal pesiar dan apartemen karena biasanya tidak memenuhi kriteria Listing requirements.

Kabin perkemahan dan tempat perkemahan lainnya dengan dinding tetap, pipa saluran air, dan kontrol iklim (termasuk kompor kayu atau pemanas propana) memenuhi syarat. Penginapan outdoor yang tidak memenuhi syarat mencakup:

  • Perkemahan, tempat tamu menginap di tenda
  • Area parkir mobil RV, tempat tamu membawa RV sendiri

<listings>

<listings> adalah elemen root daftar hotel dan berisi elemen <language> dan setidaknya satu <listing>.

Elemen <listings> muncul di tempat berikut dalam daftar hotel Hierarki XML:

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

Sintaksis

Elemen <listings> menggunakan sintaksis berikut:

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

Atribut

Elemen <listings> memiliki atribut berikut:

Atribut Wajib? Deskripsi
xmlns:xsi Wajib Tetapkan ke http://www.w3.org/2001/XMLSchema-instance.
xsi:noNamespaceSchemaLocation Wajib Tetapkan ke http://www.gstatic.com/localfeed/local_feed.xsd.

Elemen turunan

Elemen <listings> memiliki elemen turunan berikut:

Elemen turunan Wajib? Jenis Deskripsi
<language> Required string Bahasa yang digunakan untuk menulis feed Anda. Tetapkan nilai ke kode bahasa dua huruf. Misalnya, en untuk bahasa Inggris.
<datum> Optional enum Elemen ini menentukan data geodesi atau model referensi untuk koordinat lintang/bujur yang diberikan di feed. Jika tidak ada nilai data disediakan, nilai default untuk elemen ini adalah WGS84, yang digunakan oleh sebagian besar perangkat GPS modern. Data Tokyo hanya berlaku untuk di Jepang.

Nilai yang valid untuk elemen ini adalah:

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
Catatan: Untuk menggunakan nilai default WGS84, jangan sertakan elemen <datum> dalam daftar hotel.
<listing> Required <listing> Satu atau beberapa entri yang mendeskripsikan setiap hotel di feed. Perlu diketahui bahwa setiap hotel dalam daftar harus memiliki ID yang unik untuk situs Anda, dan bahwa ID ini tidak boleh digunakan kembali.

Contoh

Alamat terstruktur

Contoh berikut menunjukkan sebagian daftar hotel dengan struktur alamat:

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

Alamat Bentuk Bebas

Contoh berikut menunjukkan sebagian daftar hotel dengan format bebas alamat:

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

Konten Opsional

Contoh berikut menunjukkan sebagian daftar hotel dengan listingan yang berisi <content> opsional:

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

Definisi hotel dalam elemen <listings> daftar hotel.

Elemen <listing> muncul di tempat berikut dalam Daftar Hotel Hierarki XML feed:

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

Sintaksis

Elemen <listing> menggunakan sintaksis berikut:

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

Atribut

Elemen <listing> tidak memiliki atribut.

Elemen turunan

Elemen <listing> memiliki elemen turunan berikut:

Elemen turunan Wajib? Jenis Deskripsi
<id> Required string ID unik untuk hotel tersebut.

Catatan: Nilai ini harus unik untuk situs Anda sepanjang waktu. Anjuran tidak menggunakan kembali ID, karena hal tersebut dapat menyebabkan masalah saat mencoba menyelesaikan masalah pencocokan properti.

<name> Required string Nama hotel. Contoh:
<name>Belgrave House</name>
<address> Required Object or string

Lokasi fisik lengkap hotel.

Elemen ini menggunakan satu atribut, format, yang Anda harus ditetapkan ke simple.

Setidaknya, Anda harus memberikan alamat, kota, negara bagian atau wilayah, dan kode pos hotel tersebut. Gunakan <component> turunan untuk menggambarkan masing-masing bagian alamat berikut:

  • addr1: Alamat utama hotel.
  • addr2: Alamat sekunder, jika diperlukan.
  • addr3: Bagian ketiga alamat, jika diperlukan.
  • city: Nama kota hotel.
  • province: Nama negara bagian, wilayah, atau provinsi.
  • postal_code: Kode pos hotel.

Contoh:

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

Atau, Anda dapat memberikan model "format bebas" ini, meskipun tidak direkomendasikan. Contoh:

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

Perhatikan bahwa P.O. kotak atau alamat khusus surat-menyurat lainnya tidak dianggap sebagai alamat fisik lengkap.

<country> Required string Negara tempat listingan ini berada. Nilai harus berupa kode negara dua huruf. Misalnya, Indonesia adalah "ID" dan Amerika Serikat adalah "AS". Contoh:
<country>US</country>
<latitude> Required* float Garis lintang yang sesuai dengan lokasi listingan. Sebagai contoh:
<latitude>37.423738</latitude>

Nilai ini dapat dihasilkan dengan alat GeoCoding seperti API Google Maps.

<longitude> Required* float Garis bujur yang sesuai dengan lokasi listingan. Sebagai contoh:
<longitude>-122.090101</longitude>

Nilai ini dapat dihasilkan dengan alat GeoCoding seperti API Google Maps.

<location_precision> Optional integer Presisi lokasi properti yang dikirim dalam meter saat lintang dan bujur properti di-obfuscate. Nol (0) berarti tidak ada obfuscation dan lokasi ini tepat. Catatan: Elemen ini hanya berlaku untuk Rental Akomodasi.
<phone> Required* string

Satu atau beberapa nomor kontak hotel. Jika listingan adalah bisnis cabang, harap berikan nomor telepon khusus untuk lokasi cabang (bukan nomor telepon kantor pusat pusat).

Atribut type dapat berupa salah satu dari hal berikut:

  • fax: Nomor telepon faks.
  • main: Nomor telepon suara utama.
  • mobile: Nomor telepon seluler.
  • tdd: Perangkat Telekomunikasi untuk Tunarungu (TDD) nomor telepon Anda.
  • tollfree: Nomor telepon bebas pulsa.

Contoh:

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

Setidaknya, Anda harus memberikan jenis main.

<category> Optional string Jenis properti, seperti hotel. Partner dapat menggunakan informasi internal kategori yang harus mereka deskripsikan propertinya, seperti "hotel bisnis", "resor", "motel", dan serupa.
<content> Optional <content> Detail opsional yang digunakan untuk listingan, seperti deskripsi, rating, dan fitur properti.

* Nomor telepon atau lintang/bujur wajib diisi. Rab menyarankan agar Anda menentukan keduanya.

Contoh

Alamat terstruktur

Contoh berikut menunjukkan sebagian daftar hotel dengan struktur alamat:

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

Alamat Bentuk Bebas

Contoh berikut menunjukkan sebagian daftar hotel dengan format bebas alamat:

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

Konten Opsional

Contoh berikut menunjukkan sebagian daftar hotel dengan listingan yang berisi <content> opsional:

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

Menambahkan informasi tentang listingan, seperti rating dan ulasan, fasilitas, serta detail lainnya. Elemen <content> bersifat opsional. Dalam <content>, semua elemen turunan bersifat opsional.

Elemen <content> muncul di tempat berikut dalam Daftar Hotel Hierarki XML feed:

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

Sintaksis

Elemen <content> menggunakan sintaksis berikut:

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

Atribut

Elemen <content> tidak memiliki atribut.

Elemen turunan

Elemen <content> memiliki elemen turunan berikut:

Elemen turunan Wajib? Jenis Deskripsi
<text type="description"> Optional Object

Halaman web yang terkait dengan listingan dari penyedia. Memiliki elemen turunan berikut:

  • <link>: Link ke deskripsi. Sertakan "http://" atau
    "https://" dalam elemen ini (opsional).
  • <title>: Judul untuk deskripsi (opsional).
  • <author>: Penulis deskripsi (opsional).
  • <body>: Isi deskripsi (wajib).
  • <date>: Tanggal deskripsi (opsional).
  • Catatan: Elemen ini harus muncul sesuai urutan di atas.

<review type="[editorial|user]"> Optional <review>

Berisi ulasan pengguna atau ulasan editorial listingan. Nama listingan dapat memiliki berapa pun ulasan di dalamnya, apa pun jenisnya.

Anda tidak perlu menyertakan semua ulasan untuk properti di Elemen <listing>; elemen ini dimaksudkan untuk Anda sertakan ulasan yang dipilih yang menggambarkan fitur atau {i>sandwich<i} itu.

<attributes> Optional Object

Berisi 0 atau beberapa elemen turunan <client_attr> yang memberikan detail tentang properti. Elemen turunan menggunakan sintaksis:

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

Untuk daftar dan deskripsi elemen turunan, lihat <attributes>

Semua elemen <client_attr> bersifat opsional.

Jika ada elemen turunan <website>, elemen tersebut harus diposisikan sebelum elemen <client_attr>.

<image> Optional Object Tag berulang, berisi informasi gambar terperinci.

Contoh

Contoh berikut menunjukkan sebagian daftar hotel yang menyertakan Elemen <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>

Berisi ulasan pengguna atau ulasan editorial. Anda tidak perlu menyertakan semua ulasan untuk listingan di elemen <listing>; elemen ini ditujukan untuk Anda untuk menyertakan ulasan terpilih yang menunjukkan fitur listingan ini atau kualitas.

Elemen <review> muncul di tempat berikut dalam Daftar Hotel Hierarki XML feed:

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

Sintaksis

Elemen <review> menggunakan sintaksis berikut:

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

Atribut

Elemen <review> memiliki atribut berikut:

Atribut Wajib? Deskripsi
type Required Jenis ulasan. Tetapkan ke salah satu nilai berikut:
  • editorial: Ulasan oleh situs atau ulasan lainnya {i>authority<i}.
  • user: Ulasan oleh pengguna akhir.

Elemen turunan

Elemen <review> memiliki elemen turunan berikut:

Elemen turunan Wajib? Jenis Deskripsi
<link> Optional string Link ke ulasan. Sertakan "http://" atau "https://" dalam .
<title> Optional string (Khusus ulasan editorial) Judul ulasan.
<author> Optional string Penulis ulasan; misalnya, "Susan von Trapp". Hal ini juga dapat berupa nama situs atau publikasi tempat ulasan muncul jika tidak diberi kredit.
<rating> Optional string Bilangan floating point dari 0 hingga 10 (inklusif) yang mewakili skor ulasan. Misalnya, "8.9".
<body> Optional string Teks ulasan. Elemen ini tidak boleh berisi HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Khusus ulasan pengguna) Tanggal ulasan, yang Anda tentukan dengan berikut dari elemen ini:
  • day: Hari dalam sebulan; misalnya, "7".
  • month: Bulan, dengan 1 = Januari ... 12 = Desember.
  • year: Empat digit tahun; misalnya, "2023".

Misalnya, 7 Juni 2023 ditulis sebagai:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Hanya ulasan pengguna) Tanggal pengulas mengunjungi listingan yang sedang diulas. Formatnya sama dengan <date> di atas.

Misalnya, 7 Juni 2023 ditulis sebagai:

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

Ulasan tanpa setidaknya bulan dan tahun <servicedate> terisi mungkin tidak ditampilkan. Tanggal tidak wajib diisi.

Perhatikan bahwa <title> adalah elemen turunan <review> yang valid hanya jika type ulasan adalah editorial, dan <date> hanya valid jika type adalah user.

Contoh

Contoh berikut menunjukkan sebagian daftar hotel dengan listingan yang berisi ulasan editorial dan pengguna:

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

Tag <attributes> dapat digunakan untuk mendeskripsikan fasilitas properti dan untuk mengklasifikasikan rating dan ulasan suatu properti.

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

Elemen turunan

Elemen turunan Wajib? Deskripsi
<website> Optional Situs utama untuk hotel. Jika ada, harus diposisikan sebelum elemen <client_attr> pertama. Contoh:
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional Karakteristik atau "atribut" tambahan dari properti yang dapat ditentukan menggunakan atribut attribute_name atau attribute_name untuk Rental Akomodasi.

Nilai untuk placeholder atribut_name

Tabel berikut mencantumkan nilai yang valid untuk attribute_name di <client_attr name="attribute_name"> .

Nilai untuk attribute_name Deskripsi Nilai konten yang valid
alternate_hotel_id ID alternatif untuk properti Anda. Memiliki ID terpisah sangat berguna jika Anda mungkin memerlukan satu ID properti untuk informasi feed dan ID properti lain untuk sistem pemesanan Anda. Nilai string apa pun
custom_[0-4] Atribut khusus jenis string apa pun. Kolom ini tidak ditampilkan kepada pengguna. Nilai string apa pun
hotel_brand Merek yang menaungi hotel ini. Misalnya, "Marriott" atau "Hilton". Nama ini tidak ditampilkan kepada pengguna, tetapi dapat digunakan untuk pengelompokan hotel. Nilai string apa pun
lodging Representasi yang dienkode dari semua kolom yang tersedia di Lodging proto. String berenkode base64 dari dienkode Lodging proto
num_reviews Jumlah ulasan listingan. Semua bilangan bulat non-negatif.
rating Angka floating point yang mewakili rating properti gabungan. Angka ini biasanya dari 0-5, 0-10, atau 0-100, tetapi Anda dapat menggunakan rentang apa pun yang mewakili sistem rating Anda.

Nilai untuk placeholder attribute_name untuk Rental Akomodasi

Lihat atribut khusus Rental Akomodasi dan contoh XML.

<image>

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

Gambar digunakan untuk menampilkan properti di ID listingan. Semua gambar yang digunakan harus ikuti panduan berikut:

  • Rasio aspek yang direkomendasikan untuk gambar adalah 4:3.
  • URL gambar harus dapat diakses oleh crawler Gambar Googlebot.
  • Jika situs Anda menyertakan robots.txt pada tingkat root, pastikan bahwa situs tersebut berisi salah satu dari dua opsi yang ditampilkan di bawah:

    1. Memungkinkan crawler Googlebot meng-crawl konten situs Anda, termasuk gambar.

      • User-agent: Googlebot
      • Allow: /
    2. Mengizinkan crawler Gambar Googlebot meng-crawl gambar di situs Anda.

      • User-agent: Googlebot-Image
      • Allow: /
  • Screenshot gambar atau situs tidak diizinkan. Gambar harus asli dan gambar atau foto asli.

Atribut

  • "ad" jika gambar adalah iklan
  • "menu" jika gambar adalah menu restoran
  • "photo" jika gambar adalah foto bisnis
Nama atribut Wajib? Format Deskripsi
type Required Text

Gambar harus berupa salah satu dari hal berikut:

url Required Text URL gambar ukuran penuh. Gunakan atribut URL untuk menentukan gambar yang akan digunakan pada halaman tersebut.
width Required A non-negative integer Lebar gambar, dalam piksel (lebih dari 720 piksel direkomendasikan)
height Required A non-negative integer Tinggi gambar, dalam piksel (lebih dari 720 piksel direkomendasikan)

Elemen turunan

Elemen turunan Wajib? Deskripsi
<link> Diminta, tetapi wajib untuk listingan foto lokal. Tag ini berisi URL halaman yang valid dan terbaru di situs Anda tempat gambar yang relevan aktif. URL ini tidak berisi URL untuk gambar itu sendiri. Contoh:
<link><http://www.example.com/magic_pizza/></link>
<title> Diminta Tag ini berisi judul gambar. Contoh:
<title>"Luxury Apartment"</title>
<author> Tidak wajib Nama penulis konten. Nilainya bisa berupa nama pengguna atau nama lengkap dalam format "Nama Depan Nama Belakang".
<date> Wajib

Tag ini mengidentifikasi tanggal pembuatan item konten. Anda harus memasukkan tahun, bulan, dan hari, seperti pada contoh berikut:

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

Contoh

Contoh berikut menunjukkan sebagian daftar hotel dengan tag gambar:

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

Panduan sintaksis

Saat membuat daftar hotel berbasis XML, gunakan panduan berikut:

  • Validasi file XML Daftar Hotel Anda dengan Skema XSD Google.

  • Gunakan encoding UTF-8. Tentukan skema encoding ini dengan menyertakan encoding di tag XML Anda, seperti ditunjukkan dalam contoh di bawah ini.

  • Anda dapat menentukan nilai data di feed Anda dengan bagian CDATA. Jika Anda menggunakan Bagian CDATA, jangan meng-escape karakter khusus.

  • Gunakan kode escape untuk nilai data yang tidak ada di bagian CDATA, termasuk URL. Anda dapat menggunakan kode entitas atau kode karakter untuk mewakili karakter khusus ini. Tabel berikut mencantumkan kode entitas dan karakter umum yang dapat Anda gunakan:

    Karakter Entitas Kode Karakter
    Simbol (&) &amp; &#38;
    Tanda Kutip Tunggal (') &apos; &#39;
    Tanda Kutip Ganda (") &quot; &#34;
    Lebih Dari (>) &gt; &#62;
    Kurang dari (<) &lt; &#60;
  • Hapus elemen XML yang tidak berisi data. Misalnya, jika Anda tidak memiliki lintang dan bujur untuk hotel, Anda tidak boleh menyertakan Elemen <latitude/> dan <longitude/>.

  • Jangan gunakan HTML dalam elemen XML dalam keadaan apa pun (meskipun di-escape).

  • Untuk memvalidasi feed sebelum diupload, Anda dapat menggunakan XSD feed lokal http://www.gstatic.com/localfeed/local_feed.xsd.

  • Untuk menggunakan komentar di feed, gabungkan komentar dalam tag <!-- dan -->, seperti yang ditunjukkan contoh berikut:

    <!-- This is a comment -->
    
  • Pastikan Anda menutup elemen <date> di pengguna <review>. Contoh:

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