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 implementasi awal, lalu menambahkan atau menghapus hotel dari daftar tersebut 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 dalam tag XML Anda.

Setelah membuat daftar hotel, Anda dapat menguploadnya secara manual ke Google menggunakan https://support.google.com/hotelprices/ 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 Google Iklan Hotel, properti dalam daftar hotel Anda harus memiliki kriteria 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 properti tersebut biasanya tidak memenuhi kriteria Listing requirements.

Kabin perkemahan dan tempat berkemah lainnya dengan dinding, sistem pipa, dan kontrol iklim permanen (termasuk kompor kayu atau pemanas propana) memenuhi syarat. Penginapan outdoor yang tidak memenuhi syarat meliputi:

  • Bumi perkemahan, yang tamunya menginap di tenda
  • Tempat parkir RV, yang tamunya membawa kendaraan RV 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? 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. Tetapkan nilai elemen ini ke kode bahasa dua huruf. Misalnya, en untuk bahasa Inggris.
<datum> Optional enum Elemen ini menentukan datum geodetik atau model referensi untuk koordinat lintang/bujur yang diberikan dalam feed. Jika tidak ada nilai datum yang diberikan, nilai default untuk elemen ini adalah WGS84, yang digunakan oleh sebagian besar perangkat GPS modern. Datum 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 di 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 bentuk 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 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>
      <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>

Definisi hotel di 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? Jenis Deskripsi
<id> Required string ID unik untuk hotel tersebut.

Catatan: Nilai ini harus unik untuk situs Anda sepanjang waktu. Jangan 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 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 jalan utama hotel.
  • addr2: Alamat sekunder, jika perlu.
  • addr3: Bagian ketiga alamat, jika perlu.
  • 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 Unit 3, Boston, MA, 02472</address>

Perhatikan 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. Contoh: 
<latitude>37.423738</latitude>

Nilai ini dapat dihasilkan dengan alat GeoCoding seperti Google Maps API.
<longitude> Required* float Garis bujur yang sesuai dengan lokasi listingan. Contoh: 
<longitude>-122.090101</longitude>

Nilai ini dapat dihasilkan 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 untuk hotel. Jika listingan adalah cabang bisnis, berikan nomor telepon khusus untuk lokasi cabang (bukan nomor telepon kantor pusat).

Atribut type dapat berupa salah satu dari 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>

Minimal, Anda harus memberikan jenis main.
<category> Optional string Jenis properti, seperti hotel. Partner dapat menggunakan kategori internal apa pun yang mereka miliki untuk mendeskripsikan propertinya, 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 Anda menentukan 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 bentuk 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 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>
      <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>

Menambahkan informasi tentang listingan, seperti rating, fasilitas, dan 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 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>

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://" di 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. 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 terpilih yang menggambarkan fitur atau kualitas listingan ini.

Poin Penting: <review> hanya boleh dikirim untuk akun Rental Akomodasi. Hubungi Manajer Akun Teknis (TAM) Anda untuk mengetahui informasi selengkapnya.
<attributes> Optional Object

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

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

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

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

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

Elemen turunan

Elemen turunan Wajib? 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 yang didukung untuk Rental Akomodasi.

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 dapat berguna jika Anda mungkin memerlukan satu ID properti untuk informasi feed dan ID properti lainnya untuk mesin pemesanan Anda. Nilai string apa pun
Tidak digunakan lagi: Atribut kustom jenis string apa pun. Informasi ini tidak ditampilkan kepada pengguna.

Penting: Hubungi Manajer Akun Teknis (TAM) Anda jika Anda ingin menggunakan variabel CUSTOM.

 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 yang dienkode dari semua kolom yang tersedia di Lodging proto. String berenkode base64 dari encoded Lodging proto
num_reviews Jumlah ulasan listingan.

Poin Penting: "num_reviews" hanya boleh dikirim untuk feed Rental Akomodasi.

 Semua bilangan bulat non-negatif.
rating Jumlah floating point yang mewakili rating properti gabungan. Jumlah ini biasanya dari 0-5, 0-10, atau 0-100, tetapi Anda bisa menggunakan rentang apa pun yang mewakili sistem rating Anda. Misalnya, rating properti harus 3 atau 4 untuk rating_scale 5.

Catatan: Skala rating default adalah 0-10 jika tidak ditentukan.

Nilai untuk placeholder attribute_name untuk Rental Akomodasi

Lihat Atribut khusus Rental Akomodasi dan contoh XML.

<image>

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

Gambar digunakan untuk menampilkan properti di ID listingan. Semua gambar yang digunakan harus mengikuti pedoman berikut:

  • Rasio aspek gambar yang direkomendasikan 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:

    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 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? 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 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? Deskripsi
<link> Diminta, tetapi wajib untuk listingan foto lokal. Tag ini berisi URL valid dan terbaru pada halaman di situs Anda yang menampilkan gambar yang relevan. 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 "Nama Depan Nama Belakang".
<date> Wajib

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

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

Contoh

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

Pedoman sintaksis

Saat membuat daftar hotel berbasis XML, gunakan panduan berikut:

  • Validasi file XML Daftar Hotel dengan Skema XSD Google.

  • Gunakan encoding UTF-8. Tentukan skema encoding ini dengan menyertakan atribut encoding dalam tag XML Anda, seperti yang ditunjukkan dalam 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
    Ampersand (&) &amp; &#38;
    Petik Tunggal (') &apos; &#39;
    Petik 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 di 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 Anda, gabungkan komentar dalam tag <!-- dan -->, seperti yang ditunjukkan contoh berikut:

    <!-- This is a comment -->