Halaman ini membahas deskripsi, nilai, dan persyaratan untuk atribut dan elemen turunan. Nilai ini hanya berlaku untuk properti Rental Akomodasi.
Struktur XML umum memiliki format yang serupa dengan feed listingan Hotel. Lihat Referensi XML daftar hotel.
Jika tidak menyertakan item wajib berikut, listingan akan otomatis dinonaktifkan:
- Elemen turunan XML yang diperlukan:
id
,name
,latitude
,longitude
,address
. - Atribut yang diperlukan:
capacity
danwebsite
. Lihat link langsung rental akomodasi di feed listingan Anda. Dengan begitu, pengguna memiliki kesempatan untuk mengunjungi situs properti.
Untuk mengetahui detail elemen turunan XML yang diperlukan, lihat elemen turunan XML.
Untuk informasi selengkapnya tentang Rental Akomodasi, lihat Atribut khusus untuk Rental Akomodasi.
Terakhir, ketika Google menentukan dari sumber lain bahwa nilai atribut berbeda dengan nilai yang ditentukan dalam feed untuk listingan rental akomodasi, Google akan menampilkan nilai untuk listingan tersebut. Misalnya, jika Google menentukan dari foto listingan bahwa listingan tersebut memiliki dapur, tetapi atribut kitchen
tidak ada atau disetel ke No
, Google akan memperlakukan listingan tersebut sebagai dapur. Atribut ini disebut
"atribut inferensi", dan hanya ditampilkan jika ada keyakinan tinggi
terhadap akurasi inferensi.
Nilai untuk placeholder atribut_name
Tabel berikut menyediakan daftar nilai yang valid untuk attribute_name
dalam elemen <client_attr name="attribute_name">
; tetapi, sebaiknya Anda memberikan attribute_name
tambahan jika tersedia.
Nilai untuk attribute_name |
Wajib diisi? | Deskripsi | Nilai konten yang valid |
---|---|---|---|
capacity | Required | Jumlah maksimum tamu yang dapat ditampung properti. Nilai ini harus sama dengan atau lebih besar dari "number_of_rooms". | Non-negative integer value |
website | Required | URL situs untuk properti. | Free text |
partner_hygiene_link | Strongly recommended | Link ke situs partner eksternal yang memberikan informasi selengkapnya tentang detail kebersihan listingan. | Free text (the site's URL) |
number_of_bathrooms | Strongly recommended | Jumlah kamar mandi. | Non-negative float value, for example, 1, 1.5, 2 |
number_of_bedrooms | Strongly recommended | Jumlah kamar tidur. | Non-negative integer value |
number_of_beds | Strongly recommended | Jumlah tempat tidur di semua kamar. | Non-negative integer value |
self_checkin_checkout | Recommended | Apakah properti mengizinkan check in dan check out mandiri. | Yes/No/Unknown |
rating | Strongly recommended | 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. | Non-negative float value |
rating_num | Strongly recommended | Jumlah rating yang dimiliki properti. | Non-negative integer value |
rating_scale | Strongly recommended | Rating maksimum untuk properti | Non-negative integer value |
instant_bookable | Strongly recommended | Apakah properti dapat langsung dipesan melalui proses check-out. Alternatifnya menunggu persetujuan. | Yes/No/Unknown |
description | Strongly recommended | Teks bentuk bebas yang menjelaskan kualitas unik properti | Free text |
category | Strongly recommended | Jenis properti, seperti vila, bungalo, kabin, atau apartemen | Free text |
ac | Recommended | Apakah properti memiliki AC. | Yes/No/Unknown |
beach_access | Recommended | Apakah properti memiliki akses ke pantai umum yang dekat dengan properti. | Yes/No/Unknown |
check_in_time | Recommended | Waktu persis untuk check in ke properti. Format HHMM, HH:MM, atau HH:MM:SS diterima; misalnya, gunakan 14.00, bukan 14.00 atau 14.00. Semua format lain tidak akan diurai atau ditampilkan. | Time |
check_out_time | Recommended | Waktu persis untuk check out dari properti. Format HHMM, HH:MM, atau HH:MM:SS diterima; misalnya, gunakan 11.00, bukan 11.00 atau 11.00. Semua format lain tidak akan diurai atau ditampilkan. | Time |
child_friendly | Recommended | Apakah properti cocok untuk anak-anak. | Yes/No/Unknown |
crib | Recommended | Apakah properti menyediakan tempat tidur bayi. | Yes/No/Unknown |
elevator | Recommended | Apakah properti memiliki elevator. | Yes/No/Unknown |
gym_fitness_equipment | Recommended | Apakah properti memiliki gym atau peralatan kebugaran. | Yes/No/Unknown |
heating | Recommended | Apakah properti memiliki sistem pemanas. | Yes/No/Unknown |
hot_tub | Recommended | Apakah properti memiliki bak mandi air panas. | Yes/No/Unknown |
ironing_board | Recommended | Apakah properti menyediakan papan setrika. | Yes/No/Unknown |
kitchen | Recommended | Apakah properti memiliki dapur. | Yes/No/Unknown |
microwave | Recommended | Apakah properti menyediakan microwave. | Yes/No/Unknown |
min_days_advance_purchase | Recommended | Jumlah hari minimum sebelum properti dapat dipesan. | Non-negative integer value |
min_night_stay | Recommended | Jumlah malam minimum yang dapat dipesan tamu di properti. | Positive integer (more than zero) |
max_night_stay | Recommended | Jumlah maksimum malam yang dapat dipesan tamu di properti. | Positive integer (more than zero) |
outdoor_grill | Recommended | Apakah properti memiliki pemanggang. | Yes/No/Unknown |
oven_stove | Recommended | Apakah properti memiliki kompor. | Yes/No/Unknown |
parking_type | Recommended | Jenis tempat parkir yang tersedia di properti. | Free/Paid/None |
patio | Recommended | Apakah properti memiliki teras. | Yes/No/Unknown |
pets_allowed | Recommended | Beberapa atau semua kamar mengizinkan tamu membawa hewan peliharaan, yaitu atau kucing, yang bukan hewan layanan. | Yes/No/Unknown |
pool_type | Recommended | Jenis kolam renang (akses kolam renang) yang dimiliki properti. | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | Apakah properti bebas asap rokok atau dilarang merokok. | Yes/No/Unknown |
special_service_level | Recommended | Apakah tingkat layanan listingan tersebut khusus dalam beberapa hal.
Misalnya, verified , luxury , premium |
Yes/No/Unknown |
square_footage | Recommended | Luas properti dalam kaki persegi. | Non-negative float value |
square_meters | Recommended | Luas properti dalam meter persegi. | Non-negative float |
tv | Recommended | Apakah properti memiliki TV. | Yes/No/Unknown |
washer_dryer | Recommended | Apakah properti memiliki peralatan laundry. | Yes/No/Unknown |
wheelchair_accessible | Recommended | Apakah properti dapat diakses dengan kursi roda. | Yes/No/Unknown |
internet_type | Recommended | Jenis akses internet Wi-Fi yang disediakan oleh properti. | Free/Paid/None |
airport_shuttle | Optional | Apakah host menyediakan transportasi ke atau dari bandara atau terminal lainnya. | Yes/No/Unknown |
balcony | Optional | Apakah properti memiliki balkon. | Yes/No/Unknown |
fire_place | Optional | Apakah properti memiliki perapian. | Yes/No/Unknown |
free_breakfast | Optional | Apakah properti menyediakan sarapan gratis. | Yes/No/Unknown |
host_description | Optional | Deskripsi host rental akomodasi. | Free text |
host_language | Optional | Bahasa yang dapat digunakan oleh host. | Daftar kode bahasa yang dipisahkan koma; misalnya: de , en |
host_name | Optional | Nama host rental akomodasi. | Free text |
host_response_rate | Optional | Tingkat respons rata-rata host. | Non-negative float value, for example, 1, 0.75, 0.5 |
host_response_time | Optional | Waktu respons rata-rata host. | Free text |
license_num | Optional | Nomor izin usaha (wisata atau bisnis) yang harus ditampilkan untuk properti di wilayah tertentu di dunia. Lisensi ini dapat diulang dan, jika ada beberapa lisensi, sebaiknya tambahkan otoritas lisensi sebagai konteks; misalnya: "Paris: 123456ABC". | Free text |
number_of_half_bathrooms | Optional | Jumlah kamar mandi setengah. | Non-negative integer value |
number_of_living_rooms | Optional | Jumlah ruang keluarga. | Non-negative integer value |
private_beach_access | Optional | Apakah properti memiliki akses khusus ke pantai non-publik. | Yes/No/Unknown |
refund_policy | Optional | Kebijakan pengembalian dana untuk properti. | Free text |
Elemen turunan XML
Elemen turunan XML berikut wajib diisi:
Elemen turunan | Wajib diisi? | Jenis | Deskripsi |
---|---|---|---|
<country> | Strongly recommended | string | Negara tempat listingan ini berada. Nilainya harus berupa kode negara 2 huruf ISO 3116; misalnya, Amerika Serikat adalah US dan Kanada adalah CA : <country>US</country> |
<id> | Required | string | ID unik untuk properti. Perhatikan bahwa setiap rental akomodasi harus memiliki ID yang unik untuk situs Anda, dan ID ini tidak boleh digunakan kembali. |
<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. |
<name> | Required | string | Nama properti. Maksimal 300 karakter. |
<address> | Required | Object or string | Lokasi fisik lengkap properti. Elemen ini menggunakan satu atribut, Setidaknya, Anda harus memberikan alamat, kota, negara bagian atau wilayah,
dan kode pos untuk properti. 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. |
Contoh listingan Rental Akomodasi
<?xml version="1.0" encoding="UTF-8"?> <listings> <language>en</language> <listing> <id>123456</id> <name>Apartment Name</name> <address format="simple"> <component name="addr1">18733 Clark Way</component> <component name="addr2">#C10</component> <component name="city">Mountain View</component> <component name="postal_code">94043</component> <component name="province">California</component> </address> <country>US</country> <latitude>37.4182515</latitude> <longitude>-122.0742354</longitude> <phone type="main">12345678</phone> <category>vacation_villa</category> <date day="21" month="12" year="2017"/> <content> <text type="description"> <link>https://list_url</link> <title>Description Title</title> <body>Description Body</body> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE</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="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com/123456</website> <client_attr name="capacity">7</client_attr> <client_attr name="cleaning_disinfection">Yes</client_attr> <client_attr name="min_days_between_stays">3</client_attr> <client_attr name="enhanced_cleaning_practices">Yes</client_attr> <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr> <client_attr name="number_of_bathrooms">2</client_attr> <client_attr name="number_of_bedrooms">3</client_attr> <client_attr name="number_of_beds">4</client_attr> <client_attr name="self_checkin_checkout">Yes</client_attr> <client_attr name="rating">4.8</client_attr> <client_attr name="rating_num">5373</client_attr> <client_attr name="rating_scale">5</client_attr> <client_attr name="ac">Yes</client_attr> <client_attr name="airport_shuttle">Yes</client_attr> <client_attr name="balcony">No</client_attr> <client_attr name="beach_access">Yes</client_attr> <client_attr name="check_in_time">15:00</client_attr> <client_attr name="check_out_time">11:00</client_attr> <client_attr name="child_friendly">Yes</client_attr> <client_attr name="crib">Unknown</client_attr> <client_attr name="elevator">Yes</client_attr> <client_attr name="fire_place">Unknown</client_attr> <client_attr name="free_breakfast">Yes</client_attr> <client_attr name="gym_fitness_equipment">Yes</client_attr> <client_attr name="heating">Yes</client_attr> <client_attr name="host_description">A short description about the host and their interests</client_attr> <client_attr name="host_name">The name of the host</client_attr> <client_attr name="host_language">en, da, el</client_attr> <client_attr name="host_response_rate">0.75</client_attr> <client_attr name="host_response_time">1 hour</client_attr> <client_attr name="hot_tub">Yes</client_attr> <client_attr name="instant_bookable">Yes</client_attr> <client_attr name="internet_type">Free</client_attr> <client_attr name="ironing_board">No</client_attr> <client_attr name="kitchen">Yes</client_attr> <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr> <client_attr name="license_num">Paris: 123456ABC</client_attr> <client_attr name="microwave">Yes</client_attr> <client_attr name="max_night_stay">7</client_attr> <client_attr name="min_days_advance_purchase">2</client_attr> <client_attr name="min_night_stay">3</client_attr> <client_attr name="number_of_living_rooms">1</client_attr> <client_attr name="outdoor_grill">No</client_attr> <client_attr name="oven_stove">Yes</client_attr> <client_attr name="parking_type">Free</client_attr> <client_attr name="patio">Unknown</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="pool_type">Indoors</client_attr> <client_attr name="private_beach_access">Unknown</client_attr> <client_attr name="room_type">Entire Place</client_attr> <client_attr name="refund_policy">The refund policy for the property</client_attr> <client_attr name="smoking_free_property">Yes</client_attr> <client_attr name="special_service_level">No</client_attr> <client_attr name="square_footage">1200</client_attr> <client_attr name="tv">Yes</client_attr> <client_attr name="washer_dryer">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> </attributes> </content> </listing> </listings>