Referensi XML Daftar Hotel

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

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 menambahkan atau menghapus hotel dari daftar tersebut sebagai bagian dari pemeliharaan reguler.

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

Setelah membuat daftar hotel, Anda dapat menguploadnya secara manual ke Google menggunakan Pusat Pengelolaan Hotel atau menghostingnya di server Anda.

Menemukan dan memperbaiki masalah data

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

Persyaratan listingan

Agar memenuhi syarat untuk Iklan Hotel Google, 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 sistem pipa 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 fasilitas berkemah lainnya dengan dinding permanen, sistem pipa, dan pengontrol kondisi udara (termasuk kompor kayu atau pemanas propana) memenuhi syarat. Penginapan outdoor yang tidak memenuhi syarat meliputi:

  • Bumi perkemahan, tempat tamu menginap di tenda
  • Taman RV, tempat tamu membawa RV mereka sendiri

<listings>

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

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

+ <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 diisi? 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 diisi? Type Deskripsi
<language> Required string Bahasa yang digunakan untuk menulis feed Anda. Tetapkan nilai elemen ini ke kode bahasa dua huruf. Misalnya, en untuk bahasa Inggris.
<datum> Optional enum Elemen ini menentukan data geodetik atau model referensi untuk koordinat garis lintang/bujur yang diberikan dalam feed. Jika tidak ada nilai data yang diberikan, nilai default untuk elemen ini adalah WGS84, yang digunakan oleh sebagian besar perangkat GPS modern. Data Tokyo hanya berlaku untuk alamat 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 dalam feed. Perhatikan bahwa setiap hotel dalam daftar harus memiliki ID yang unik untuk situs Anda, dan ID ini tidak boleh digunakan kembali.

Contoh

Alamat Terstruktur

Contoh berikut menunjukkan sebagian daftar hotel dengan alamat terstruktur:

<?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 alamat berformat bebas:

<?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, 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 hierarki XML Feed Daftar Hotel:

+ <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 diisi? Type Deskripsi
<id> Required string ID unik untuk hotel tersebut.

Catatan: Nilai ini harus unik untuk situs Anda sepanjang waktu. Jangan gunakan kembali ID karena 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 harus Anda tetapkan ke simple.

Setidaknya, Anda harus memberikan alamat jalan, kota, negara bagian atau wilayah, dan kode pos untuk hotel. Gunakan elemen turunan <component> untuk mendeskripsikan setiap bagian alamat berikut:

  • addr1: Alamat utama hotel.
  • addr2: Alamat sekunder, jika diperlukan.
  • addr3: Bagian ketiga dari alamat, jika diperlukan.
  • city: Nama kota hotel.
  • province: Nama negara bagian, wilayah, atau provinsi hotel.
  • 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 alamat "bentuk bebas", meskipun hal ini tidak direkomendasikan. Contoh:

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

Perlu diketahui bahwa P.O. box atau alamat khusus surat lainnya tidak dianggap sebagai alamat fisik lengkap.
<country> Required string Negara tempat listingan ini berada. Nilainya 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 dibuat dengan alat GeoCoding seperti Google Maps API.
<longitude> Required* float Garis bujur yang sesuai dengan lokasi listingan. Sebagai contoh: 
<longitude>-122.090101</longitude>

Nilai ini dapat dibuat dengan alat GeoCoding seperti Google Maps API.
<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 lokasinya tepat. Catatan: Elemen ini hanya berlaku untuk Rental Akomodasi.
<phone> Required* string

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

Atribut type dapat berupa salah satu hal berikut:

  • fax: Nomor telepon faks.
  • main: Nomor telepon suara utama.
  • mobile: Nomor telepon seluler.
  • tdd: Nomor telepon Perangkat Telekomunikasi untuk Tunarungu (TDD).
  • 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 kategori internal apa pun yang mereka miliki untuk mendeskripsikan properti mereka, seperti "hotel bisnis", "resor", "motel", dan sejenisnya.
<content> Optional <content> Detail opsional yang digunakan untuk listingan, seperti deskripsi, rating, dan fitur properti.

* Nomor telepon atau lintang/bujur wajib diisi. Sebaiknya tentukan keduanya.

Contoh

Alamat Terstruktur

Contoh berikut menunjukkan sebagian daftar hotel dengan alamat terstruktur:

<?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 alamat berformat bebas:

<?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, 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 hierarki XML Feed Daftar Hotel:

+ <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 diisi? Type 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 dalam urutan di atas.
<review type="[editorial|user]"> Optional <review>

Berisi ulasan pengguna atau ulasan editorial listingan. Listingan Anda dapat memiliki berapa pun ulasan di dalamnya, dari jenis apa pun.

Anda tidak perlu menyertakan semua ulasan untuk properti di elemen <listing>; elemen ini ditujukan agar Anda menyertakan ulasan yang dipilih yang menggambarkan fitur atau kualitas listingan ini.
<attributes> Optional Object

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

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

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 agar Anda menyertakan ulasan terpilih yang menunjukkan fitur atau kualitas listingan ini.

Elemen <review> muncul di tempat berikut dalam hierarki XML Feed Daftar Hotel:

+ <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 diisi? Deskripsi
type Required Jenis ulasan. Tetapkan ke salah satu nilai berikut:
  • editorial: Ulasan dari situs atau otoritas peninjau lainnya.
  • user: Ulasan oleh pengguna akhir.

Elemen turunan

Elemen <review> memiliki elemen turunan berikut:

Elemen turunan Wajib diisi? Type Deskripsi
<link> Optional string Link ke ulasan. Sertakan "http://" atau "https://" dalam elemen ini.
<title> Optional string (Khusus ulasan editorial) Judul ulasan.
<author> Optional string Penulis ulasan; misalnya, "Susan von Trapp". Ini juga dapat berupa nama situs atau publikasi tempat ulasan muncul jika tidak dikreditkan.
<rating> Optional string Angka 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 atribut elemen berikut:
  • day: Hari dalam sebulan; misalnya, "7".
  • month: Bulan, dengan 1 = Januari ... 12 = Desember.
  • year: Tahun empat digit; misalnya,"2023".

Misalnya, 7 Juni 2023 ditulis sebagai:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Khusus ulasan pengguna) Tanggal pengulas mengunjungi listingan yang sedang ditinjau. 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> yang terisi mungkin tidak ditampilkan. Hari tidak wajib diisi.

Perhatikan bahwa <title> adalah elemen turunan dari <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 mengklasifikasikan rating dan ulasan properti.

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

Elemen turunan

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

Nilai untuk placeholder attribute_name

Tabel berikut mencantumkan nilai yang valid untuk attribute_name dalam elemen <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 akan berguna jika Anda mungkin memerlukan satu ID properti untuk informasi feed dan ID properti lain untuk sistem pemesanan. Nilai string apa pun
custom_[0-4] Atribut khusus jenis string apa pun. Informasi 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 mengelompokkan hotel. Nilai string apa pun
lodging Representasi berenkode dari semua kolom yang tersedia di proto Lodging. String berenkode base64 dari proto Lodging yang dienkode
num_reviews Jumlah ulasan listingan. Bilangan bulat non-negatif.
rating Bilangan floating point yang mewakili rating properti gabungan. Angka ini biasanya dari 0-5, 0-10, atau 0-100, namun 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 mengikuti 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 file tersebut berisi salah satu dari dua opsi yang ditampilkan di bawah:

    1. Memungkinkan crawler Googlebot meng-crawl konten situs Anda, menyertakan 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 berupa gambar atau foto asli dan aktual.

Atribut

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

Gambar harus berupa salah satu dari berikut ini:
url Required Text URL gambar ukuran penuh. Gunakan atribut URL untuk menentukan gambar yang akan digunakan di halaman tersebut.
width Required A non-negative integer Lebar gambar, dalam piksel (sebaiknya lebih dari 720 piksel)
height Required A non-negative integer Tinggi gambar, dalam piksel (sebaiknya lebih dari 720 piksel)

Elemen turunan

Elemen turunan Wajib diisi? Deskripsi
<link> Diminta, tetapi wajib untuk listingan foto lokal. Tag ini berisi URL yang valid dan terbaru dari halaman di situs Anda tempat gambar yang relevan berada. File 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 dapat berupa nama pengguna atau nama lengkap dalam format "Namadepan 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 atribut encoding dalam tag XML Anda, seperti yang ditunjukkan pada contoh di bawah.

  • Anda dapat menentukan nilai data di feed 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 Besar 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/> kosong.

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

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

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

    <!-- This is a comment -->

  • Pastikan Anda menutup elemen <date> pada pengguna <review>. Contoh:

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