Atribut

Halaman ini mencakup 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.

Jika item wajib berikut tidak disertakan, listingan akan otomatis dinonaktifkan:

  • Elemen turunan XML yang diperlukan: id, name, latitude, longitude, address.
  • Atribut yang diperlukan: capacity dan website. 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 unik untuk Rental Akomodasi.

Terakhir, jika 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 disetel ke No, Google memperlakukan listingan tersebut sebagai memiliki dapur. Atribut ini disebut "atribut tersimpulkan", dan hanya ditampilkan jika ada keyakinan tinggi terhadap akurasi inferensi.

<review>

Berisi ulasan pengguna atau ulasan editorial. Anda tidak perlu menyertakan semua ulasan untuk listingan di elemen <listing>. Elemen ini ditujukan agar Anda menyertakan ulasan terpilih yang menunjukkan 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? Deskripsi
type Required Jenis ulasan. Tetapkan ke salah satu nilai berikut:
  • editorial: Ulasan oleh situs atau otoritas peninjau lainnya.
  • user: Ulasan oleh pengguna akhir.

Elemen turunan

Elemen <review> memiliki elemen turunan berikut:

Elemen turunan Wajib? Jenis Deskripsi
<link> Optional string Link ke ulasan. Sertakan "http://" atau "https://" di 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 disebutkan.
<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:
  • day: Hari dalam sebulan; misalnya, "7".
  • month: Bulan, dengan 1 = Januari ... 12 = Desember.
  • year: Empat digit tahun; misalnya,"2023".

Misalnya, 7 Juni 2023 ditulis sebagai:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Khusus ulasan pengguna) Tanggal pengulas mengunjungi listingan yang sedang diulas. Formatnya sama dengan <date>.

Misalnya, 7 Juni 2023 ditulis sebagai:

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

Ulasan tanpa setidaknya bulan dan tahun yang terisi pada <servicedate> mungkin tidak ditampilkan. Hari tidak wajib diisi.

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>

Nilai untuk placeholder attribute_name

Tabel berikut memberikan daftar nilai yang valid untuk attribute_name di elemen <client_attr name="attribute_name">; namun, 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 Jumlah floating point yang mewakili rating properti gabungan. Jumlah 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 mungkin untuk properti. Misalnya, rating properti harus 3 atau 4 untuk rating_scale 5.

Catatan: Skala rating 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 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 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 2 pm atau 2:00 pm. Semua format lainnya tidak akan diurai 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 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 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. 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 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 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 wilayah 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 wajib ada:

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 akomodasi liburan 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 string or Object

Lokasi fisik lengkap properti sebagai string. Alamat harus menyertakan nama dan nomor jalan. Jika tidak ada, alamat harus menyertakan plus code. Nomor apartemen atau unit juga harus disertakan jika ada.

Atau, Anda dapat memberikan alamat "gabungan". Gunakan elemen turunan <component> untuk mendeskripsikan setiap bagian alamat berikut:

  • addr1: Alamat jalan utama.
  • addr2: Jika perlu, alamat jalan sekunder, termasuk nomor unit.
  • city: Kota.
  • province: Jika perlu, negara bagian, wilayah, atau provinsi.
  • postal_code: Kode pos.
  • country: Negara.

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:

  • Info yang berlebihan: Jangan sertakan informasi yang tidak relevan atau mengulangi komponen alamat.
  • Alamat jalan tidak ada: Alamat harus memiliki nama dan nomor jalan.

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>