酒店列表是一个或多个 XML 文件,其中会列出您要预订的所有酒店 提供定价信息。酒店列表文件本身不包含定价 信息。
酒店列表的根元素是 <listings>
元素,其中包含
描述属性的 <listing>
元素。
作为初始实现的一部分,您需要创建酒店列表, 然后在常规维护过程中添加或移除酒店。
请确保您的文件符合语法指南。
例如,使用 UTF-8 编码,并指定此编码架构,方法是添加
XML 标记中的 encoding
属性。
创建酒店列表后,您可以使用“酒店”功能将其手动上传到 Google 中心或将其托管在 服务器。
查找并修复数据问题
如需查找和解决酒店列表中的数据问题,请参阅以下文章:
清单要求
若要投放 Google 酒店广告,酒店列表中的房源必须 具备以下特征:
- 设有可供房客付费入住的房间
- 有面向公众的固定的实体地点
- 固定墙壁和管道
- 最低入住天数不超过 7 天
不符合条件的房源的常见示例包括游轮和
公寓,因为它们通常不符合Listing requirements
条件。
有固定墙壁、管道 和恒温控制(包括柴火炉或丙烷加热器)的设备均符合此政策。 不符合条件的户外住宿场所包括:
- 可供房客入住帐篷的露营地
- 房客可以自带房车的房车营地
<listings>
<listings>
是酒店列表的根元素,它包含一个
<language>
元素和至少一个 <listing>
。
<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>
属性
<listings>
元素具有以下属性:
特性 | 是否必需? | 说明 |
---|---|---|
xmlns:xsi |
必填 | 设为 http://www.w3.org/2001/XMLSchema-instance 。 |
xsi:noNamespaceSchemaLocation |
必填 | 设为 http://www.gstatic.com/localfeed/local_feed.xsd 。 |
子元素
<listings>
元素具有以下子元素:
子元素 | 是否必需? | 类型 | 说明 |
---|---|---|---|
<language> | Required | string | 编写 Feed 所用的语言。设置此
元素添加到
双字母语言代码。例如,en 表示英语。 |
<datum> | Optional | enum | 此元素为以下对象指定测地基准或参考模型:
Feed 中提供的纬度/经度坐标。如果没有基准值
则此元素的默认值为 WGS84 ,
。东京数据仅适用于
日本的地址
此元素的有效值包括:
WGS84 的默认值,请不要添加
酒店列表中的 <datum> 元素。
|
<listing> | Required | <listing> |
用于描述 Feed 中每家酒店的一个或多个条目。请注意, 列表中的每个酒店都必须有您网站专属的 ID,并且 此 ID 绝不能重复使用 |
示例
结构化地址
以下示例显示了包含结构化信息的部分酒店列表 地址:
<?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>
元素显示在酒店列表中的以下位置。
Feed 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>
属性
<listing>
元素没有属性。
子元素
<listing>
元素具有以下子元素:
子元素 | 是否必需? | 类型 | 说明 |
---|---|---|---|
<id> | Required | string | 酒店的唯一标识符。
注意:您的网站在任何时候都必须是唯一的。正确做法 不要重复使用 ID,因为这可能会导致在尝试 解决房源匹配问题。 |
<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> 请注意,P.O.邮箱或其他仅用于邮寄的地址 视为完整的物理地址。 |
<country> | Required | string | 此商家信息所在的国家/地区。该值必须是
两个字母的国家/地区代码。
例如,美国为“US”加拿大为“CA”例如: <country>US</country> |
<latitude> | Required* | float | 与商家信息中所列位置对应的纬度,对于
示例:
<latitude>37.423738</latitude> 这个值可以使用 GeoCoding 工具生成,例如 Google Maps API。 |
<longitude> | Required* | float | 与商家信息中所列位置对应的经度,对于
示例:
<longitude>-122.090101</longitude> 这个值可以使用 GeoCoding 工具生成,例如 Google Maps API。 |
<location_precision> | Optional | integer | 对房源经纬度进行了混淆处理后,发送的房源位置信息的精确度(以米为单位)。零 (0) 表示不进行混淆处理,且是确切位置。注意 :此元素仅适用于民宿。 |
<phone> | Required* | string | 酒店的一个或多个联系电话号码。如果商家信息是商家 请提供该分支机构的具体电话号码 (不是总部的电话号码)。
例如: <!-- 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> |
商家信息所用的可选详情,例如说明、评分、 媒体资源及其特点 |
* 必须提供电话号码或纬度/经度。周三 建议您同时定义这两者
示例
结构化地址
以下示例显示了包含结构化信息的部分酒店列表 地址:
<?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>
元素显示在酒店列表中的以下位置。
Feed 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>
属性
<content>
元素没有属性。
子元素
<content>
元素具有以下子元素:
子元素 | 是否必需? | 类型 | 说明 |
---|---|---|---|
<text |
Optional | Object | 与提供商的商家信息相关联的网页。 具有以下子元素:
注意:这些元素必须按上述顺序显示。 |
<review |
Optional | <review> |
包含商家信息的用户评价或编辑评价。您的 商家信息可以包含任意类型的评价。 您无需在
|
<attributes> | Optional | Object | 包含 0 个或多个 <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>
元素显示在酒店列表中的以下位置。
Feed 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>
属性
<review>
元素具有以下属性:
特性 | 是否必需? | 说明 |
---|---|---|
type | Required | 评价的类型。请设置为以下值之一:
<ph type="x-smartling-placeholder">
|
子元素
<review>
元素具有以下子元素:
子元素 | 是否必需? | 类型 | 说明 |
---|---|---|---|
<link> | Optional | string | 指向评价的链接。包含“http://”或“https://”在此 元素。 |
<title> | Optional | string | (仅限编辑评价)评价的标题。 |
<author> | Optional | string | 评价的作者;例如“苏珊·冯·特拉普”。也可以是 显示相应评价的网站或出版物的名称(如果相应) 处于未认证状态。 |
<rating> | Optional | string | 一个从 0 到 10(含)的浮点数,表示 评价得分。例如,"8.9"。 |
<body> | Optional | string | 评价的文字。此元素不应包含 HTML。 |
<date month="MM" day="DD" year="YYYY"/> | Optional | Object | (仅限用户评论)评论日期,使用
以下属性:
<ph type="x-smartling-placeholder">
例如,2023 年 6 月 7 日写作如下: <date month="6" day="7" year="2023"/> |
<servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | (仅限用户评价)评价者访问所评价商家信息的日期。格式与 <date> 相同。
例如,2023 年 6 月 7 日写作如下: <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 :民宿。
|
attribute_name 占位符的值
下表列出了 attribute_name 的有效值 在<client_attr name="attribute_name">中元素。
attribute_name 的值 |
说明 | 有效的内容值 |
---|---|---|
alternate_hotel_id | 房源的备用标识符。使用单独的 ID 非常有用 您可能需要为 Feed 信息设置一个房源标识符 预订引擎的其他房源标识符。 | 任意字符串值 |
custom_[0-4] | 任何字符串类型的自定义属性。这些信息不会向用户显示。 | 任意字符串值 |
hotel_brand | 此酒店所属品牌,例如:“Marriott”或 “Hilton”。此名称不会向用户显示,但可用于分组 酒店。 | 任意字符串值 |
lodging | 以编码表示
Lodging
proto。 |
以 Base64 编码的字符串,
经过编码
Lodging proto |
num_reviews | 商家信息的评价数。 | 任何非负整数。 |
rating | 表示总体房源评分的浮点数。 | 此数字通常为 0-5、0-10 或 0-100, 您可以使用任何能代表您的分级制度的范围 |
民宿的 attribute_name 占位符值
请参阅民宿专用属性和 XML 示例。
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
图片用于在房源 ID 中显示房源。使用的所有图片都必须 请遵循以下准则:
- 建议的图片宽高比为 4:3。
- 图片网址必须可供 Googlebot 图片抓取工具访问。
如果您的网站在根级目录包含 robots.txt,请确认其包含 选择下列两个选项之一:
允许 Googlebot 抓取工具抓取您网站的内容(包括图片)。
- User-agent: Googlebot
- Allow: /
允许 Googlebot 图片抓取工具抓取您网站上的图片。
- User-agent: Googlebot-Image
- Allow: /
不得提供图片或网站的屏幕截图。图片必须为原创图片 以及实际图像或照片。
属性
- 如果图片是广告,则为
"ad"
- 如果图片是餐馆菜单,则为
"menu"
- 如果图片是商家照片,则为
"photo"
属性名称 | 是否必需? | 格式 | 说明 |
---|---|---|---|
type | Required | Text | 图片必须为以下项之一: |
url | Required | Text | 完整尺寸图片的网址。使用 url 属性指定 要在该页面上使用的图片 |
width | Required | A non-negative integer | 图片的宽度,以像素为单位(大于 720 像素表示 ) |
height | Required | A non-negative integer | 图片的高度,以像素为单位(大于 720 像素表示 ) |
子元素
子元素 | 是否必需? | 说明 |
---|---|---|
<link> | 已请求,但对于本地照片商家信息而言是必需的。 | 此代码包含您网站上相应网页的最新有效网址
相关图片。它不包含图片本身的网址。
示例:<link><http://www.example.com/magic_pizza/></link> |
<title> | 已请求 | 此标记包含图片的标题。示例:
<title>"Luxury Apartment"</title> |
<author> | 不需要 | 内容作者的姓名。该值可以是 是用户名或采用“Firstname Lastname”格式的全名。 |
<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 的酒店列表时,请遵循以下准则:
使用 Google 的 XSD 架构验证您的酒店列表 XML 文件。
请使用 UTF-8 编码。通过添加
encoding
来指定此编码架构 属性,如下面的示例所示。您可以在 Feed 中的
CDATA
部分指定数据值。如果您使用CDATA
部分,不对特殊字符进行转义。对
CDATA
部分以外的数据值使用转义码,包括 网址。您可以使用实体代码或字符代码来表示 这些特殊字符。 下表列出了您可以使用的常见实体代码和字符代码:字符 实体 字符代码 和号 (&) & ; 英文单引号 (') ' ; 英文双引号 (") " " 大于 (>) > > 小于 (<) < < 省略不包含数据的 XML 元素。例如,如果您没有 酒店的经纬度,那么您不应将
<latitude/>
和<longitude/>
元素。在任何情况下都不要在 XML 元素中使用 HTML(即使 转义)。
要在上传之前验证 Feed,您可以使用本地 Feed XSD http://www.gstatic.com/localfeed/local_feed.xsd.
如需在 Feed 中使用评论,请将评论封装在
<!--
和-->
标记中, 如下例所示:<!-- This is a comment -->
请务必关闭用户中的
<date>
元素<review>
。例如:<date day="2" month="12" year="2017"/>