แอตทริบิวต์

หน้านี้อธิบายรายละเอียด ค่า และข้อกําหนดสําหรับแอตทริบิวต์และองค์ประกอบย่อย ค่าเหล่านี้ใช้กับที่พักแบบให้เช่าเท่านั้น

โครงสร้าง XML ทั่วไปมีรูปแบบคล้ายกับฟีดข้อมูลโรงแรม ดูข้อมูลอ้างอิง XML ของข้อมูลโรงแรม

การไม่ใส่ข้อมูลที่จำเป็นต่อไปนี้จะปิดใช้ข้อมูลโดยอัตโนมัติ

  • องค์ประกอบย่อย XML ที่ต้องระบุ: id, name, latitude, longitude, address
  • แอตทริบิวต์ที่ต้องระบุ ได้แก่ capacity และ website โปรดดูลิงก์โดยตรงของที่พักให้เช่าในฟีดข้อมูล ซึ่งเปิดโอกาสให้ผู้ใช้เข้าชมเว็บไซต์ของที่พัก

ดูรายละเอียดขององค์ประกอบย่อย XML ที่จำเป็นได้ที่องค์ประกอบย่อย XML

ดูข้อมูลเพิ่มเติมเกี่ยวกับที่พักให้เช่าได้ที่แอตทริบิวต์เฉพาะของที่พักให้เช่า

สุดท้าย เมื่อ Google พิจารณาจากแหล่งที่มาอื่นๆ ว่าค่าของแอตทริบิวต์แตกต่างจากที่ระบุไว้ในฟีดสำหรับข้อมูลที่พักให้เช่า Google จะแสดงค่าสำหรับข้อมูลดังกล่าว ตัวอย่างเช่น หาก Google พิจารณาจากรูปภาพของข้อมูลว่ามีห้องครัว แต่ไม่มีแอตทริบิวต์ kitchen หรือตั้งค่าเป็น No ระบบจะถือว่าข้อมูลมีห้องครัว แอตทริบิวต์เหล่านี้เรียกว่า "แอตทริบิวต์ที่อิงตามข้อมูลที่มีอยู่" และจะแสดงเฉพาะในกรณีที่มีความมั่นใจสูงในความแม่นยำของการอนุมาน

ค่าสำหรับตัวยึดตําแหน่ง attribute_name

ตารางต่อไปนี้แสดงรายการค่าที่ถูกต้องสำหรับ attribute_name ในองค์ประกอบ <client_attr name="attribute_name"> แต่เราขอแนะนำให้คุณระบุ attribute_name เพิ่มเติมหากมี

ค่าสำหรับ attribute_name จำเป็นหรือไม่ คำอธิบาย ค่าเนื้อหาที่ถูกต้อง
capacity Required จํานวนแขกสูงสุดซึ่งที่พักรองรับได้ ค่านี้ควรเท่ากับหรือมากกว่า "number_of_bedrooms" Non-negative integer value
website Required URL ของเว็บไซต์สำหรับพร็อพเพอร์ตี้ Free text
partner_hygiene_link Strongly recommended ลิงก์ไปยังเว็บไซต์พาร์ทเนอร์ภายนอกที่ให้ข้อมูลเพิ่มเติมเกี่ยวกับรายละเอียดด้านสุขอนามัยของที่พัก Free text (the site's URL)
number_of_bathrooms Strongly recommended จำนวนห้องน้ำ Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended จำนวนห้องนอน Non-negative integer value
number_of_beds Strongly recommended จำนวนเตียงในทุกห้อง Non-negative integer value
self_checkin_checkout Recommended ที่พักอนุญาตให้เช็คอินและเช็คเอาต์ด้วยตนเองหรือไม่ Yes/No/Unknown
rating Strongly recommended จำนวนลอยตัวที่แสดงการจัดอันดับที่พักโดยรวม ตัวเลขนี้มักอยู่ระหว่าง 0-5, 0-10 หรือ 0-100 แต่คุณจะใช้ช่วงใดก็ได้ที่แสดงระบบการให้คะแนนของคุณ Non-negative float value
rating_num Strongly recommended จํานวนการให้คะแนนของที่พัก Non-negative integer value
rating_scale Strongly recommended คะแนนสูงสุดที่เป็นไปได้สำหรับที่พัก เช่น คะแนนของที่พักควรเป็น 3 หรือ 4 สำหรับ rating_scale 5

หมายเหตุ: rating_scale เริ่มต้นคือ 0-10 หากไม่ได้ระบุ

Non-negative integer value
instant_bookable Strongly recommended ที่พักพร้อมให้จองทันทีในขั้นตอนชำระเงินหรือไม่ หรือต้องรอการอนุมัติก่อน Yes/No/Unknown
description Strongly recommended ข้อความรูปแบบอิสระที่อธิบายคุณภาพที่เป็นเอกลักษณ์ของที่พัก Free text
category Strongly recommended ประเภทที่พัก เช่น วิลล่า บังกะโล กระท่อม หรืออพาร์ตเมนต์ Free text
ac Recommended ที่พักมีเครื่องปรับอากาศหรือไม่ Yes/No/Unknown
beach_access Recommended ที่พักมีทางเข้าถึงชายหาดสาธารณะที่อยู่ใกล้กับที่พักหรือไม่ Yes/No/Unknown
check_in_time Recommended ช่วงเวลาของวันที่แน่นอนสำหรับการเช็คอินเข้าที่พัก ระบบยอมรับรูปแบบ HHMM, HH:MM หรือ HH:MM:SS เช่น ใช้ 14:00 แทน 14:00 น. หรือ 14:00 น. ระบบจะไม่แยกวิเคราะห์หรือแสดงรูปแบบอื่นๆ ทั้งหมด Time
check_out_time Recommended ช่วงเวลาของวันที่แน่นอนสำหรับการเช็คเอาต์ออกจากที่พัก ระบบยอมรับรูปแบบ HHMM, HH:MM หรือ HH:MM:SS เช่น ใช้ 11:00 แทน 11:00 น. หรือ 11:00 น. ระบบจะไม่แยกวิเคราะห์หรือแสดงรูปแบบอื่นๆ ทั้งหมด Time
child_friendly Recommended ที่พักเหมาะสำหรับเด็กหรือไม่ Yes/No/Unknown
crib Recommended ที่พักมีเตียงเด็กหรือไม่ Yes/No/Unknown
elevator Recommended ที่พักมีลิฟต์หรือไม่ Yes/No/Unknown
gym_fitness_equipment Recommended ที่พักมียิมหรืออุปกรณ์ฟิตเนสหรือไม่ Yes/No/Unknown
heating Recommended ที่พักมีระบบทำความร้อนหรือไม่ Yes/No/Unknown
hot_tub Recommended ที่พักมีอ่างน้ำร้อนหรือไม่ Yes/No/Unknown
ironing_board Recommended ที่พักมีที่รองรีดผ้าหรือไม่ Yes/No/Unknown
kitchen Recommended ที่พักมีห้องครัวหรือไม่ Yes/No/Unknown
microwave Recommended ที่พักมีไมโครเวฟหรือไม่ Yes/No/Unknown
min_days_advance_purchase Recommended จำนวนวันขั้นต่ำที่จองที่พักล่วงหน้าได้ Non-negative integer value
min_night_stay Recommended จำนวนคืนขั้นต่ำที่แขกจองที่พักได้ Positive integer (more than zero)
max_night_stay Recommended จำนวนคืนสูงสุดที่แขกจองที่พักได้ Positive integer (more than zero)
outdoor_grill Recommended ที่พักมีเตาปิ้งย่างหรือไม่ Yes/No/Unknown
oven_stove Recommended ที่พักมีเตาหรือไม่ Yes/No/Unknown
parking_type Recommended ประเภทของที่จอดรถในที่พัก Free/Paid/None
patio Recommended ที่พักมีเฉลียงหรือไม่ Yes/No/Unknown
pets_allowed Recommended ห้องบางห้องหรือทุกห้องอนุญาตให้แขกนําสัตว์เลี้ยง (สุนัขหรือแมวที่ไม่ใช่สัตว์ช่วยเหลือผู้พิการ) เข้าพักด้วยได้ Yes/No/Unknown
pool_type Recommended ประเภทสระว่ายน้ำ (การเข้าถึงสระว่ายน้ำ) ที่ที่พักมี Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended ประเภทห้องพัก ENTIRE_PLACE เป็นค่าเดียวที่รองรับ ENTIRE_PLACE
smoking_free_property Recommended ที่พักปลอดบุหรี่หรือไม่ Yes/No/Unknown
special_service_level Recommended ระดับบริการของข้อมูลมีจุดพิเศษในลักษณะใดลักษณะหนึ่งหรือไม่ เช่น verified, luxury, premium Yes/No/Unknown
square_footage Recommended พื้นที่ของที่พักในหน่วยตารางฟุต Non-negative float value
square_meters Recommended พื้นที่ของที่พักในหน่วยตารางเมตร Non-negative float
tv Recommended ที่พักมีทีวีหรือไม่ Yes/No/Unknown
washer_dryer Recommended ที่พักมีอุปกรณ์ซักรีดหรือไม่ Yes/No/Unknown
wheelchair_accessible Recommended ที่พักรองรับเก้าอี้รถเข็นหรือไม่ Yes/No/Unknown
internet_type Recommended ประเภทการเข้าถึงอินเทอร์เน็ต Wi-Fi ที่ที่พักมีให้ Free/Paid/None
airport_shuttle Optional ที่พักมีบริการรับส่งจากสนามบินหรืออาคารผู้โดยสารอื่นๆ หรือไม่ Yes/No/Unknown
balcony Optional ที่พักมีระเบียงหรือไม่ Yes/No/Unknown
fire_place Optional ที่พักมีเตาผิงหรือไม่ Yes/No/Unknown
free_breakfast Optional ที่พักรวมอาหารเช้าฟรีหรือไม่ Yes/No/Unknown
host_description Optional คำอธิบายของเจ้าของที่พักให้เช่า Free text
host_language Optional ภาษาที่เจ้าของที่พักพูดได้ รายการรหัสภาษาที่คั่นด้วยคอมมา เช่น de, en
host_name Optional ชื่อของเจ้าของที่พักให้เช่า Free text
host_response_rate Optional อัตราการตอบกลับโดยเฉลี่ยของโฮสต์ Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional เวลาในการตอบกลับโดยเฉลี่ยของโฮสต์ Free text
license_num Optional ต้องแสดงหมายเลขใบอนุญาต (นักท่องเที่ยวหรือธุรกิจ) สำหรับที่พักในบางภูมิภาคของโลก ซึ่งอาจมีหมายเลขซ้ำได้ และหากมีใบอนุญาตหลายใบ เราขอแนะนำให้เพิ่มหน่วยงานที่ออกใบอนุญาตเป็นบริบท (เช่น "ปารีส: 123456ABC") Free text
number_of_half_bathrooms Optional จำนวนห้องน้ำครึ่งห้อง Non-negative integer value
number_of_living_rooms Optional จำนวนห้องนั่งเล่น Non-negative integer value
private_beach_access Optional ที่พักมีทางเฉพาะสำหรับเข้าถึงชายหาดส่วนตัวหรือไม่ Yes/No/Unknown
refund_policy Optional นโยบายการคืนเงินสำหรับที่พัก Free text

องค์ประกอบย่อย XML

องค์ประกอบย่อย XML ต่อไปนี้เป็นองค์ประกอบที่จำเป็น

องค์ประกอบย่อย จำเป็นหรือไม่ ประเภท คำอธิบาย
<country> Strongly recommended string ประเทศที่โรงแรมแห่งนี้ตั้งอยู่ ค่าต้องเป็นรหัสประเทศ ISO 3116 แบบ 2 ตัวอักษร เช่น สหรัฐอเมริกาคือ US และแคนาดาคือ CA 
    <country>US</country>
<id> Required string ตัวระบุที่ไม่ซ้ำกันของที่พัก โปรดทราบว่าที่พักให้เช่าแต่ละแห่งต้องมีรหัสที่ไม่ซ้ำกันสำหรับเว็บไซต์ของคุณ และไม่ควรใช้รหัสนี้ซ้ำ
<latitude> Required float ละติจูดที่ตรงกับสถานที่ตั้งของโรงแรม เช่น 
    <latitude>37.423738</latitude>

คุณสร้างค่านี้ได้ด้วยเครื่องมือการเข้ารหัสพิกัดภูมิศาสตร์เช่น Google Maps API
<longitude> Required float ลองจิจูดที่ตรงกับสถานที่ตั้งของโรงแรม เช่น 
    <longitude>-122.090101</longitude>

คุณสร้างค่านี้ได้ด้วยเครื่องมือการเข้ารหัสพิกัดภูมิศาสตร์เช่น Google Maps API
<name> Required string ชื่อที่พัก ไม่เกิน 300 อักขระ
<address> Required string or Object

สถานที่ตั้งจริงของที่พักเป็นสตริง ที่อยู่ต้องมีชื่อและเลขที่ถนน หากไม่มีรหัสไปรษณีย์ ที่อยู่ควรมี Plus Code และต้องระบุหมายเลขอพาร์ตเมนต์หรือหมายเลขห้องด้วย (หากมี)

หรือจะระบุที่อยู่แบบ "คอมโพสิต" ก็ได้ ใช้องค์ประกอบย่อย <component> เพื่ออธิบายแต่ละส่วนของที่อยู่ดังต่อไปนี้

  • addr1: ที่อยู่หลัก
  • addr2: ที่อยู่สำรอง รวมถึงเลขที่ หากจำเป็น
  • city: เมือง
  • province: รัฐ ภูมิภาค หรือจังหวัด (หากจำเป็น)
  • postal_code: รหัสไปรษณีย์
  • country: ประเทศ

โปรดทราบว่าตู้ ปณ. หรือที่อยู่ทางไปรษณีย์อื่นๆ สำหรับส่งจดหมายเพียงอย่างเดียวไม่ถือว่าเป็นที่อยู่จริง

ต่อไปนี้คือตัวอย่างที่อยู่ที่สมบูรณ์

<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>

ต่อไปนี้คือตัวอย่างที่อยู่ที่สมบูรณ์โดยใช้ Plus Code

<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>

หลีกเลี่ยงสิ่งต่อไปนี้

  • ข้อมูลซ้ำ: อย่าใส่ข้อมูลที่ไม่เกี่ยวข้องหรือองค์ประกอบที่อยู่ซ้ำ
  • ไม่มีที่อยู่: ที่อยู่ต้องมีชื่อและเลขที่ถนน

ตัวอย่างข้อมูลที่พักให้เช่า

<?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>