Referência XML da lista de hotéis

Uma lista de hotéis é um ou mais arquivos XML que listam todos os hotéis para os quais você vai fornecer informações de preços. O arquivo de 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.

Você cria uma lista de hotéis como parte da sua implementação inicial e adiciona ou remove 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 de codificação incluindo o atributo encoding na tag XML.

Depois de criar uma lista de hotéis, você pode fazer o 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 estes artigos:

Requisitos de listagem

Para você poder usar os Anúncios de hotéis no Google, as propriedades da sua lista precisam 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 geralmente não atendem aos critérios de Listing requirements.

Cabanas de acampamento e outros estabelecimentos de acampamento com paredes fixas, encanamento e controle de temperatura (incluindo fogões a lenha ou aquecedores a gás propano) são qualificados. Acomodações ao ar livre que não são qualificadas:

  • Áreas de camping, onde os hóspedes ficam em barracas
  • Estacionamentos para trailers, onde os hóspedes trazem o próprio veículo

<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 lugar na hierarquia do 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 o feed está escrito. Defina o valor desse elemento como um código de idioma de duas letras. Por exemplo, en para o inglês.
<datum> Optional enum Esse elemento especifica o datum geodésico ou o modelo de referência para as coordenadas de latitude/longitude fornecidas no feed. Se nenhum valor de datum for fornecido, o valor padrão para esse elemento será WGS84, que é usado pela maioria dos dispositivos 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. Cada hotel na lista precisa ter um ID exclusivo do seu site e esse ID nunca pode 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 com formato livre

O exemplo a seguir mostra uma lista parcial de hotéis com um endereço de forma 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 listagem 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 do 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 para 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. Exemplo:
<name>Belgrave House</name>
<address> Required Object or string

O local físico completo do hotel.

Esse elemento usa um único atributo, format, que precisa ser definido como simple.

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 <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, da região ou da província do hotel.
  • postal_code: o código postal 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>

Como alternativa, você pode fornecer um endereço "livre", embora isso não seja recomendado. Exemplo:

<address>6 Elm Ave Unit 3, 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 está localizada. O valor precisa ser um código de país de duas letras. Por exemplo, Brasil é "BR" e Estados Unidos é "US". 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 geocodificação, 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 geocodificação, como a API Google Maps.

<location_precision> Optional integer Precisão do local 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 é o local exato. Observação : este elemento se aplica apenas a locações de temporada.
<phone> Required* string

Um ou mais números de contato do hotel. Se a ficha for uma filial da empresa, informe o número de telefone específico da filial, não o número da sede central.

O atributo type pode ser um dos seguintes:

  • fax: número de telefone de fax.
  • main: número de telefone principal.
  • mobile: número de telefone celular.
  • tdd: Dispositivo de telecomunicações para surdos (TDD, na sigla em inglês) número de telefone.
  • tollfree: número de telefone sem custo de ligação.

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>

No mínimo, você precisa fornecer um tipo main.

<category> Optional string O tipo de propriedade, como um hotel. Os parceiros podem usar qualquer categoria interna para descrever a propriedade, como "hotéis de negócios", "resorts", "motéis" e similares.
<content> Optional <content> Detalhes opcionais usados para a listagem, como descrição, classificações e recursos da propriedade.

* É necessário inserir um número de telefone ou latitude/longitude. Recomendamos que você defina os dois.

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 com formato livre

O exemplo a seguir mostra uma lista parcial de hotéis com um endereço de forma 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 listagem 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 listagem, como classificações 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 do 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 à listagem do provedor. Ele apresenta os seguintes elementos filho:

  • <link>: um link para a descrição. Inclua "http://" ou
    "https://" neste 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 do usuário ou uma avaliação editorial da listagem. 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 <listing>. Esse elemento é destinado a incluir avaliações selecionadas que ilustrem os recursos ou a qualidade da ficha.

<attributes> Optional Object

Contém 0 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 conferir uma lista e uma descrição dos elementos filhos, consulte <attributes>.

Todos os elementos <client_attr> são opcionais.

Se houver um elemento filho <website>, ele precisa 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 avaliação do usuário ou editorial. Não é necessário incluir todas as avaliações de uma ficha no elemento <listing>. Esse elemento é destinado a incluir avaliações selecionadas que indicam os recursos ou a qualidade da ficha.

O elemento <review> aparece no seguinte local na hierarquia do 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 um dos seguintes valores:
  • editorial: uma avaliação feita por um site ou outra autoridade de revisão.
  • user: uma avaliação de um usuário final.

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://" neste elemento.
<title> Optional string (Apenas 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 se ela não tiver créditos.
<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 pode conter HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Avaliações do usuário apenas) A data da avaliação, especificada com os seguintes atributos deste elemento:
  • day: o dia do mês. Por exemplo, "7".
  • month: o mês, em que 1 = janeiro e 12 = dezembro.
  • year: o ano de quatro dígitos, por exemplo,"2023".

Por exemplo, 7 de junho de 2023 é escrito como:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Avaliações do usuário apenas) A data em que o usuário avaliou a página "Detalhes do app". O formato é o mesmo que <date> acima.

Por exemplo, 7 de junho de 2023 é escrito como:

<servicedate month="6" day="7" year="2023"/>

As avaliações sem pelo menos o mês e o ano de <servicedate> preenchidos podem não ser mostradas. O dia não é obrigatório.

<title> é um elemento filho válido de <review> apenas se o type da avaliação for editorial, e <date> só é válido se type for user.

Exemplo

O exemplo a seguir mostra uma lista parcial de hotéis com uma listagem que contém um editorial e uma avaliação do 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 as classificações e avaliações dela.

+ <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 precisa 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 attribute_name para aluguel por temporada.

Valores para o 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. Ter IDs separados é útil se você precisar de um identificador de propriedade para as informações do feed e outro para o mecanismo de reserva. Qualquer valor de string
custom_[0-4] Qualquer atributo personalizado do tipo string. Elas não são exibidas aos usuários. Qualquer valor de string
hotel_brand A rede do hotel. Por exemplo, "Marriott" ou "Hilton". Ele não é exibido para os 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 Lodging proto. String codificada em Base64 do proto Lodging codificado
num_reviews Número de avaliações da página de detalhes. Qualquer número inteiro não negativo.
rating Um número de ponto flutuante que representa a classificação agregada da propriedade. Esse número geralmente varia de 0 a 5, 0 a 10 ou 0 a 100, mas você pode usar qualquer intervalo que represente seu sistema de classificação. Por exemplo, a classificação da propriedade precisa ser 3 ou 4 para uma rating_scale de 5.

Observação: a escala de avaliação padrão é 0 a 10 se não for especificada.

Valores para o marcador "attribute_name" em aluguéis por temporada

Consulte Atributos específicos para aluguéis 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 é 4:3.
  • O URL da imagem precisa ser acessível pelo rastreador Googlebot-Image.
  • Se o site incluir um robots.txt no nível raiz, verifique se ele contém uma das duas opções mostradas abaixo:

    1. Permite que o rastreador do Googlebot rastreie o conteúdo do seu site, incluindo imagens.

      • User-agent: Googlebot
      • Allow: /
    2. 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 originais e reais ou fotografias.

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

Uma imagem precisa ser uma das seguintes opções:

url Required Text O URL da imagem em tamanho original. Use o atributo "url" para especificar a imagem a ser usada nessa página.
width Required A non-negative integer Largura da imagem, em pixels (recomenda-se mais de 720 pixels)
height Required A non-negative integer Altura da imagem em pixels (recomendamos 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. 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 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, siga estas 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.

  • É possível especificar valores de dados no seu feed com seções CDATA. Se você usar seções CDATA, não escape caracteres especiais.

  • Use códigos de escape para valores de dados que não estão em seções CDATA, incluindo URLs. Você pode usar o código de entidade ou o código de caractere para representar esses caracteres especiais. A tabela a seguir lista códigos de entidade e de caractere comuns que você pode usar:

    Caractere Entidade Código do caractere
    "E" comercial (&) &amp; &#38;
    Aspas simples (") &apos; &#39;
    Aspas duplas (") &quot; &#34;
    Maior que (>) &gt; &#62;
    Menor que (<) &lt; &#60;
  • Omita elementos XML que não contêm dados. Por exemplo, se você não tiver a latitude e a longitude de um hotel, não inclua elementos <latitude/> e <longitude/> vazios.

  • Não use HTML nos elementos XML em nenhuma circunstância, mesmo que seja codificado.

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

  • Para usar comentários no seu feed, envolva o comentário nas tags <!-- e -->, conforme mostrado no exemplo abaixo:

    <!-- This is a comment -->
    
  • Feche o elemento <date> em um usuário <review>. Exemplo:

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