หน้านี้ครอบคลุมคำอธิบาย ค่า และข้อกำหนดสำหรับแอตทริบิวต์และองค์ประกอบย่อย ค่าเหล่านี้มีผลเฉพาะกับที่พักสำหรับที่พักให้เช่าเท่านั้น
โครงสร้าง XML ทั่วไปมีรูปแบบคล้ายกับฟีดข้อมูลโรงแรม ดูข้อมูลอ้างอิง XML ของข้อมูลโรงแรม
การไม่ใส่รายการที่จำเป็นต่อไปนี้จะเป็นการปิดใช้รายชื่อโดยอัตโนมัติ
- องค์ประกอบย่อยของ XML ที่จำเป็น:
id
,name
,latitude
,longitude
,address
- แอตทริบิวต์ที่จำเป็น:
capacity
และwebsite
- ดูลิงก์เว็บไซต์โดยตรงไปยังพร็อพเพอร์ตี้ในฟีดข้อมูล ซึ่งเป็นการเปิดโอกาสให้ผู้ใช้เข้าชมเว็บไซต์ของที่พัก
โปรดดูรายละเอียดเกี่ยวกับองค์ประกอบย่อย XML ที่จำเป็นในองค์ประกอบย่อย XML
ดูข้อมูลเพิ่มเติมเกี่ยวกับที่พักให้เช่าได้ที่แอตทริบิวต์เฉพาะของที่พักให้เช่า
สุดท้าย เมื่อ Google พิจารณาจากแหล่งที่มาอื่นๆ ว่าค่าของแอตทริบิวต์แตกต่างจากที่ระบุในฟีดสำหรับข้อมูลที่พักให้เช่า เราจะแสดงค่าดังกล่าว เช่น หากเราพิจารณาจากรูปภาพของรายชื่อว่ามีห้องครัว แต่แอตทริบิวต์ kitchen
ขาดหายไปหรือตั้งค่าเป็น No
เราจะถือว่าข้อมูลมีห้องครัว แอตทริบิวต์เหล่านี้เรียกว่า "แอตทริบิวต์ที่อนุมาน" และจะแสดงก็ต่อเมื่อเรามั่นใจมากในความถูกต้องของการอนุมาน
ค่าสำหรับตัวยึดตำแหน่งattribute_name
ตารางต่อไปนี้แสดงรายการค่าที่ถูกต้องสำหรับ attribute_name
ในองค์ประกอบ <client_attr name="attribute_name">
แต่เราขอแนะนำให้คุณระบุ attribute_name
เพิ่มเติมหากมี
ค่าสำหรับ attribute_name |
จำเป็นหรือไม่ | คำอธิบาย | ค่าเนื้อหาที่ถูกต้อง |
---|---|---|---|
capacity | Required | จำนวนแขกสูงสุดที่ที่พักรองรับได้ ค่านี้ควรเท่ากับหรือมากกว่า "number_of_doors" | 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 | การจัดประเภทสูงสุดที่เป็นไปได้สำหรับพร็อพเพอร์ตี้ | 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 |
minimum_days_advance_purchase | Recommended | จำนวนวันขั้นต่ำที่จองที่พักล่วงหน้าได้ | Non-negative integer value |
minimum_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 |
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 | Object or string | สถานที่ตั้งจริงของที่พัก องค์ประกอบนี้ใช้แอตทริบิวต์ คุณต้องระบุที่อยู่ เมือง รัฐ หรือภูมิภาค และรหัสไปรษณีย์ของที่พักเป็นอย่างน้อย ใช้องค์ประกอบย่อย
เช่น <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> หรือคุณจะระบุที่อยู่ "รูปแบบอิสระ" ก็ได้ แต่เราไม่แนะนำวิธีนี้ เช่น <address>6 Elm Ave Unit 3, Boston, MA, 02472</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="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>