Atribut

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 yang diperlukan berikut, listingan akan otomatis dinonaktifkan.

  • Elemen turunan XML yang diperlukan: id, name, latitude, longitude, address.
  • Atribut yang diperlukan: capacity dan website.

Untuk mengetahui detail tentang elemen turunan XML yang diperlukan, lihat elemen turunan XML.

Untuk informasi selengkapnya tentang Rental Akomodasi, lihat Atribut unik untuk Rental Akomodasi.

Terakhir, saat Google menentukan dari sumber lain bahwa nilai atribut berbeda dengan nilai yang ditentukan dalam feed untuk listingan rental akomodasi, kami akan menampilkan nilai untuk listingan. Misalnya, jika kita menentukan dari foto listingan bahwa listingan memiliki dapur, tetapi atribut kitchen tidak ada atau disetel ke No, kita akan memperlakukan listingan sebagai memiliki dapur. Atribut ini disebut "atribut yang disimpulkan", dan hanya akan ditampilkan jika kami sangat yakin dengan akurasi inferensi.

Nilai untuk placeholder attribute_name

Tabel ini menyediakan daftar nilai yang valid untuk attribute_name di elemen <client_attr name="attribute_name">; tetapi, partner dianjurkan untuk memberikan attribute_name tambahan yang mungkin mereka miliki.

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
website Required URL situs untuk properti. Free text
min_days_between_stays Optional (strongly recommended) Jumlah minimum "hari buffering" saat rental harus kosong setelah tamu sebelumnya pergi. Non-negative integer
enhanced_cleaning_practices Optional (strongly recommended) Apakah properti menggunakan praktik pembersihan yang ditingkatkan dengan deskripsi di situs partner. Yes/No/Unknown
partner_hygiene_link Optional (strongly recommended) Link ke situs partner eksternal yang memberikan informasi lebih lanjut tentang detail kebersihan listingan. Free text (the site's URL)
number_of_bathrooms Optional (strongly recommended) Jumlah kamar mandi. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Optional (strongly recommended) Jumlah kamar tidur. Non-negative integer value
number_of_beds Optional (strongly recommended) Jumlah tempat tidur di semua kamar. Non-negative integer value
self_checkin_checkout Optional (strongly recommended) Apakah properti mengizinkan check in dan check out mandiri. Yes/No/Unknown
rating Optional (strongly recommended) Bilangan floating point yang mewakili rating properti gabungan. Angka ini biasanya antara 0-5, 0-10, atau 0-100, tetapi Anda dapat menggunakan rentang apa pun yang merepresentasikan sistem rating Anda. Non-negative float value
rating_num Optional (strongly recommended) Jumlah rating yang dimiliki properti. Non-negative integer
ac Optional Apakah properti memiliki AC. Yes/No/Unknown
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
beach_access Optional Apakah properti memiliki akses ke pantai umum di dekat properti. Yes/No/Unknown
check_in_time Optional 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 diuraikan atau ditampilkan. Time
check_out_time Optional 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 diuraikan atau ditampilkan. Time
child_friendly Optional Apakah properti cocok untuk anak-anak. Yes/No/Unknown
crib Optional Apakah properti menyediakan tempat tidur bayi. Yes/No/Unknown
elevator Optional Apakah properti memiliki elevator. Yes/No/Unknown
fire_place Optional Apakah properti memiliki perapian. Yes/No/Unknown
free_breakfast Optional Apakah properti menyertakan sarapan gratis. Yes/No/Unknown
gym_fitness_equipment Optional Apakah properti memiliki gym atau alat kebugaran. Yes/No/Unknown
heating Optional Apakah properti memiliki sistem pemanas. Yes/No/Unknown
hot_tub Optional Apakah properti memiliki bak mandi air panas. Yes/No/Unknown
instant_bookable Optional Apakah properti dapat langsung dipesan melalui proses checkout. Alternatifnya sedang menunggu persetujuan. Yes/No/Unknown
ironing_board Optional Apakah properti menyediakan papan setrika. Yes/No/Unknown
kitchen Optional Apakah properti memiliki dapur. Yes/No/Unknown
license_num Optional Nomor izin usaha (wisata atau bisnis) wajib ditampilkan untuk properti di wilayah tertentu di dunia. Ini dapat diulangi dan, jika ada beberapa lisensi, sebaiknya tambahkan otoritas lisensi sebagai konteks; misalnya: "Paris: 123456ABC". Free text
microwave Optional Apakah properti menyediakan microwave. Yes/No/Unknown
minimum_days_advance_purchase Optional Jumlah minimum hari sebelumnya saat properti dapat dipesan. Non-negative integer
minimum_night_stay Optional Jumlah malam minimum yang dapat dipesan tamu di properti. Positive integer (more than zero)
max_night_stay Optional Jumlah maksimum malam yang dapat dipesan tamu di properti. Positive integer (more than zero)
number_of_living_rooms Optional Jumlah ruang keluarga. Non-negative integer value
outdoor_grill Optional Apakah properti memiliki pemanggang. Yes/No/Unknown
oven_stove Optional Apakah properti memiliki kompor. Yes/No/Unknown
parking_type Optional Jenis tempat parkir yang tersedia di properti. Free/Paid/None
patio Optional Apakah properti memiliki teras. Yes/No/Unknown
pets_allowed Optional Beberapa atau semua kamar mengizinkan tamu membawa hewan peliharaan, yaitu atau kucing yang bukan hewan pendamping. Yes/No/Unknown
pool_type Optional Jenis kolam renang (akses kolam renang) yang dimiliki properti. Indoors, Outdoors, Indoors/Outdoors, None
private_beach_access Optional Apakah properti memiliki akses khusus ke pantai non-publik. Yes/No/Unknown
room_type Optional Jenis properti yang dibagikan kepada Google.

Catatan: Untuk saat ini, hanya menerima seluruh tempat.

Entire Place, Shared room, Private Room
smoking_free_property Optional Apakah properti bebas asap rokok atau dilarang merokok. Yes/No/Unknown
square_footage Optional Luas properti dalam kaki persegi. Non-negative float value
square_meters Optional Luas properti dalam meter persegi. Non-negative float
tv Optional Apakah properti memiliki TV. Yes/No/Unknown
washer_dryer Optional Apakah properti memiliki peralatan laundry. Yes/No/Unknown
wheelchair_accessible Optional Apakah properti dapat diakses dengan kursi roda. Yes/No/Unknown
internet_type Optional Jenis akses internet Wi-Fi yang disediakan oleh properti. Free/Paid/None
host_language Optional Bahasa yang dapat digunakan penyelenggara. Daftar kode bahasa yang dipisahkan koma; misalnya: de, en

Elemen turunan XML

Elemen turunan XML berikut diperlukan:

Elemen turunan Wajib diisi? Jenis Deskripsi
<country> Optional (strongly recommended) string Negara tempat listingan ini berada. Nilainya harus berupa kode negara 2 huruf besar 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, format, yang harus Anda tetapkan ke simple.

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

  • addr1: Alamat utama properti.
  • addr2: Alamat sekunder, termasuk nomor unit, jika diperlukan.
  • addr3: Bagian ketiga dari alamat, termasuk nomor unit, jika diperlukan.
  • city: Nama kota properti.
  • province: Nama negara bagian, wilayah, atau provinsi properti.
  • postal_code: Kode pos properti.

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="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="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="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="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="smoking_free_property">Yes</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>