Uma lista de hotéis é um ou mais arquivos XML que listam todos os hotéis para os quais você fornecerá informações de preços. O arquivo da lista de hotéis não contém informações de preços.
O elemento raiz de uma lista de hotéis é o <listings>
, que contém elementos <listing>
que descrevem suas propriedades.
Crie uma lista de hotéis como parte da implementação inicial e, em seguida, adicione ou remova hotéis dela como parte da manutenção regular.
Confira se os arquivos estão em conformidade com as diretrizes de sintaxe.
Por exemplo, use a codificação UTF-8 e especifique esse esquema incluindo
o atributo encoding
na tag XML.
Depois de criar uma lista de hotéis, é possível fazer o upload manual dela no Google usando a Central para Hotéis ou hospedá-la no seu servidor.
Encontrar e corrigir problemas de dados
Para encontrar e corrigir problemas de dados na lista de hotéis, consulte os seguintes artigos:
Requisitos de listagem
Para poder usar os Anúncios de hotéis no Google, uma propriedade da sua lista de hotéis precisa ter o seguinte:
- Quartos para os hóspedes pagantes
- Lugar físico e fixo aberto ao público
- Paredes fixas e encanamento
- Requisito de estadia mínima de até sete dias
Exemplos comuns de propriedades não qualificadas incluem cruzeiros e apartamentos porque elas geralmente não atendem aos critérios Listing requirements
.
Chalés de camping e outros estabelecimentos de acampamento com paredes fixas, encanamento e controle de temperatura (incluindo fornos a lenha ou aquecedores a gás) estão qualificados. As acomodações externas não qualificadas incluem:
- Acampamentos, onde hóspedes ficam em barracas
- Estacionamentos para trailers, onde os hóspedes levam o próprio trailer
<listings>
<listings>
é o elemento raiz de uma lista de hotéis e contém um elemento <language>
e pelo menos um <listing>
.
O elemento <listings>
aparece no seguinte local na hierarquia XML da lista de hotéis:
+ <listings>
+ <language>
+ <datum>
+ <listing>
Sintaxe
O elemento <listings>
usa a seguinte sintaxe:
<?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>
Atributos
O elemento <listings>
tem os seguintes atributos:
Atributo | Obrigatório? | Descrição |
---|---|---|
xmlns:xsi |
Obrigatório | Defina como http://www.w3.org/2001/XMLSchema-instance . |
xsi:noNamespaceSchemaLocation |
Obrigatório | Defina como http://www.gstatic.com/localfeed/local_feed.xsd . |
Elementos filhos
O elemento <listings>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<language> | Required | string | O idioma em que seu feed foi escrito. Defina o valor desse
elemento como um
código de idioma de duas letras. Por exemplo, en para inglês. |
<datum> | Optional | enum | Esse elemento especifica o dado geodésico ou modelo de referência para as coordenadas de latitude/longitude fornecidas no feed. Se nenhum valor de dado
for fornecido, o valor padrão para esse elemento será WGS84 , que
é usado pela maioria dos dispositivos de GPS modernos. O dado de Tóquio só é aplicável a endereços no Japão.
Os valores válidos para este elemento são:
WGS84 , não inclua
o elemento <datum> na lista de hotéis.
|
<listing> | Required | <listing> |
Uma ou mais entradas que descrevem cada hotel no feed. Cada hotel na lista precisa ter um ID exclusivo para seu site e nunca deve ser reutilizado. |
Exemplos
Endereço estruturado
O exemplo a seguir mostra uma lista parcial de hotéis com um endereço estruturado:
<?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>
Endereço em formato livre
O exemplo a seguir mostra uma lista de hotéis parcial com um endereço em formato livre:
<?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, 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>
Conteúdo opcional
O exemplo a seguir mostra uma lista de hotéis parcial com uma ficha que contém um <content>
opcional:
<?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>
Uma definição de hotel em um elemento <listings>
da lista de hotéis.
O elemento <listing>
aparece no seguinte local na hierarquia XML do feed de lista de hotéis:
+ <listings>
+ <language>
+ <listing>
Sintaxe
O elemento <listing>
usa a seguinte sintaxe:
<?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>
Atributos
O elemento <listing>
não tem atributos.
Elementos filhos
O elemento <listing>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<id> | Required | string | Um identificador único do hotel.
Observação: esse valor precisa ser exclusivo do seu site o tempo todo. Não reutilize IDs, porque isso pode causar problemas ao tentar resolver problemas de correspondência de propriedade. |
<name> | Required | string | O nome do hotel. Por exemplo:
<name>Belgrave House</name> |
<address> | Required | Object or string | A localização física completa do hotel. Esse elemento assume um único atributo, No mínimo, você precisa informar o endereço, a cidade, o estado ou a região e o CEP do hotel. Use elementos filhos de
Exemplo: <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> Também é possível informar um endereço em "formato livre", embora isso não seja recomendado. Exemplo: <address>6 Elm Ave, Boston, MA, 02472</address> Caixas postais ou outros endereços somente para envio de correspondências não são considerados endereços físicos completos. |
<country> | Required | string | O país em que a ficha da empresa está localizada. O valor precisa ser um código de país de duas letras.
Por exemplo, Brasil é "BR" e Estados Unidos é "US". Por exemplo:
<country>US</country> |
<latitude> | Required* | float | A latitude correspondente ao local da lista. Por
exemplo:
<latitude>37.423738</latitude> Esse valor pode ser gerado com ferramentas de GeoCoding como a API Google Maps. |
<longitude> | Required* | float | A longitude correspondente ao local da lista. Por
exemplo:
<longitude>-122.090101</longitude> Esse valor pode ser gerado com ferramentas de GeoCoding como a API Google Maps. |
<location_precision> | Optional | integer | Precisão do local da propriedade enviada em metros quando a latitude e a longitude estão ofuscadas. Zero (0) significa que não há ofuscação e que este é o local exato. Observação : esse elemento se aplica apenas a aluguéis por temporada. |
<phone> | Required* | string | Um ou mais números de contato do hotel. Se a listagem for uma filial da empresa, forneça o número de telefone específico da filial (não o número de telefone da sede central). O atributo
Exemplo: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> Forneça pelo menos um tipo |
<category> | Optional | string | O tipo de propriedade, como um hotel. Os parceiros podem usar as categorias internas para descrever a propriedade, como "hotéis de negócios", "resorts", "hotéis de estrada" e similares. |
<content> |
Optional | <content> |
Detalhes opcionais usados na ficha da empresa, como descrição, classificações e recursos da propriedade. |
* É necessário um número de telefone ou latitude/longitude. Recomendamos que você defina ambos.
Exemplos
Endereço estruturado
O exemplo a seguir mostra uma lista parcial de hotéis com um endereço estruturado:
<?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>
Endereço em formato livre
O exemplo a seguir mostra uma lista de hotéis parcial com um endereço em formato livre:
<?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, 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>
Conteúdo opcional
O exemplo a seguir mostra uma lista de hotéis parcial com uma ficha que contém um <content>
opcional:
<?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>
Adiciona informações sobre uma ficha da empresa, como notas e avaliações, comodidades e
outros detalhes. O elemento <content>
é opcional. Em <content>
,
todos os elementos filhos são opcionais.
O elemento <content>
aparece no seguinte local na hierarquia XML do feed de lista de hotéis:
+ <listings>
+ <language>
+ <listing>
+ <content>
Sintaxe
O elemento <content>
usa a seguinte sintaxe:
<?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>
Atributos
O elemento <content>
não tem atributos.
Elementos filhos
O elemento <content>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<text |
Optional | Object | A página da Web associada à ficha do provedor. Ele apresenta os seguintes elementos filho:
Observação: esses elementos precisam aparecer na ordem acima. |
<review |
Optional | <review> |
Contém uma avaliação de usuário ou editorial da ficha da empresa. Sua ficha pode ter qualquer número de avaliações, de qualquer tipo. Não é necessário incluir todas as avaliações de uma propriedade no elemento |
<attributes> | Optional | Object | Contém zero ou mais elementos filhos <client_attr name="attribute_name">attribute_value<client_attr> Para ver uma lista e uma descrição dos elementos filhos, consulte Todos os elementos Se houver um elemento filho |
<image> | Optional | Object | Tag repetida, contém informações detalhadas da imagem. |
Exemplo
O exemplo a seguir mostra uma lista de hotéis parcial que inclui o
elemento <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>
Contém uma avaliação de usuário ou editorial. Você não precisa incluir todas as avaliações de uma ficha no elemento <listing>
. Esse elemento serve para você incluir avaliações selecionadas que indicam os recursos ou a qualidade dessa ficha.
O elemento <review>
aparece no seguinte local na hierarquia XML do feed de lista de hotéis:
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
Sintaxe
O elemento <review>
usa a seguinte sintaxe:
<?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>
Atributos
O elemento <review>
tem os seguintes atributos:
Atributo | Obrigatório? | Descrição |
---|---|---|
type | Required | O tipo de avaliação. Defina como um dos seguintes valores:
|
Elementos filhos
O elemento <review>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<link> | Optional | string | Um link para a avaliação. Inclua "http://" ou "https://" nesse elemento. |
<title> | Optional | string | (Somente avaliações editoriais) O título da avaliação. |
<author> | Optional | string | O autor da avaliação, por exemplo, "Susan von Trapp". Ele também pode ser o nome de um site ou publicação em que a avaliação aparece, caso não tenha crédito. |
<rating> | Optional | string | Um número de ponto flutuante de 0 a 10 (inclusive) que representa a pontuação da avaliação. Por exemplo, "8.9". |
<body> | Optional | string | O texto da avaliação. Esse elemento não deve conter HTML. |
<date month="MM" day="DD" year="YYYY"/> | Optional | Object | (Somente avaliações de usuários) A data da avaliação, que é especificada com os seguintes atributos desse elemento:
Por exemplo, 7 de junho de 2023 é escrito assim: <date month="6" day="7" year="2023"/> |
<servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | (Somente avaliações de usuários) A data em que o revisor visitou a ficha que estava sendo comentada. O formato é o mesmo que <data> acima.
Por exemplo, 7 de junho de 2023 é escrito assim: <servicedate month="6" day="7" year="2023"/> Avaliações sem pelo menos o mês e o ano de <servicedate> preenchidos podem não ser exibidos. O dia não é obrigatório. |
Observe que <title>
é um elemento filho válido de <review>
somente quando type
da avaliação é editorial
, e <date>
só é válido se type
é user
.
Exemplo
O exemplo a seguir mostra uma lista de hotéis parcial com uma ficha que contém uma avaliação editorial e uma avaliação de usuário:
<?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>
A tag <attributes>
pode ser usada para descrever comodidades e classificar notas e avaliações da propriedade.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
Elementos filhos
Elemento filho | Obrigatório? | Descrição | |
---|---|---|---|
<website> | Optional | O site principal do hotel. Se estiver presente, ele precisará ser posicionado
antes do primeiro elemento <client_attr> . Exemplo: <website>https://hotel.example.com</website> |
|
<client_attr name="attribute_name"> | Optional | Uma característica ou "atributo" adicional da propriedade que pode ser especificado usando o
attribute_name ou o
attribute_name para aluguéis por temporada compatíveis.
|
Valores do marcador attribute_name
A tabela a seguir lista os valores válidos para attribute_name no elemento <client_attr name="attribute_name">.
Valores de attribute_name |
Descrição | Valores de conteúdo válidos |
---|---|---|
alternate_hotel_id | Um identificador alternativo para sua propriedade. Ter IDs separados é útil se você precisa de um identificador de propriedade para as informações do feed e outro identificador de propriedade para seu mecanismo de reserva. | Qualquer valor de string |
custom_[0-4] | Qualquer atributo personalizado do tipo de string. Eles não são exibidos aos usuários. | Qualquer valor de string |
hotel_brand | A rede do hotel. Por exemplo, "Marriott" ou "Hilton". Ele não é exibido aos usuários, mas pode ser usado para agrupar hotéis. | Qualquer valor de string |
lodging | Representação codificada de todos os campos disponíveis no
proto
Lodging . |
String codificada em Base64 do
proto codificado
Lodging |
num_reviews | Número de avaliações da ficha da empresa. | Qualquer número inteiro não negativo. |
rating | Um número de ponto flutuante que representa a avaliação agregada de propriedade. | Esse número normalmente é de 0 a 5, 0 a 10 ou 0 a 100, mas é possível usar qualquer intervalo que represente seu sistema de classificação. |
Valores do marcador de posição attribute_name para aluguéis por temporada
Consulte Atributos específicos de aluguel por temporada e exemplo de XML.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
As imagens são usadas para mostrar a propriedade no ID da ficha. Todas as imagens usadas precisam seguir estas diretrizes:
- A proporção recomendada para imagens é de 4:3.
- O URL da imagem precisa ser acessível pelo rastreador Googlebot Image.
Se o site inclui um robots.txt no nível raiz, verifique se ele contém uma das duas opções mostradas abaixo:
Permite que o rastreador do Googlebot rastreie o conteúdo do seu site, incluindo as imagens.
- User agent: Googlebot
- Allow: /
Permite que o rastreador de imagens do Googlebot rastreie as imagens no seu site.
- User-agent: Googlebot-Image
- Allow: /
Capturas de tela de imagens ou sites não são permitidas. As imagens precisam ser fotos ou imagens originais e reais.
Atributos
"ad"
se a imagem for um anúncio"menu"
se a imagem for um cardápio de restaurante"photo"
se a imagem for uma foto da empresa
Nome do atributo | Obrigatório? | Formato | Descrição |
---|---|---|---|
type | Required | Text | A imagem precisa ser uma das seguintes: |
url | Required | Text | É o URL da imagem em tamanho original. Use o atributo de URL para especificar a imagem a ser usada nessa página. |
width | Required | A non-negative integer | Largura da imagem, em pixels. Recomendamos mais de 720 pixels. |
height | Required | A non-negative integer | Altura da imagem em pixels (é recomendável mais de 720 pixels) |
Elementos filhos
Elemento filho | Obrigatório? | Descrição |
---|---|---|
<link> | Solicitado, mas obrigatório para listagens de fotos locais. | Essa tag contém o URL válido e atualizado da página do seu site
em que a imagem relevante está. Ele não contém o URL da imagem em si.
Exemplo:<link><http://www.example.com/magic_pizza/></link> |
<title> | Solicitado | Essa tag contém o título da imagem. Exemplo: <title>"Luxury Apartment"</title> |
<author> | Não é necessário | Nome do autor do conteúdo. O valor pode ser um nome de usuário ou um nome completo no formato "Nome e sobrenome". |
<date> | Obrigatório | Essa tag identifica a data em que o item de conteúdo foi criado. Você precisa inserir um ano, mês e dia, como no exemplo a seguir: <date month="6" day="7" year="2023"/> |
Exemplo
O exemplo a seguir mostra uma lista de hotéis parcial com tags de imagem:
<?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>
Diretrizes de sintaxe
Ao criar uma lista de hotéis baseada em XML, use as seguintes diretrizes:
Valide seus arquivos XML da lista de hotéis com o esquema XSD do Google.
Use a codificação UTF-8. Especifique esse esquema de codificação incluindo o atributo
encoding
na tag XML, conforme mostrado nos exemplos abaixo.Você pode especificar valores de dados no seu feed com seções
CDATA
. Se você usar seçõesCDATA
, não faça o escape de caracteres especiais.Use códigos de escape para valores de dados que não estejam em seções
CDATA
, incluindo URLs. É possível usar o código da entidade ou o código de caractere para representar esses caracteres especiais. A tabela a seguir lista os códigos de entidade e caracteres comuns que podem ser usados:Baseado em caracteres Entidade Código do caractere "E" comercial (&) & & Aspas simples (') ' ' Aspas duplas (") " " Maior que (>) > > Menor que (<) < < Omita elementos XML que não contenham dados. Por exemplo, se você não tem a latitude e a longitude de um hotel, não inclua elementos
<latitude/>
e<longitude/>
vazios.Não use HTML nos seus elementos XML em nenhuma circunstância, mesmo que haja escape.
Para validar seu feed antes de fazer upload, você pode usar o XSD do feed local http://www.gstatic.com/localfeed/local_feed.xsd.
Para usar comentários no seu feed, coloque o comentário nas tags
<!--
e-->
, conforme o exemplo a seguir:<!-- This is a comment -->
Feche o elemento
<date>
em um<review>
de usuário. Exemplo:<date day="2" month="12" year="2017"/>