Atributos

Esta página aborda as descrições, os valores e os requisitos para atributos e elementos filhos. Esses valores são aplicáveis apenas a propriedades de aluguel por temporada.

A estrutura geral do XML tem um formato semelhante aos feeds de página de detalhes do hotel. Consulte a Referência XML da lista de hotéis.

Se os itens obrigatórios a seguir não forem incluídos, a ficha será desativada automaticamente:

  • Elementos filhos XML obrigatórios: id, name, latitude, longitude, address.
  • Atributos obrigatórios: capacity e website. Consulte os links diretos para aluguéis por temporada no feed com suas informações. Isso dá aos usuários a oportunidade de visitar o site da propriedade.

Para mais detalhes sobre os elementos filhos XML obrigatórios, consulte Elementos filhos XML.

Para mais informações sobre aluguel por temporada, consulte Atributos exclusivos para aluguel por temporada.

Por fim, quando o Google determina de outras fontes que o valor de um atributo é diferente do especificado no feed de um anúncio de aluguel por temporada, o Google mostra o valor do anúncio. Por exemplo, se o Google determinar pelas fotos de uma listagem que ela tem uma cozinha, mas o atributo kitchen estiver ausente ou definido como No, o Google vai tratar a listagem como se ela tivesse uma cozinha. Esses atributos são chamados de "atributos inferidos" e só são mostrados quando há um alto nível de confiança na acurácia da inferência.

<review>

Contém uma avaliação de usuário ou editorial. Não é necessário incluir todas as avaliações de uma página nos detalhes do app no elemento <listing>. Esse elemento é destinado à inclusão de 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 da 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 avaliaçã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 (Somente avaliações editoriais) O título da avaliação.
<author> Optional string O autor da avaliação. Por exemplo, "Susan von Trapp". Esse 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 (Somente avaliações de usuários) A data da avaliação, que você especifica com os seguintes atributos deste elemento:
  • day: o dia do mês. Por exemplo, "7".
  • month: o mês, em que 1 = janeiro ... 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 (Somente avaliações de usuários) A data em que o avaliador acessou a página "Detalhes do app" que está sendo avaliada. O formato é o mesmo de <date>.

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.

Exemplo

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

Valores para o marcador "attribute_name"

A tabela a seguir fornece uma lista de valores válidos para attribute_name no elemento <client_attr name="attribute_name">. No entanto, é recomendável fornecer seu attribute_name adicional, se disponível.

Valores para attribute_name Obrigatório? Descrição Valores de conteúdo válidos
capacity Required Número máximo de hóspedes que a propriedade pode acomodar. Esse valor precisa ser igual ou maior que "number_of_bedrooms". Non-negative integer value
website Required O URL do site da propriedade. Free text
partner_hygiene_link Strongly recommended Link para o site de um parceiro externo com mais informações sobre os detalhes de higiene da página. Free text (the site's URL)
number_of_bathrooms Strongly recommended Número de banheiros. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended Número de quartos. Non-negative integer value
number_of_beds Strongly recommended Número de camas em todos os quartos. Non-negative integer value
self_checkin_checkout Recommended Indica se a propriedade aceita self check-in e check-out. Yes/No/Unknown
rating Strongly recommended 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. Non-negative float value
rating_num Strongly recommended Número de avaliações que a propriedade tem. Non-negative integer value
rating_scale Strongly recommended A classificação máxima possível para uma propriedade. Por exemplo, a propriedade "rating" precisa ser 3 ou 4 para uma "rating_scale" de 5.

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

Non-negative integer value
instant_bookable Strongly recommended Indica se a propriedade pode ser reservada instantaneamente pelo processo de finalização da compra. A alternativa é aguardar aprovação. Yes/No/Unknown
description Strongly recommended Texto livre que descreve as qualidades únicas da propriedade. Free text
category Strongly recommended O tipo de propriedade, como uma casa de luxo, um bangalô, um chalé ou um apartamento Free text
ac Recommended Se a propriedade tem ar condicionado. Yes/No/Unknown
beach_access Recommended Se a propriedade tem acesso a uma praia pública próxima. Yes/No/Unknown
check_in_time Recommended Hora exata do dia para fazer check-in na propriedade. HHMM, HH:MM ou HH:MM:SS são formatos aceitos. Por exemplo, use 14:00 em vez de 2pm ou 2:00pm. Todos os outros formatos não serão analisados nem mostrados. Time
check_out_time Recommended Hora exata do dia para fazer o check-out da propriedade. Formato HHMM, HH:MM ou HH:MM:SS aceito. Por exemplo, use 11:00 em vez de 11h ou 11:00h. Todos os outros formatos não serão analisados nem mostrados. Time
child_friendly Recommended Se a propriedade é adequada para crianças. Yes/No/Unknown
crib Recommended Se a propriedade oferece um berço. Yes/No/Unknown
elevator Recommended Se a propriedade tem elevador. Yes/No/Unknown
gym_fitness_equipment Recommended Se a propriedade tem academia ou equipamentos de ginástica. Yes/No/Unknown
heating Recommended Se a propriedade tem aquecimento. Yes/No/Unknown
hot_tub Recommended Se a propriedade tem banheira de hidromassagem. Yes/No/Unknown
ironing_board Recommended Se a propriedade tem tábuas de passar disponíveis. Yes/No/Unknown
kitchen Recommended Se a propriedade tem cozinha. Yes/No/Unknown
microwave Recommended Se a propriedade tem um micro-ondas disponível. Yes/No/Unknown
min_days_advance_purchase Recommended Número mínimo de dias de antecedência para reservar a propriedade. Non-negative integer value
min_night_stay Recommended Número mínimo de noites que um hóspede pode reservar na propriedade. Positive integer (more than zero)
max_night_stay Recommended Número máximo de noites que um hóspede pode reservar a propriedade. Positive integer (more than zero)
outdoor_grill Recommended Se a propriedade tem uma churrasqueira. Yes/No/Unknown
oven_stove Recommended Se a propriedade tem um fogão. Yes/No/Unknown
parking_type Recommended Tipo de estacionamento disponível na propriedade. Free/Paid/None
patio Recommended Se a propriedade tem um terraço. Yes/No/Unknown
pets_allowed Recommended Alguns ou todos os quartos permitem que os hóspedes levem animais de estimação (cães ou gatos que não sejam animais de serviço). Yes/No/Unknown
pool_type Recommended Tipo de piscina (acesso à piscina) que a propriedade tem. Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended O tipo de sala. ENTIRE_PLACE é o único valor compatível. ENTIRE_PLACE
smoking_free_property Recommended Se a propriedade é exclusiva para não fumantes ou se não é permitido fumar. Yes/No/Unknown
special_service_level Recommended Se o nível de serviço da ficha é especial de alguma forma. Por exemplo, verified, luxury, premium Yes/No/Unknown
square_footage Recommended A área da propriedade em pés quadrados. Non-negative float value
square_meters Recommended A área do imóvel em metros quadrados. Non-negative float
tv Recommended Se a propriedade tem uma TV. Yes/No/Unknown
washer_dryer Recommended Se a propriedade tem eletrodomésticos para lavanderia. Yes/No/Unknown
wheelchair_accessible Recommended Se a propriedade é acessível a pessoas em cadeira de rodas. Yes/No/Unknown
internet_type Recommended Tipo de acesso à Internet Wi-Fi fornecido pela propriedade. Free/Paid/None
airport_shuttle Optional Se o anfitrião oferece transporte para ou do aeroporto ou outros terminais. Yes/No/Unknown
balcony Optional Se a propriedade tem sacada. Yes/No/Unknown
fire_place Optional Se a propriedade tem uma lareira. Yes/No/Unknown
free_breakfast Optional Se a propriedade oferece café da manhã gratuito incluído. Yes/No/Unknown
host_description Optional Descrição do anfitrião do aluguel por temporada. Free text
host_language Optional Os idiomas que o anfitrião fala. Uma lista separada por vírgulas de códigos de idioma. Por exemplo: de, en
host_name Optional Nome do anfitrião do aluguel por temporada. Free text
host_response_rate Optional Taxa de resposta média do host. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Tempo médio de resposta do host. Free text
license_num Optional O número da licença (turista ou empresa) que deve ser exibido para propriedades em determinadas regiões do mundo. Ele pode ser repetido e, se houver várias licenças, sugerimos adicionar a autoridade da licença como contexto; por exemplo: "Paris: 123456ABC". Free text
number_of_half_bathrooms Optional Número de banheiros sem chuveiro. Non-negative integer value
number_of_living_rooms Optional Número de salas de estar. Non-negative integer value
private_beach_access Optional Se a propriedade tem acesso exclusivo a uma praia não pública. Yes/No/Unknown
refund_policy Optional Política de reembolso da propriedade. Free text

Elementos filhos XML

Os seguintes elementos filhos XML são obrigatórios:

Elemento filho Obrigatório? Tipo Descrição
<country> Strongly recommended string O país em que a ficha está localizada. O valor precisa ser um código de país de duas letras da ISO 3116. Por exemplo, os Estados Unidos são US e o Canadá é CA: 
    <country>US</country>
<id> Required string O identificador exclusivo da propriedade. Cada aluguel por temporada precisa ter um ID exclusivo do seu site, que nunca deve ser reutilizado.
<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.
<name> Required string O nome da propriedade. No máximo 300 caracteres.
<address> Required string or Object

O local físico completo da propriedade como uma string. O endereço precisa incluir um nome e um número de rua. Se não houver, o endereço deve incluir um Plus Code. Se aplicável, inclua também o número do apartamento ou da unidade.

Como alternativa, você pode fornecer um endereço "composto". Use elementos filhos <component> para descrever cada uma das seguintes partes do endereço:

  • addr1: o endereço principal da rua.
  • addr2: se necessário, o endereço secundário, incluindo o número da unidade.
  • city: a cidade.
  • province: se necessário, o estado, a região ou a província.
  • postal_code: o código postal.
  • country: o país.

Caixas postais ou outros endereços somente para envio de correspondências não são considerados endereços físicos completos.

Exemplos de um endereço completo:

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Confira exemplos de um endereço completo usando um plus code:

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Evite o seguinte:

  • Informações redundantes: não inclua informações irrelevantes nem repita componentes de endereço.
  • Endereço de rua ausente: os endereços precisam ter um nome de rua e um número.

Exemplo de anúncio de aluguel por temporada

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">ENTIRE_PLACE</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>