Trang này trình bày nội dung mô tả, giá trị và yêu cầu đối với các thuộc tính và phần tử con. Các giá trị này chỉ áp dụng cho cơ sở lưu trú là Nhà nghỉ dưỡng cho thuê.
Cấu trúc XML chung có định dạng tương tự như nguồn cấp dữ liệu trang thông tin về khách sạn. Xem Trang tham khảo XML về danh sách khách sạn.
Nếu bạn không thêm các mục bắt buộc sau đây, trang thông tin sẽ tự động bị vô hiệu hoá:
- Các phần tử con XML bắt buộc:
id,name,latitude,longitude,address. - Thuộc tính bắt buộc:
capacityvàwebsite. Tham khảo Đường liên kết trực tiếp đến nhà nghỉ dưỡng cho thuê trong nguồn cấp dữ liệu trang thông tin. Điều này giúp người dùng có cơ hội truy cập vào trang web của cơ sở lưu trú.
Để biết thông tin chi tiết về các phần tử con XML bắt buộc, hãy tham khảo phần tử con XML.
Để biết thêm thông tin về Nhà nghỉ dưỡng cho thuê, hãy tham khảo bài viết Các thuộc tính dành riêng cho Nhà nghỉ dưỡng cho thuê.
Cuối cùng, khi Google xác định được từ các nguồn khác rằng giá trị của một thuộc tính khác với giá trị được chỉ định trong nguồn cấp dữ liệu cho trang thông tin về nhà nghỉ dưỡng cho thuê, Google sẽ hiển thị giá trị đó cho trang thông tin. Ví dụ: nếu Google xác định được từ ảnh của một trang thông tin rằng trang thông tin đó có nhà bếp, nhưng thuộc tính kitchen không có hoặc được đặt thành No, thì Google sẽ coi trang thông tin đó là có nhà bếp. Các thuộc tính này được gọi là "thuộc tính suy luận" và chỉ hiển thị khi có độ tin cậy cao về độ chính xác của suy luận.
Giá trị cho phần giữ chỗ attribute_name
Bảng sau đây cung cấp danh sách các giá trị hợp lệ cho attribute_name trong phần tử <client_attr name="attribute_name">; tuy nhiên, bạn nên cung cấp attribute_name bổ sung nếu có.
Giá trị cho attribute_name |
Bắt buộc? | Mô tả | Giá trị nội dung hợp lệ |
|---|---|---|---|
| capacity | Required | Số lượng khách tối đa mà cơ sở lưu trú có thể phục vụ. Giá trị này phải bằng hoặc lớn hơn "số_phòng_ngủ". | Non-negative integer value |
| website | Required | URL trang web của cơ sở lưu trú. | Free text |
| partner_hygiene_link | Strongly recommended | Đường liên kết đến trang web của đối tác bên ngoài, cung cấp thêm thông tin về vấn đề vệ sinh của cơ sở lưu trú. | Free text (the site's URL) |
| number_of_bathrooms | Strongly recommended | Số lượng phòng tắm. | Non-negative float value, for example, 1, 1.5, 2 |
| number_of_bedrooms | Strongly recommended | Số lượng phòng ngủ. | Non-negative integer value |
| number_of_beds | Strongly recommended | Số giường trong tất cả các phòng. | Non-negative integer value |
| self_checkin_checkout | Recommended | Khách sạn có cho phép tự nhận phòng và trả phòng hay không. | Yes/No/Unknown |
| rating | Strongly recommended | Số thực cho biết điểm xếp hạng tổng hợp của cơ sở lưu trú. Số này thường trong khoảng 0 đến 5, 0 đến 10 hoặc 0 đến 100. Tuy nhiên, bạn có thể sử dụng bất kỳ phạm vi nào đại diện cho hệ thống xếp hạng của mình. | Non-negative float value |
| rating_num | Strongly recommended | Số lượt xếp hạng mà cơ sở lưu trú nhận được. | Non-negative integer value |
| rating_scale | Strongly recommended | Điểm xếp hạng tối đa có thể có của một cơ sở lưu trú. Ví dụ: điểm xếp hạng cơ sở lưu trú phải là 3 hoặc 4 đối với rating_scale là 5.
Lưu ý: Mức_điểm_xếp_hạng mặc định là 0-10 nếu không được chỉ định. |
Non-negative integer value |
| instant_bookable | Strongly recommended | Khách có thể đặt phòng tại cơ sở lưu trú ngay lập tức thông qua quy trình thanh toán hay không. Một phương thức khác là chờ phê duyệt. | Yes/No/Unknown |
| description | Strongly recommended | Văn bản dạng tự do mô tả những đặc điểm riêng biệt của cơ sở lưu trú | Free text |
| category | Strongly recommended | Loại cơ sở lưu trú, chẳng hạn như biệt thự, nhà bungalow, nhà gỗ nhỏ hoặc căn hộ | Free text |
| ac | Recommended | Cơ sở lưu trú có máy điều hoà không khí hay không. | Yes/No/Unknown |
| beach_access | Recommended | Cơ sở lưu trú có lối ra bãi biển công cộng gần cơ sở lưu trú hay không. | Yes/No/Unknown |
| check_in_time | Recommended | Thời gian chính xác trong ngày để nhận phòng tại cơ sở lưu trú. Chấp nhận định dạng HHMM, HH:MM hoặc HH:MM:SS; ví dụ: sử dụng 14:00 thay vì 2 giờ chiều hoặc 2:00 chiều. Tất cả các định dạng khác sẽ không được phân tích cú pháp hoặc hiển thị. | Time |
| check_out_time | Recommended | Thời gian chính xác trong ngày để trả phòng tại cơ sở lưu trú. Chấp nhận định dạng HHMM, HH:MM hoặc HH:MM:SS; ví dụ: sử dụng 11:00 thay vì 11 giờ sáng hoặc 11:00 sáng. Tất cả các định dạng khác sẽ không được phân tích cú pháp hoặc hiển thị. | Time |
| child_friendly | Recommended | Cơ sở lưu trú có phù hợp với trẻ em hay không. | Yes/No/Unknown |
| crib | Recommended | Cơ sở lưu trú có giường cũi cho trẻ em hay không. | Yes/No/Unknown |
| elevator | Recommended | Cơ sở lưu trú có thang máy hay không. | Yes/No/Unknown |
| gym_fitness_equipment | Recommended | Cơ sở lưu trú có phòng tập thể dục hoặc thiết bị tập thể dục hay không. | Yes/No/Unknown |
| heating | Recommended | Cơ sở lưu trú có hệ thống sưởi ấm hay không. | Yes/No/Unknown |
| hot_tub | Recommended | Cơ sở lưu trú có bồn tắm nước nóng hay không. | Yes/No/Unknown |
| ironing_board | Recommended | Cơ sở lưu trú có bàn là hay không. | Yes/No/Unknown |
| kitchen | Recommended | Cơ sở lưu trú có khu bếp hay không. | Yes/No/Unknown |
| microwave | Recommended | Cơ sở lưu trú có lò vi sóng hay không. | Yes/No/Unknown |
| min_days_advance_purchase | Recommended | Số ngày tối thiểu để đặt trước phòng tại cơ sở lưu trú. | Non-negative integer value |
| min_night_stay | Recommended | Số đêm tối thiểu mà một khách có thể đặt trước phòng tại cơ sở lưu trú. | Positive integer (more than zero) |
| max_night_stay | Recommended | Số đêm tối đa mà một khách có thể đặt trước phòng tại cơ sở lưu trú. | Positive integer (more than zero) |
| outdoor_grill | Recommended | Cơ sở lưu trú có bếp nướng hay không. | Yes/No/Unknown |
| oven_stove | Recommended | Cơ sở lưu trú có bếp lò hay không. | Yes/No/Unknown |
| parking_type | Recommended | Loại bãi đỗ xe tại cơ sở lưu trú. | Free/Paid/None |
| patio | Recommended | Cơ sở lưu trú có sân hiên hay không. | Yes/No/Unknown |
| pets_allowed | Recommended | Một số hoặc tất cả các phòng cho phép khách mang theo thú cưng (chó hoặc mèo không phải động vật trợ giúp). | Yes/No/Unknown |
| pool_type | Recommended | Loại hồ bơi (lối ra hồ bơi) tại cơ sở lưu trú. | Indoors, Outdoors, Indoors/Outdoors, None |
| room_type | Recommended | Loại phòng. ENTIRE_PLACE là giá trị duy nhất được hỗ trợ. |
ENTIRE_PLACE
|
| smoking_free_property | Recommended | Cơ sở lưu trú có cho phép hút thuốc hay không. | Yes/No/Unknown |
| special_service_level | Recommended | Liệu cấp dịch vụ của trang thông tin có đặc biệt theo một cách nào đó hay không.
Ví dụ: verified, luxury, premium |
Yes/No/Unknown |
| square_footage | Recommended | Diện tích của cơ sở lưu trú tính theo foot vuông. | Non-negative float value |
| square_meters | Recommended | Diện tích của cơ sở lưu trú tính bằng mét vuông. | Non-negative float |
| tv | Recommended | Cơ sở lưu trú có TV hay không. | Yes/No/Unknown |
| washer_dryer | Recommended | Cơ sở lưu trú có máy giặt hay không. | Yes/No/Unknown |
| wheelchair_accessible | Recommended | Cơ sở lưu trú có lối đi cho xe lăn hay không. | Yes/No/Unknown |
| internet_type | Recommended | Hình thức cung cấp mạng Wi-Fi của cơ sở lưu trú. | Free/Paid/None |
| airport_shuttle | Optional | Cơ sở lưu trú có cung cấp dịch vụ đưa đón đến sân bay hoặc các nhà ga khác hay không. | Yes/No/Unknown |
| balcony | Optional | Cơ sở lưu trú có ban công hay không. | Yes/No/Unknown |
| fire_place | Optional | Cơ sở lưu trú có lò sưởi hay không. | Yes/No/Unknown |
| free_breakfast | Optional | Cơ sở lưu trú có phục vụ bữa sáng miễn phí hay không. | Yes/No/Unknown |
| host_description | Optional | Nội dung mô tả về người cho thuê nhà nghỉ dưỡng. | Free text |
| host_language | Optional | Những ngôn ngữ mà chủ cơ sở lưu trú có thể nói. | Danh sách các mã ngôn ngữ được phân tách bằng dấu phẩy; ví dụ: de, en |
| host_name | Optional | Tên của người cho thuê nhà/căn hộ du lịch. | Free text |
| host_response_rate | Optional | Tỷ lệ phản hồi trung bình của máy chủ lưu trữ. | Non-negative float value, for example, 1, 0.75, 0.5 |
| host_response_time | Optional | Thời gian phản hồi trung bình của máy chủ. | Free text |
| license_num | Optional | Cơ sở lưu trú tại một số khu vực trên thế giới bắt buộc phải hiển thị số giấy phép (dành cho khách du lịch hoặc doanh nghiệp). Số giấy phép có thể lặp lại và nếu bạn có nhiều giấy phép, bạn nên thêm cơ quan cấp giấy phép để làm rõ thông tin (ví dụ như "Paris: 123456ABC"). | Free text |
| number_of_half_bathrooms | Optional | Số lượng phòng tắm cơ bản. | Non-negative integer value |
| number_of_living_rooms | Optional | Số phòng khách. | Non-negative integer value |
| private_beach_access | Optional | Cơ sở lưu trú có lối đi riêng dẫn ra bãi biển dành riêng cho khách lưu trú hay không. | Yes/No/Unknown |
| refund_policy | Optional | Chính sách hoàn tiền của cơ sở lưu trú. | Free text |
Phần tử con XML
Các phần tử con XML sau đây là bắt buộc:
| Phần tử con | Bắt buộc? | Loại | Mô tả |
|---|---|---|---|
| <country> | Strongly recommended | string | Quốc gia nơi tọa lạc của cơ sở lưu trú này. Giá trị phải là mã quốc gia gồm 2 chữ cái theo ISO 3116; ví dụ: Hoa Kỳ là US và Canada là CA:
<country>US</country> |
| <id> | Required | string | Giá trị nhận dạng duy nhất của cơ sở lưu trú. Xin lưu ý rằng mỗi nhà nghỉ dưỡng cho thuê phải có một mã duy nhất trên trang web của bạn và không được sử dụng lại mã này. |
| <latitude> | Required | float | Vĩ độ tương ứng với vị trí của trang thông tin. Ví dụ:
<latitude>37.423738</latitude> Bạn có thể tạo giá trị này bằng các công cụ Mã hoá địa lý như API Google Maps. |
| <longitude> | Required | float | Kinh độ tương ứng với vị trí của trang thông tin. Ví dụ:
<longitude>-122.090101</longitude> Bạn có thể tạo giá trị này bằng các công cụ Mã hoá địa lý như API Google Maps. |
| <name> | Required | string | Tên của cơ sở lưu trú. Tối đa 300 ký tự. |
| <address> | Required | string or Object | Vị trí thực tế đầy đủ của cơ sở lưu trú dưới dạng một chuỗi. Địa chỉ phải có tên đường và số nhà. Nếu không có, địa chỉ phải bao gồm mã địa điểm. Bạn cũng phải cung cấp số căn hộ hoặc số phòng (nếu có). Ngoài ra, bạn có thể cung cấp địa chỉ "kết hợp". Hãy sử dụng các phần tử con
Xin lưu ý rằng các địa chỉ hòm thư hoặc địa chỉ nhận thư khác không được coi là địa chỉ thực tế đầy đủ. Sau đây là ví dụ về địa chỉ đầy đủ: <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> Sau đây là ví dụ về địa chỉ đầy đủ sử dụng mã cộng: <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> Tránh những điều sau:
|
Ví dụ về trang thông tin về Nhà/căn hộ du lịch
<?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>