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 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 ke Google secara manual menggunakan Pusat Pengelolaan Hotel atau menghostingnya di server Anda.
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 mencakup kapal pesiar dan apartemen karena biasanya tidak memenuhi kriteria Listing requirements
.
Kabin perkemahan dan tempat berkemah lainnya dengan dinding permanen, 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 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? | Jenis | 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 menetapkan data geodesi atau model referensi untuk
koordinat 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 , 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>
<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? | 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 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, Setidaknya, Anda harus memberikan alamat, kota, negara bagian atau wilayah, dan kode pos untuk hotel. Gunakan elemen turunan
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 lokasi ini 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 pusat). Atribut
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 |
<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>
<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? | Jenis | Deskripsi |
---|---|---|---|
<text |
Optional | Object | Halaman web yang terkait dengan listingan dari penyedia. Memiliki elemen turunan berikut:
Catatan: Elemen ini harus muncul sesuai urutan di atas. |
<review |
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 dalam elemen |
<attributes> | Optional | Object | Berisi 0 atau beberapa elemen turunan <client_attr name="attribute_name">attribute_value<client_attr> Untuk daftar dan deskripsi elemen turunan, lihat Semua elemen Jika ada elemen turunan |
<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 dalam elemen <listing>
; elemen ini ditujukan agar Anda menyertakan ulasan terpilih yang merupakan indikasi 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:
|
Elemen turunan
Elemen <review>
memiliki elemen turunan berikut:
Elemen turunan | Wajib diisi? | Jenis | 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 diberi kredit. |
<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 ini:
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 yang terisi <servicedate> 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 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 atribut_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 berguna jika Anda mungkin memerlukan satu ID properti untuk informasi feed dan ID properti lainnya 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 mengelompokkan hotel. | Nilai string apa pun |
lodging | Representasi yang dienkode dari semua kolom yang tersedia di
proto
Lodging . |
String berenkode base64 dari proto Lodging yang dienkode |
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 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 di tingkat root, pastikan situs tersebut berisi salah satu dari dua opsi yang ditampilkan di bawah:
Memungkinkan crawler Googlebot meng-crawl konten situs Anda, termasuk gambar.
- User-agent: Googlebot
- Allow: /
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 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 diisi? | 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 berada. 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 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 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, seperti yang ditunjukkan pada contoh di bawah.Anda dapat menentukan nilai data di feed Anda dengan bagian
CDATA
. Jika Anda menggunakan bagianCDATA
, 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 Entity Kode Karakter Simbol (&) & & Tanda Kutip Tunggal (') ' ' Tanda Kutip Ganda (") " " Lebih Dari (>) > > Kurang dari (<) < < 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/>
yang kosong.Jangan gunakan HTML dalam elemen XML 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 pada contoh berikut:<!-- This is a comment -->
Pastikan Anda menutup elemen
<date>
di<review>
pengguna. Contoh:<date day="2" month="12" year="2017"/>