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 da lista de hotéis não contém informações de preços.

O elemento raiz de uma lista de hotéis é <listings>, que contém elementos <listing> que descrevem suas propriedades.

Você cria uma lista de hotéis como parte da 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 incluindo o atributo encoding na tag XML.

Depois de criar uma lista de hotéis, você pode fazer upload manual para o Google em https://support.google.com/hotelprices/ ou hospedar 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:

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 camping e outros estabelecimentos de camping com paredes fixas, encanamento e controle de temperatura (incluindo fogões a lenha ou aquecedores a propano) são qualificados. As acomodações ao ar livre que não se qualificam incluem:

  • Locais para acampamento com tendas para os hóspedes
  • Estacionamentos de trailers, em que os hóspedes trazem os próprios veículos

<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 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 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 datum 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 para esse elemento será WGS84, que é usado pela maioria dos dispositivos GPS modernos. O datum de Tóquio só é aplicável 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 para seu site, e esse ID 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 de 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 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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> de lista de hotéis.

O elemento <listing> aparece no seguinte lugar 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 para seu site em todos os momentos. 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, informe 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 da rua secundária, 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 da localização da propriedade enviada em metros quando a latitude e a longitude da propriedade são ofuscadas. Zero (0) significa que não há ofuscação e que é 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 ficha for de uma filial, informe o número de telefone específico do local (não o da sede central).

O atributo type pode ser um dos seguintes:

  • fax: número de telefone do fax.
  • main: número de telefone principal.
  • mobile: número de telefone celular.
  • tdd: número de telefone do dispositivo de telecomunicações para surdos (TDD).
  • tollfree: número de telefone gratuito.

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 as categorias internas que tiverem para descrever a propriedade, como "hotéis de negócios", "resorts", "motéis" e semelhantes.
<content> Optional <content> Detalhes opcionais usados para a ficha, como descrição, classificações e recursos do imóvel.

* É 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 de 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 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 um anúncio, como classificações, comodidades e outros detalhes. O elemento <content> é opcional. Em <content>, todos os elementos filhos são opcionais.

O elemento <content> aparece no seguinte lugar 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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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 da empresa do provedor. 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 página. Sua página 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>. Ele foi criado para que você inclua avaliações selecionadas que ilustrem os recursos ou a qualidade da ficha.

Importante: <review> só deve ser enviado para contas de aluguel por temporada. Entre em contato com seu gerente técnico de contas (TAM, na sigla em inglês) para mais informações.
<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 dos 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 que 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 e classificar as avaliações de uma propriedade.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <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 especificada usando attribute_name ou attribute_name para aluguel por temporada.

Valores para o marcador "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
Descontinuado:qualquer atributo personalizado do tipo string. Elas não são mostradas aos usuários.

Importante:entre em contato com seu gerente técnico de contas (TAM) se quiser usar variáveis CUSTOM.

 Qualquer valor de string
hotel_brand A rede do hotel. Por exemplo, "Marriott" ou "Hilton". Ela não é exibida aos usuários, mas pode ser usada para agrupar hotéis. Siga a RFC 3986 (sintaxe genérica de URI):
  • Caracteres permitidos: A-Z a-z 0-9 - _ . ~ (space)
  • Caracteres restritos: : / ? # [ ] @ ! $ & ' ( ) * + , ; = %
lodging Representação codificada de todos os campos disponíveis no proto Lodging. String codificada em base64 do proto encoded Lodging
num_reviews Número de avaliações da página de detalhes.

Importante: "num_reviews" só deve ser enviado para feeds de aluguel por temporada.

 Qualquer número inteiro não negativo.
rating Um número de ponto flutuante que representa a classificação agregada da propriedade. Normalmente, esse número 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 escala de classificação de 5.

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

Valores para o marcador de posição "attribute_name" de aluguéis por temporada

Consulte Atributos específicos para aluguéis por temporada e exemplo de XML.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <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 rastreador Googlebot-Image precisa ter acesso ao URL da imagem.

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

    1. Permite que o rastreador Googlebot acesse 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.

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:
url Required Text O URL da imagem em tamanho real. 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 (recomendamos 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 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 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>
      <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 sua tag XML, conforme mostrado nos exemplos.

  • É possível especificar valores de dados no feed com seções CDATA. Se você usar seções CDATA, não faça o escape de 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 entidades e códigos de caracteres comuns que você pode usar:

    Caractere Entidade Código de 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 ele seja escapado.

  • 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, ajuste o comentário nas tags <!-- e -->, como no exemplo a seguir:

    <!-- This is a comment -->