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 mirip dengan feed listingan Hotel. Lihat Referensi XML daftar hotel.
Kegagalan untuk menyertakan item wajib berikut akan otomatis menonaktifkan listingan:
- Elemen turunan XML yang diperlukan:
id
,name
,latitude
,longitude
,address
. - Atribut yang diperlukan:
capacity
danwebsite
. Lihat Link langsung rental akomodasi di feed listingan Anda. Hal ini memberi pengguna kesempatan untuk mengunjungi situs properti.
Untuk mengetahui detail elemen turunan XML yang diperlukan, lihat elemen turunan XML.
Untuk mengetahui informasi selengkapnya tentang Rental Akomodasi, lihat Atribut yang unik untuk Rental Akomodasi.
Terakhir, saat Google menentukan dari sumber lain bahwa nilai
atribut berbeda dengan
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 ditetapkan ke No
,
Google akan memperlakukan listingan tersebut sebagai memiliki dapur. Atribut ini disebut
"atribut yang disimpulkan", dan hanya ditampilkan jika ada keyakinan tinggi
terhadap akurasi inferensi.
Nilai untuk placeholder attribute_name
Tabel berikut memberikan daftar nilai yang valid untuk attribute_name
di elemen <client_attr name="attribute_name">
; tetapi, sebaiknya Anda memberikan attribute_name
tambahan jika tersedia.
Nilai untuk attribute_name |
Wajib? | Deskripsi | Nilai konten yang valid |
---|---|---|---|
capacity | Required | Jumlah maksimum tamu yang dapat diakomodasi properti. Nilai ini harus sama dengan atau lebih besar dari "number_of_bedrooms". | 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 lebih lanjut terkait 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 | Bilangan 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 yang dapat diberikan untuk properti. Misalnya, rating properti
harus 3 atau 4 untuk rating_scale 5.
Catatan: rating_scale default adalah 0-10 jika tidak ditentukan. |
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 bebas yang menjelaskan kualitas unik properti | Free text |
category | Strongly recommended | Jenis properti, seperti vila, bungalow, kabin, atau apartemen | Free text |
ac | Recommended | Apakah properti memiliki AC. | Yes/No/Unknown |
beach_access | Recommended | Apakah properti memiliki akses ke pantai umum di dekat properti. | Yes/No/Unknown |
check_in_time | Recommended | Waktu persis saat 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 lainnya tidak akan diuraikan atau ditampilkan. | Time |
check_out_time | Recommended | Waktu persis saat 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 lainnya tidak akan diuraikan 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 perlengkapan 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 minimum hari sebelum properti dapat dipesan. | Non-negative integer value |
min_night_stay | Recommended | Jumlah minimum malam 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— atau kucing yang bukan hewan pemandu—dengan mereka. | Yes/No/Unknown |
pool_type | Recommended | Jenis kolam renang (akses kolam renang) yang dimiliki properti. | Indoors, Outdoors, Indoors/Outdoors, None |
room_type | Recommended | Jenis kamar. ENTIRE_PLACE adalah satu-satunya nilai yang didukung. |
ENTIRE_PLACE
|
smoking_free_property | Recommended | Apakah properti bebas asap rokok atau tidak diizinkan merokok. | Yes/No/Unknown |
special_service_level | Recommended | Apakah tingkat layanan listingan bersifat khusus.
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 menyertakan sarapan gratis. | Yes/No/Unknown |
host_description | Optional | Deskripsi host rental akomodasi. | Free text |
host_language | Optional | Bahasa yang dapat digunakan oleh pengurus hotel. | Daftar yang dipisahkan koma untuk
kode
bahasa; misalnya: de , en |
host_name | Optional | Nama host rental akomodasi. | Free text |
host_response_rate | Optional | Rasio 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) wajib ditampilkan untuk properti di daerah tertentu di dunia. Ini dapat diulangi dan, jika ada beberapa izin usaha, sebaiknya tambahkan otoritas pemberi izin 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 diperlukan:
Elemen turunan | Wajib? | 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. Maksimum 300 karakter. |
<address> | Required | string or Object | Lokasi fisik lengkap properti sebagai string. Alamat harus menyertakan nama dan nomor jalan. Jika tidak ada, alamat harus menyertakan kode plus. Nomor apartemen atau unit juga harus disertakan jika ada. Atau, Anda dapat memberikan alamat "gabungan". Gunakan elemen turunan
Perhatikan bahwa P.O. box atau alamat khusus surat lainnya tidak dianggap sebagai alamat fisik lengkap. Berikut adalah contoh alamat lengkap: <address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address> <address> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Apt. 2</component> <component name="city">Nottingham </component> <component name="postal_code">NG8 6FT</component> <component name="country">UK</component> </address> Berikut adalah contoh alamat lengkap menggunakan kode plus: <address>XQHM+7VF Nottingham NG8 6FT, UK/address> <address> <component name="addr1">XQHM+7VF</component> <component name="city">Nottingham </component> <component name="postal_code">NG8 6FT</component> <component name="country">UK</component> </address> Hindari hal berikut:
|
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>