ข้อมูลโรงแรมคือไฟล์ XML อย่างน้อย 1 ไฟล์ที่แสดงโรงแรมทั้งหมดที่คุณจะ ให้ข้อมูลราคา ตัวไฟล์ข้อมูลโรงแรมไม่มีการตั้งราคา
องค์ประกอบรูทของข้อมูลโรงแรมคือองค์ประกอบ <listings>
ที่มี
องค์ประกอบ <listing>
ที่อธิบายที่พัก
คุณสร้างข้อมูลโรงแรมซึ่งเป็นส่วนหนึ่งของการใช้งานเริ่มต้น แล้วเพิ่มหรือนำโรงแรมออกโดยเป็นส่วนหนึ่งของการบำรุงรักษาตามปกติ
ตรวจสอบว่าไฟล์เป็นไปตามหลักเกณฑ์ไวยากรณ์
เช่น ใช้การเข้ารหัสแบบ UTF-8 และระบุสคีมาการเข้ารหัสนี้โดยใส่
แอตทริบิวต์ encoding
ในแท็ก XML
หลังจากสร้างข้อมูลโรงแรมแล้ว คุณสามารถอัปโหลดข้อมูลไปยัง Google ด้วยตนเองโดยใช้โรงแรม ตรงกลางหรือโฮสต์ไว้ใน เซิร์ฟเวอร์
ค้นหาและแก้ไขปัญหาเกี่ยวกับข้อมูล
หากต้องการค้นหาและแก้ไขปัญหาของข้อมูลในข้อมูลโรงแรม โปรดอ่านบทความต่อไปนี้
ข้อกำหนดของข้อมูล
ที่พักในข้อมูลโรงแรมต้องมีลักษณะดังนี้จึงจะมีสิทธิ์ใช้ Google Hotel Ads มีสิ่งต่อไปนี้
- ห้องที่แขกที่ชำระเงินเข้าพักได้
- มีสถานที่ตั้งจริงและสถานที่ตั้งตายตัวซึ่งเปิดให้สาธารณชนเข้าชม
- ผนังและท่อประปาคงที่
- ข้อกําหนดการเข้าพักขั้นต่ำต้องไม่เกิน 7 วัน
ตัวอย่างที่พบบ่อยสำหรับที่พักที่ไม่มีสิทธิ์ ได้แก่ การล่องเรือและ
เนื่องจากมักจะไม่เป็นไปตามเกณฑ์Listing requirements
กระท่อมตั้งแคมป์และสถานที่ตั้งแคมป์อื่นๆ ที่มีผนังยึด ท่อประปา และระบบควบคุมอุณหภูมิ (รวมถึงเตาไม้หรือเครื่องทำความร้อนที่ใช้แก๊ส) จะมีสิทธิ์ใช้ ที่พักกลางแจ้งที่ไม่มีสิทธิ์ ได้แก่
- จุดตั้งแคมป์ที่แขกพักในเต็นท์
- ที่จอดรถบ้านที่แขกนำรถบ้านมาเอง
<listings>
<listings>
เป็นองค์ประกอบรูทของข้อมูลโรงแรมและมีองค์ประกอบ
องค์ประกอบ <language>
และ <listing>
อย่างน้อย 1 รายการ
องค์ประกอบ <listings>
จะปรากฏในตำแหน่งต่อไปนี้ในข้อมูลโรงแรม
ลำดับชั้น XML:
+ <listings>
+ <language>
+ <datum>
+ <listing>
ไวยากรณ์
องค์ประกอบ <listings>
ใช้ไวยากรณ์ต่อไปนี้
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
xsi:noNamespaceSchemaLocation="schema_xsd">
<language> language_code</language>
<datum> datum_code </datum>
<listing> listing</listing>
...
</listings>
Attributes
องค์ประกอบ <listings>
มีแอตทริบิวต์ต่อไปนี้
แอตทริบิวต์ | จำเป็นหรือไม่ | คำอธิบาย |
---|---|---|
xmlns:xsi |
ต้องระบุ | ตั้งค่าเป็น http://www.w3.org/2001/XMLSchema-instance |
xsi:noNamespaceSchemaLocation |
ต้องระบุ | ตั้งค่าเป็น http://www.gstatic.com/localfeed/local_feed.xsd |
องค์ประกอบลูก
องค์ประกอบ <listings>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | จำเป็นหรือไม่ | ประเภท | คำอธิบาย |
---|---|---|---|
<language> | Required | string | ภาษาที่ใช้เขียนฟีด กำหนดค่าของข้อมูลนี้
ลงใน
รหัสภาษาแบบ 2 ตัวอักษร เช่น en สำหรับภาษาอังกฤษ |
<datum> | Optional | enum | องค์ประกอบนี้ระบุข้อมูลทางภูมิศาสตร์หรือรูปแบบอ้างอิงสำหรับ
พิกัดละติจูด/ลองจิจูดที่ให้ไว้ในฟีด หากไม่มีข้อมูลมูลฐาน
ค่าเริ่มต้นสำหรับองค์ประกอบนี้คือ WGS84
ซึ่งอุปกรณ์ GPS รุ่นใหม่ส่วนใหญ่ใช้กัน มูลฐานโตเกียวมีไว้สำหรับ
ในญี่ปุ่น
ค่าที่ถูกต้องสำหรับองค์ประกอบนี้คือ
WGS84 ไม่ต้องระบุ
องค์ประกอบ <datum> ในข้อมูลโรงแรม
|
<listing> | Required | <listing> |
อย่างน้อย 1 รายการที่อธิบายถึงแต่ละโรงแรมในฟีด โปรดทราบว่า โรงแรมแต่ละแห่งในรายการต้องมีรหัสเฉพาะสำหรับเว็บไซต์ของคุณ และ ว่าไม่ควรใช้รหัสนี้ซ้ำ |
ตัวอย่าง
ที่อยู่แบบมีโครงสร้าง
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนแบบมีโครงสร้าง ที่อยู่:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<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>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
ที่อยู่รูปแบบอิสระ
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีรูปแบบอิสระ ที่อยู่:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
เนื้อหาที่ไม่บังคับ
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีข้อมูล
มี <content>
ที่ไม่บังคับดังนี้
<?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>
<listing>
คำจำกัดความโรงแรมภายในองค์ประกอบ <listings>
ของข้อมูลโรงแรม
องค์ประกอบ <listing>
จะปรากฏในตำแหน่งต่อไปนี้ในข้อมูลโรงแรม
ลำดับชั้น XML ของฟีด:
+ <listings>
+ <language>
+ <listing>
ไวยากรณ์
องค์ประกอบ <listing>
ใช้ไวยากรณ์ต่อไปนี้
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<!-- Specify <listing>'s child elements in the order shown below. -->
<id>hotel_ID</id>
<name>hotel_name</name>
<address>
<component name="addr1">street_address_1</component>
<component name="addr2">street_address_2</component>
<component name="city">city_name</component>
<component name="province">province_name</component>
<component name="postal_code">postal_code</component>
</address>
<!-- You can also define an address freeform, although this is not recommended: -->
<!-- <address>freeform_address</address> -->
<country>country_code</country>
<latitude>hotel_latitude</latitude>
<longitude>hotel_longitude</longitude>
<phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>content</content>
</listing>
</listings>
Attributes
องค์ประกอบ <listing>
ไม่มีแอตทริบิวต์
องค์ประกอบลูก
องค์ประกอบ <listing>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | จำเป็นหรือไม่ | ประเภท | คำอธิบาย |
---|---|---|---|
<id> | Required | string | ตัวระบุที่ไม่ซ้ำกันสําหรับโรงแรม
หมายเหตุ: ค่านี้ต้องไม่ซ้ำกับเว็บไซต์ของผู้อื่นตลอดเวลา ควรทำ ไม่ใช้รหัสซ้ำ เพราะอาจทำให้เกิดปัญหาเมื่อพยายาม แก้ปัญหาการจับคู่ที่พัก |
<name> | Required | string | ชื่อโรงแรม ดังตัวอย่างต่อไปนี้
<name>Belgrave House</name> |
<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> โปรดทราบว่า กล่องหรือที่อยู่ไปรษณีย์อื่นๆ เท่านั้นไม่ใช่ ที่อยู่จริงที่ถือเป็นที่อยู่จริง |
<country> | Required | string | ประเทศที่ข้อมูลนี้ตั้งอยู่ ค่าต้องเป็น
รหัสประเทศแบบ 2 ตัวอักษร
เช่น สหรัฐอเมริกาคือ "US" และแคนาดาคือ "CA" ดังตัวอย่างต่อไปนี้
<country>US</country> |
<latitude> | Required* | float | ละติจูดที่ตรงกับสถานที่ตั้งของโรงแรม สำหรับ
ตัวอย่าง:
<latitude>37.423738</latitude> คุณสามารถสร้างค่านี้ได้ด้วยเครื่องมือการเข้ารหัสพิกัดภูมิศาสตร์ เช่น Google แผนที่ API |
<longitude> | Required* | float | ลองจิจูดที่ตรงกับสถานที่ตั้งของโรงแรม สำหรับ
ตัวอย่าง:
<longitude>-122.090101</longitude> คุณสามารถสร้างค่านี้ได้ด้วยเครื่องมือการเข้ารหัสพิกัดภูมิศาสตร์ เช่น Google แผนที่ API |
<location_precision> | Optional | integer | ความแม่นยำของตำแหน่งที่พักที่ส่งเป็นหน่วยเมตรเมื่อละติจูดและลองจิจูดของที่พักมีการปรับให้ยากต่อการอ่าน (Obfuscate) ศูนย์ (0) หมายถึงไม่มีการปรับให้ยากต่อการอ่าน (Obfuscation) และเป็นตำแหน่งที่ถูกต้อง หมายเหตุ: องค์ประกอบนี้ใช้กับที่พักให้เช่าเท่านั้น |
<phone> | Required* | string | หมายเลขติดต่อของโรงแรมอย่างน้อย 1 รายการ หากข้อมูลเป็นธุรกิจ สาขา โปรดระบุหมายเลขโทรศัพท์ของสาขา (ไม่ใช่หมายเลขโทรศัพท์ของสำนักงานใหญ่ส่วนกลาง) แอตทริบิวต์
เช่น <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> อย่างน้อยที่สุด คุณควรระบุประเภท |
<category> | Optional | string | ประเภทของที่พัก เช่น โรงแรม พาร์ทเนอร์สามารถใช้วิธีใดก็ได้ภายใน หมวดหมู่ที่ต้องใช้เพื่ออธิบายที่พัก เช่น "โรงแรมธุรกิจ" "รีสอร์ต" "โมเทล" และคล้ายคลึงกัน |
<content> |
Optional | <content> |
รายละเอียดเพิ่มเติมที่ใช้สำหรับรายชื่อ เช่น คำอธิบาย การให้คะแนน และฟีเจอร์ของที่พัก |
* ต้องระบุหมายเลขโทรศัพท์หรือละติจูด/ลองจิจูด พ ขอแนะนำให้คุณกำหนดทั้ง 2 อย่าง
ตัวอย่าง
ที่อยู่แบบมีโครงสร้าง
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนแบบมีโครงสร้าง ที่อยู่:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<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>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
ที่อยู่รูปแบบอิสระ
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีรูปแบบอิสระ ที่อยู่:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
เนื้อหาที่ไม่บังคับ
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีข้อมูล
มี <content>
ที่ไม่บังคับดังนี้
<?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>
<content>
เพิ่มข้อมูลเกี่ยวกับที่พัก เช่น คะแนนและรีวิว สิ่งอํานวยความสะดวก และ
รายละเอียดอื่นๆ คุณจะใส่องค์ประกอบ <content>
หรือไม่ก็ได้ ภายใน <content>
องค์ประกอบย่อยทั้งหมดเป็นตัวเลือก
องค์ประกอบ <content>
จะปรากฏในตำแหน่งต่อไปนี้ในข้อมูลโรงแรม
ลำดับชั้น XML ของฟีด:
+ <listings>
+ <language>
+ <listing>
+ <content>
ไวยากรณ์
องค์ประกอบ <content>
ใช้ไวยากรณ์ต่อไปนี้
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
<!-- Specify <text>'s child elements in the order shown below. -->
<text type="description">
<link>listing_link</link>
<title>listing_title</title>
<author>listing_author</author>
<body>listing_description</body>
<date month="MM" day="DD" year="YYYY"/>
</text>
<!-- 0 or more reviews: -->
<review type="[editorial|user]">
...
</review>
<!-- 0 or more attributes: -->
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
<client_attr name="custom_0">custom_attribute_0</client_attr>
<client_attr name="custom_1">custom_attribute_1</client_attr>
<client_attr name="custom_2">custom_attribute_2</client_attr>
<client_attr name="custom_3">custom_attribute_3</client_attr>
<client_attr name="custom_4">custom_attribute_4</client_attr>
<client_attr name="hotel_brand">hotel_brand</client_attr>
<client_attr name="num_reviews">number_of_reviews</client_attr>
<client_attr name="rating">aggregate_rating</client_attr>
</attributes>
<!-- a picture of the hotel or property-->
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main Hotel Picture</title>
</image>
</content>
</listing>
...
</listings>
Attributes
องค์ประกอบ <content>
ไม่มีแอตทริบิวต์
องค์ประกอบลูก
องค์ประกอบ <content>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | จำเป็นหรือไม่ | ประเภท | คำอธิบาย |
---|---|---|---|
<text |
Optional | Object | หน้าเว็บที่เชื่อมโยงกับข้อมูลจากผู้ให้บริการ มีองค์ประกอบย่อยดังนี้
หมายเหตุ: องค์ประกอบเหล่านี้ต้องปรากฏตามลำดับด้านบน |
<review |
Optional | <review> |
มีรีวิวผู้ใช้หรือรีวิวบรรณาธิการของข้อมูล บัญชี รายชื่อสามารถมีความเห็น กี่รายการก็ได้ คุณไม่จำเป็นต้องใส่รีวิวทั้งหมดสำหรับที่พักใน
องค์ประกอบ |
<attributes> | Optional | Object | มีองค์ประกอบย่อย <client_attr name="attribute_name">attribute_value<client_attr> สําหรับรายการและคำอธิบายขององค์ประกอบย่อย โปรดดู
องค์ประกอบ หากมีองค์ประกอบย่อย |
<image> | Optional | Object | แท็กซ้ำ มีข้อมูลรูปภาพโดยละเอียด |
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มี
องค์ประกอบ <content>
:
<?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>
<review>
รีวิวผู้ใช้หรือรีวิวบรรณาธิการ คุณไม่จำเป็นต้องระบุข้อมูลทั้งหมด
รีวิวสำหรับข้อมูลในองค์ประกอบ <listing>
องค์ประกอบนี้มีไว้สำหรับ
คุณใส่รีวิวที่เลือกซึ่งบ่งบอกถึงคุณสมบัติของรายชื่อนี้
หรือคุณภาพ
องค์ประกอบ <review>
จะปรากฏในตำแหน่งต่อไปนี้ในข้อมูลโรงแรม
ลำดับชั้น XML ของฟีด:
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
ไวยากรณ์
องค์ประกอบ <review>
ใช้ไวยากรณ์ต่อไปนี้
<?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>
Attributes
องค์ประกอบ <review>
มีแอตทริบิวต์ต่อไปนี้
แอตทริบิวต์ | จำเป็นหรือไม่ | คำอธิบาย |
---|---|---|
type | Required | ประเภทของรีวิว ตั้งค่าเป็นค่าใดค่าหนึ่งต่อไปนี้
|
องค์ประกอบลูก
องค์ประกอบ <review>
มีองค์ประกอบย่อยต่อไปนี้
องค์ประกอบย่อย | จำเป็นหรือไม่ | ประเภท | คำอธิบาย |
---|---|---|---|
<link> | Optional | string | ลิงก์ไปยังรีวิว ใส่ "http://" หรือ "https://" ใน |
<title> | Optional | string | (รีวิวด้านบรรณาธิการเท่านั้น) ชื่อของรีวิว |
<author> | Optional | string | ผู้เขียนรีวิว เช่น "Susan von Trapp" หรืออาจ ชื่อเว็บไซต์หรือสื่อเผยแพร่ที่รีวิวปรากฏ ไม่ได้ให้เครดิต |
<rating> | Optional | string | จำนวนทศนิยมตั้งแต่ 0 ถึง 10 (รวมเลขตัวแรกและตัวสุดท้าย) ซึ่งแสดงค่า ของรีวิว เช่น "8.9" |
<body> | Optional | string | ข้อความของรีวิว องค์ประกอบนี้ไม่ควรมี HTML |
<date month="MM" day="DD" year="YYYY"/> | Optional | Object | (รีวิวของผู้ใช้เท่านั้น) วันที่ของรีวิวซึ่งคุณระบุด้วย
แอตทริบิวต์ต่อไปนี้ขององค์ประกอบนี้
ตัวอย่างเช่น 7 มิถุนายน 2023 จะเป็นดังนี้ <date month="6" day="7" year="2023"/> |
<servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | (รีวิวของผู้ใช้เท่านั้น) วันที่ที่ผู้รีวิวเข้าชมข้อมูลที่ได้รับการรีวิว รูปแบบจะเหมือนกับ <date> ที่ด้านบน
ตัวอย่างเช่น 7 มิถุนายน 2023 จะเป็นดังนี้ <servicedate month="6" day="7" year="2023"/> รีวิวที่ไม่มีเดือนและปีของ <servicedate> เป็นอย่างน้อย อาจไม่แสดง โดยไม่จำเป็นต้องระบุวัน |
โปรดทราบว่า <title>
จะเป็นองค์ประกอบย่อยที่ถูกต้องของ <review>
ก็ต่อเมื่อ
type
ของรีวิวคือ editorial
และ <date>
จะใช้ได้ต่อเมื่อ type
คือ user
เท่านั้น
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีข้อมูล ประกอบด้วยรีวิวจากบรรณาธิการและผู้ใช้:
<?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>
<attributes>
สามารถใช้แท็ก <attributes>
เพื่ออธิบายสิ่งอำนวยความสะดวกของที่พักและ
จัดประเภทคะแนนและรีวิวของที่พัก
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
องค์ประกอบลูก
องค์ประกอบย่อย | จำเป็นหรือไม่ | คำอธิบาย | |
---|---|---|---|
<website> | Optional | เว็บไซต์หลักของโรงแรม หากมี วิดีโอจะต้องอยู่ในตำแหน่ง
ก่อนองค์ประกอบ <client_attr> แรก ตัวอย่าง
<website>https://hotel.example.com</website> |
|
<client_attr name="attribute_name"> | Optional | ลักษณะเฉพาะเพิ่มเติมหรือ "แอตทริบิวต์" ของพร็อพเพอร์ตี้
สามารถระบุได้โดยใช้ ที่สนับสนุน
attribute_name หรือ
attribute_name สำหรับที่พักให้เช่า
|
ค่าสำหรับตัวยึดตำแหน่งค่าแอตทริบิวต์_name
ตารางต่อไปนี้แสดงค่าที่ถูกต้องสำหรับ attribute_name ใน <client_attr name="attribute_name">
ค่าสำหรับ attribute_name |
คำอธิบาย | ค่าเนื้อหาที่ถูกต้อง |
---|---|---|
alternate_hotel_id | ตัวระบุทางเลือกสําหรับที่พัก การมีรหัสแยกกันก็มีประโยชน์ คุณอาจต้องการตัวระบุพร็อพเพอร์ตี้ 1 รายการสำหรับข้อมูลฟีดและ ตัวระบุที่พักอีกตัวหนึ่งสำหรับเครื่องมือการจองของคุณ | ค่าสตริงใดก็ได้ |
custom_[0-4] | แอตทริบิวต์ที่กำหนดเองประเภทสตริง ซึ่งจะไม่แสดงให้ผู้ใช้เห็น | ค่าสตริงใดก็ได้ |
hotel_brand | แบรนด์ของโรงแรม เช่น "Marriott" หรือ "Hilton" ชื่อนี้จะไม่แสดงต่อผู้ใช้ แต่สามารถใช้ในการจัดกลุ่มได้ โรงแรม | ค่าสตริงใดก็ได้ |
lodging | การนำเสนอฟิลด์ทั้งหมดที่เข้ารหัสได้ใน
Lodging
Proto |
สตริงที่เข้ารหัสฐาน 64 ของ
เข้ารหัสแล้ว
Lodging Proto |
num_reviews | จำนวนรีวิวของโรงแรม | จำนวนเต็มที่ไม่เป็นลบ |
rating | จำนวนลอยตัวที่แสดงคะแนนที่พักโดยรวม | โดยทั่วไปจำนวนนี้จะอยู่ระหว่าง 0-5, 0-10 หรือ 0-100 แต่ คุณสามารถใช้ช่วงใดก็ได้ที่แสดงระบบการจัดประเภทของคุณ |
ค่าสำหรับตัวยึดตำแหน่งattribute_nameสำหรับที่พักให้เช่า
โปรดดูแอตทริบิวต์เฉพาะสำหรับที่พักให้เช่าและตัวอย่าง XML
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
รูปภาพจะใช้เพื่อแสดงที่พักในรหัสโรงแรม รูปภาพทั้งหมดที่ใช้ต้อง ให้ทำตามหลักเกณฑ์ต่อไปนี้
- สัดส่วนภาพที่แนะนำสำหรับรูปภาพคือ 4:3
- โปรแกรมรวบรวมข้อมูลรูปภาพ Googlebot ต้องเข้าถึง URL ของรูปภาพได้
หากเว็บไซต์มี robots.txt ที่ระดับราก ให้ตรวจสอบว่า หนึ่งใน 2 ตัวเลือกที่แสดงอยู่ด้านล่างนี้
อนุญาตให้ Crawler ของ Googlebot รวบรวมข้อมูลเนื้อหาและรูปภาพในเว็บไซต์ของคุณ
- User-agent: Googlebot
- Allow: /
อนุญาตให้โปรแกรมรวบรวมข้อมูลรูปภาพ Googlebot รวบรวมข้อมูลรูปภาพในเว็บไซต์ของคุณ
- User-agent: Googlebot-Image
- Allow: /
ไม่อนุญาตให้ใช้ภาพหน้าจอของรูปภาพหรือเว็บไซต์ รูปภาพต้องเป็นต้นฉบับ และรูปภาพหรือภาพถ่ายจริง
Attributes
"ad"
หากรูปภาพเป็นโฆษณา"menu"
หากรูปภาพเป็นเมนูร้านอาหาร"photo"
หากรูปภาพเป็นรูปภาพของธุรกิจ
ชื่อแอตทริบิวต์ | จำเป็นหรือไม่ | รูปแบบ | คำอธิบาย |
---|---|---|---|
type | Required | Text | รูปภาพต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้ |
url | Required | Text | URL ของรูปภาพขนาดเต็ม ใช้แอตทริบิวต์ URL เพื่อระบุ รูปภาพที่จะใช้ในหน้านั้น |
width | Required | A non-negative integer | ความกว้างของรูปภาพเป็นพิกเซล (มากกว่า 720 พิกเซลคือ แนะนำ) |
height | Required | A non-negative integer | ความสูงของรูปภาพเป็นพิกเซล (มากกว่า 720 พิกเซลคือ แนะนำ) |
องค์ประกอบลูก
องค์ประกอบย่อย | จำเป็นหรือไม่ | คำอธิบาย |
---|---|---|
<link> | ขอแล้ว แต่ต้องระบุสำหรับข้อมูลรูปภาพในพื้นที่ | แท็กนี้มี URL ที่ถูกต้องและเป็นปัจจุบันของหน้าในเว็บไซต์ของคุณ
ที่มีรูปภาพที่เกี่ยวข้องเปิดอยู่ แต่จะไม่มี URL ของรูปภาพ
เช่น<link><http://www.example.com/magic_pizza/></link> |
<title> | ได้ขอมาแล้ว | แท็กนี้มีชื่อของรูปภาพ ตัวอย่าง
<title>"Luxury Apartment"</title> |
<author> | ไม่จำเป็น | ชื่อผู้เขียนเนื้อหา ค่านี้สามารถ เป็นชื่อผู้ใช้หรือชื่อเต็มในรูปแบบ "ชื่อ นามสกุล" |
<date> | ต้องระบุ | แท็กนี้จะระบุวันที่สร้างรายการเนื้อหา คุณ จะต้องป้อนปี เดือน และวันตามตัวอย่างต่อไปนี้ <date month="6" day="7" year="2023"/> |
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีแท็กรูปภาพ
<?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>
<content>
<review>
</review>
<attributes>
</attributes>
<image type="photo" url="https://image_url" width="400" height="300">
<link>https://image_url</link>
<title>Apartment at Sandstone</title>
<author>Jessica Landlord</author>
<date month="6" day="7" year="2023"/>
</image>
</content>
</listing>
...
</listings>
หลักเกณฑ์ไวยากรณ์
เมื่อสร้างข้อมูลโรงแรมแบบ XML ให้ใช้หลักเกณฑ์ต่อไปนี้
ตรวจสอบความถูกต้องของไฟล์ XML ข้อมูลโรงแรมด้วยสคีมา XSD ของ Google
ใช้การเข้ารหัส UTF-8 ระบุสคีมาการเข้ารหัสนี้โดยรวม
encoding
ในแท็ก XML ดังที่แสดงในตัวอย่างด้านล่างคุณระบุค่าของข้อมูลในฟีดได้ในส่วน
CDATA
หากคุณใช้CDATA
ส่วน อย่าใช้อักขระพิเศษใช้รหัสยกเว้นสำหรับค่าข้อมูลที่ไม่ได้อยู่ในส่วน
CDATA
ซึ่งรวมถึง URL คุณจะใช้รหัสเอนทิตีหรือรหัสอักขระเพื่อแสดงได้ สัญลักษณ์พิเศษเหล่านี้ ตารางต่อไปนี้แสดงรายการรหัสเอนทิตีและรหัสอักขระทั่วไปที่คุณสามารถใช้ได้อักขระ เอนทิตี รหัสอักขระ เครื่องหมายและ (&) & & เครื่องหมายคำพูดเดี่ยว (') ' ' เครื่องหมายคำพูดคู่ (") " " เครื่องหมายมากกว่า (>) > > เครื่องหมายน้อยกว่า (<) < < ละเว้นองค์ประกอบ XML ที่ไม่มีข้อมูล ตัวอย่างเช่น หากคุณไม่มี ละติจูดและลองจิจูดของโรงแรม คุณไม่ควรเว้นว่าง องค์ประกอบ
<latitude/>
และ<longitude/>
อย่าใช้ HTML ในองค์ประกอบ XML ไม่ว่าในกรณีใดๆ (แม้ว่าจะ Escape)
คุณใช้ XSD ของฟีดในเครื่องได้เพื่อตรวจสอบฟีดก่อนที่จะอัปโหลด http://www.gstatic.com/localfeed/local_feed.xsd.
หากต้องการใช้ความคิดเห็นในฟีด ให้รวมความคิดเห็นไว้ในแท็ก
<!--
และ-->
ดังตัวอย่างต่อไปนี้<!-- This is a comment -->
โปรดตรวจสอบว่าคุณปิดองค์ประกอบ
<date>
ในบัญชีผู้ใช้แล้ว<review>
เช่น<date day="2" month="12" year="2017"/>