Referência XML da lista de hotéis

Uma lista de hotéis é um ou mais arquivos XML que contém todos os hotéis para os quais você fornecerá informações de preço. O arquivo de lista de hotéis em si 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 sua implementação inicial e, em seguida, adicione ou remova hotéis dela como parte da manutenção regular.

Verifique 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 upload dela manualmente para o 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 sua lista de hotéis, consulte os seguintes artigos:

• Como configurar seu inventário de hotéis
• Resolver problemas de correspondência de propriedade

Requisitos de listagem

Para se qualificar para 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 e encanamento fixos
• Requisito de estadia mínima de até sete dias

Exemplos comuns de propriedades não qualificadas incluem cruzeiros e apartamentos porque geralmente não atendem aos critérios Listing requirements.

Chalés e outros estabelecimentos de acampamento com paredes fixas, encanamento e controle de clima (incluindo fogões a lenha ou aquecedores de propano) são qualificados. As acomodações ao ar livre não qualificadas incluem:

• Acampamentos, onde os hóspedes ficam em barracas
• Áreas para trailers, onde os hóspedes trazem seus próprios trailers

<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 o modelo de referência para as coordenadas de latitude/longitude fornecidas no feed. Se nenhum valor de dado for fornecido, o valor padrão desse elemento será WGS84, que é usado pela maioria dos dispositivos de GPS modernos. O datum de Tóquio é aplicável apenas a endereços no Japão. Os valores válidos para esse elemento são: WGS84 wgs84 TOKYO tokyo Observação:para usar o valor padrão de 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. Lembre-se de que cada hotel da lista precisa ter um ID exclusivo do seu site e nunca o reutilizar.

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 de forma livre

O exemplo a seguir mostra uma lista parcial de hotéis com um endereço de 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 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>

Conteúdo opcional

O exemplo a seguir mostra uma lista parcial de hotéis 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:

Importante :especifique os elementos filhos na ordem mostrada abaixo.

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 sempre. Não reutilize IDs, porque isso pode causar problemas ao tentar resolver problemas de correspondência de propriedades.
<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, format, que você precisa definir como simple. No mínimo, você precisa fornecer o endereço, a cidade, o estado ou a região e o CEP do hotel. Use elementos filhos <component> para descrever cada uma das seguintes partes do endereço: addr1: o endereço principal do hotel. addr2: o endereço secundário, se necessário. addr3: uma terceira parte do endereço, se necessário. city: o nome da cidade do hotel. province: o nome do estado, região ou província do hotel. postal_code: o CEP do hotel. 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> Você também pode fornecer um endereço de "formato livre", mas isso não é recomendado. Exemplo: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Caixas postais ou outros endereços somente para correspondência não são considerados endereços físicos completos.
<country>	Required	string	O país em que esta ficha 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	A precisão da localização da propriedade é enviada em metros quando a latitude e a longitude da propriedade estão ofuscadas. Zero (0) significa que não há ofuscação e que esse é o local exato. Observação : este 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 do local da filial (não o número de telefone da sede central). O atributo type pode ser um dos seguintes: fax: número de telefone de fax. main: número de telefone de voz principal. mobile: número de celular. tdd: número de telefone do dispositivo de telecomunicações para os surdos (TDD, na sigla em inglês). tollfree: número de telefone para chamada sem custo financeiro. Exemplo: <!-- Singapore (country code +65) --> <phone type="main">[phone]</phone> <!-- U.S. (country code +1) --> <phone type="fax">[phone]</phone> No mínimo, você precisa fornecer um tipo main.
<category>	Optional	string	O tipo de propriedade, como um hotel. Os parceiros podem usar quaisquer categorias internas que tenham para descrever a propriedade, como "hotéis de negócios", "resorts", "motéis" e similares.
<content>	Optional	<content>	Detalhes opcionais usados para a ficha, 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 de forma livre

O exemplo a seguir mostra uma lista parcial de hotéis com um endereço de 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 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>

Conteúdo opcional

O exemplo a seguir mostra uma lista parcial de hotéis 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, 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 type="description">	Optional	Object	A página da Web associada à ficha do fornecedor. Ele apresenta os seguintes elementos filho: <link>: um link para a descrição. Inclua "http://" ou "https://" nesse elemento (opcional). <title>: o título da descrição (opcional). <author>: o autor da descrição (opcional). <body>: o corpo da descrição (obrigatório). <date>: a data da descrição (opcional). Observação: esses elementos precisam aparecer na ordem acima.
<review type="[editorial|user]">	Optional	<review>	Contém uma avaliação de usuário ou editorial da listagem. Sua listagem pode conter qualquer número de comentários, de qualquer tipo. Você não precisa incluir todas as avaliações de uma propriedade no elemento <listing>. Esse elemento serve para incluir avaliações selecionadas que ilustram os recursos ou a qualidade da página.
<attributes>	Optional	Object	Contém zero ou mais elementos filhos <client_attr> que fornecem detalhes sobre a propriedade. Os elementos filhos usam a seguinte sintaxe: <client_attr name="attribute_name">attribute_value<client_attr> Para ver uma lista e uma descrição de elementos filhos, consulte <attributes>. Todos os elementos <client_attr> são opcionais. Se houver um elemento filho <website>, ele precisará ser posicionado antes de qualquer elemento <client_attr>.
<image>	Optional	Object	Tag repetida, contém informações detalhadas da imagem.

Exemplo

O exemplo a seguir mostra uma lista parcial de hotéis 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 resenha editorial ou de usuário. Não é necessário incluir todas as avaliações de uma ficha no elemento <listing>. Esse elemento serve para incluir avaliações selecionadas que indicam os recursos ou a qualidade da página.

O elemento <review> aparece no seguinte local na hierarquia XML do feed de lista de hotéis:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

Importante: antes que as avaliações de terceiros possam ser integradas ao Google, você precisa configurar um Contrato de Licenciamento de Conteúdo (CLA, na sigla em inglês). Leia o artigo Como enviar avaliações de terceiros ao Google e entre em contato com o gerente da conta de vendas para mais informações.

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 destes valores: editorial: uma avaliação feita por um site ou outra autoridade competente. user: é uma avaliação de um usuário final.

Elementos filhos

O elemento <review> tem os seguintes elementos filhos:

Importante :especifique os elementos filhos na ordem mostrada abaixo.

Elemento filho	Obrigatório?	Tipo	Descrição
<link>	Optional	string	Um link para a avaliação. Inclua "http://" ou "https://" no 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". Também pode ser o nome de um site ou publicação em que a avaliação aparece, caso ela não esteja creditada.
<rating>	Optional	string	Um número de ponto flutuante de 0 a 10 (inclusive) representando a pontuação da avaliação. Por exemplo, "8,9".
<body>	Optional	string	O texto da avaliação. Este 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 você especifica com os seguintes atributos desse elemento: day: o dia do mês, por exemplo, "7". month: o mês, em que 1 = janeiro ... 12 = dezembro. year: o ano com quatro dígitos, por exemplo,"2023". Por exemplo, 7 de junho de 2023 é escrito da seguinte forma: <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 está sendo revisada. O formato é o mesmo do <data> acima. Por exemplo, 7 de junho de 2023 é escrito da seguinte forma: <servicedate month="6" day="7" year="2023"/> Avaliações sem o mês e o ano de <servicedate> preenchidos não podem ser exibidas. O dia não é obrigatório.

Observe que <title> será um elemento filho válido de <review> somente se o type da avaliação for editorial, e <date> será válido somente se type for user.

Exemplo

O exemplo a seguir mostra uma lista parcial de hotéis 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 as comodidades da propriedade e classificar notas e avaliações.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>

Importante :todos os atributos são opcionais.

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 os attribute_name ou attribute_name para aluguéis por temporada compatíveis.

Valores do marcador de posição "attribute_name"

A tabela a seguir lista os valores válidos para attribute_name no elemento <client_attr name="attribute_name">.

Valores para attribute_name	Descrição	Valores de conteúdo válidos
alternate_hotel_id	Um identificador alternativo para sua propriedade. Esses IDs são úteis quando você precisa de um identificador de propriedade para as informações do feed e outro para o mecanismo de reservas.	Qualquer valor de string
custom_[0-4]	Qualquer atributo personalizado do tipo 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 do Lodging.	String codificada em Base64 do proto codificado Lodging
num_reviews	Número de avaliações da ficha.	Qualquer número inteiro não negativo.
rating	Um número de ponto flutuante que representa a classificação da propriedade agregada.	Esse número normalmente é de 0 a 5, de 0 a 10 ou de 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 o exemplo de XML e os atributos específicos para aluguéis por temporada.

<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 do Googlebot Image.

• Se o site incluir um robots.txt no nível raiz, verifique se ele contém uma das duas opções abaixo:

  1. Permite que o rastreador do Googlebot rastreie o conteúdo do seu site, as imagens incluídas.

     • User agent: Googlebot
     • Allow: /

  2. Permite que o rastreador do Googlebot Image 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 originais e reais.

Importante :somente os parceiros configurados para mostrar imagens aos usuários finais podem ter as imagens listadas nas plataformas do Google. Entre em contato com seu Gerente técnico de contas (TAM) para atualizar suas configurações de imagem.

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 "url" para especificar a imagem que será usada na página.
width	Required	A non-negative integer	Largura da imagem, em pixels (recomenda-se que seja maior que 720 pixels)
height	Required	A non-negative integer	Altura da imagem, em pixels (recomenda-se que seja maior que 720 pixels)

Elementos filhos

Importante :especifique os elementos filhos na ordem mostrada abaixo.

Elemento filho	Obrigatório?	Descrição
<link>	Solicitado, mas obrigatório para fichas de fotos locais.	Essa tag contém o URL válido e atualizado da página no site em que a imagem relevante está localizada. 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 obrigatório	O 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 parcial de hotéis 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 os arquivos XML da lista de hotéis com o Esquema XSD do Google.

• Use a codificação UTF-8. Para especificar esse esquema de codificação, inclua 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ções CDATA, não use caracteres especiais de escape.

• Use códigos de escape para valores de dados que não estejam nas seções CDATA, incluindo URLs. É possível usar o código de entidade ou o código de caractere para representar esses caracteres especiais. A tabela a seguir lista os códigos comuns de entidade e caractere que podem ser usados:

  com caracteres	Entidade	Código de caracteres
  "E" comercial (&)	&	&
  Aspas simples (')	'	'
  Aspas duplas (")	"	"
  Maior que (>)	>	>
  Menor que (<)	&lt;	&#60;

• Omita elementos XML que não contenham dados. Por exemplo, se você não sabe a latitude e a longitude de um hotel, não inclua elementos vazios <latitude/> e <longitude/>.

• Não use HTML nos elementos XML em nenhuma circunstância (mesmo que ele tenha escape).

• Para validar seu feed antes de fazer o upload, use o feed local XSD http://www.gstatic.com/localfeed/local_feed.xsd.

• Para usar comentários no seu feed, envolva-os nas tags <!-- e -->, como mostra o exemplo a seguir:

  <!-- This is a comment -->
  

• Feche o elemento <date> em um usuário <review>. Exemplo:

  <date day="2" month="12" year="2017"/>