Esta página aborda as descrições, os valores e os requisitos de atributos e elementos filhos. Esses valores são aplicáveis apenas a propriedades para aluguel por temporada.
A estrutura XML geral tem formato semelhante aos feeds de listagem de hotéis. Consulte a referência XML da lista de hotéis.
Se os itens obrigatórios a seguir não forem incluídos, a ficha da empresa será automaticamente desativada.
- Elementos XML filhos obrigatórios:
id,name,latitude,longitude. - Atributos obrigatórios:
capacityewebsite.- Veja um exemplo do link direto do site para a propriedade no seu feed de fichas. Isso dá aos usuários a oportunidade de visitar o site da propriedade.
- Elemento filho XML opcional (altamente recomendado):
location_precision. O padrão é 500 metros.
Para ver detalhes sobre os elementos filhos do XML necessários, consulte Elementos filhos XML.
Para mais informações sobre aluguéis por temporada, consulte Atributos exclusivos para aluguel por temporada.
Por fim, quando o Google determinar de outras fontes que o valor de um
atributo é diferente do
especificado no feed para uma listagem de aluguel por temporada, vamos mostrar
o valor para a listagem. Por exemplo, se determinarmos pelas fotos de uma ficha que
ele tem uma cozinha, mas o atributo kitchen estiver ausente ou definido como No, vamos
considerar que o anúncio tem uma cozinha. Esses atributos são chamados de "atributos
inferidos" e só serão exibidos quando estivermos muito confiantes na
precisão da inferência.
Valores do marcador attribute_name
Esta tabela fornece uma lista de valores válidos para attribute_name no
elemento <client_attr name="attribute_name">. No entanto, os parceiros são
incentivados a fornecer qualquer attribute_name adicional que possam ter.
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_quarts". | Non-negative integer |
| website | Required | O URL do site da propriedade. | Free text |
| min_days_between_stays | Optional (strongly recommended) | O número mínimo de "dias de reserva" para o aluguel precisa estar vazio após a partida dos ocupantes anteriores. | Non-negative integer |
| enhanced_cleaning_practices | Optional (strongly recommended) | Indica se a propriedade usa práticas de limpeza avançadas com uma descrição no site do parceiro. | Yes/No/Unknown |
| partner_hygiene_link | Optional (strongly recommended) | Link para o site do parceiro externo com mais informações sobre os detalhes de integridade da ficha da empresa. | Free text (the site's URL) |
| number_of_bathrooms | Optional (strongly recommended) | Número de banheiros. | Non-negative float value, for example, 1, 1.5, 2 |
| number_of_bedrooms | Optional (strongly recommended) | Número de quartos. | Non-negative integer value |
| number_of_beds | Optional (strongly recommended) | Número de camas em todos os quartos. | Non-negative integer value |
| self_checkin_checkout | Optional (strongly recommended) | Se a propriedade permite check-in e check-out. | Yes/No/Unknown |
| rating | Optional (strongly recommended) | Um número de ponto flutuante que representa a classificação da propriedade agregada. Esse número geralmente é 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 | Optional (strongly recommended) | Número de avaliações da propriedade. | Non-negative integer |
| ac | Optional | Se a propriedade tem ar-condicionado. | Yes/No/Unknown |
| airport_shuttle | Optional | Se o anfitrião oferece transporte de/para o aeroporto ou outros terminais. | Yes/No/Unknown |
| balcony | Optional | Se a propriedade tem sacada. | Yes/No/Unknown |
| beach_access | Optional | Se a propriedade tem acesso a uma praia pública próxima a ela. | Yes/No/Unknown |
| check_in_time | Optional | Horário exato do check-in na propriedade. O formato HHMM, HH:MM ou HH:MM:SS é aceito. Por exemplo, use 14:00 em vez de 14:00 ou 14:00. Todos os outros formatos não serão analisados nem exibidos. | Time |
check_out_time |
Optional | Horário exato do dia para check-out na propriedade. O formato HHMM, HH:MM ou HH:MM:SS é aceito. Por exemplo, use 11:00 em vez de 11:00 ou 11:00. Todos os outros formatos não serão analisados nem exibidos. | Time |
| child_friendly | Optional | Indica se a propriedade é adequada para crianças. | Yes/No/Unknown |
| crib | Optional | Se a propriedade oferece um berço. | Yes/No/Unknown |
| elevator | Optional | Se a propriedade tem elevador. | Yes/No/Unknown |
| fire_place | Optional | Se a propriedade tem lareira. | Yes/No/Unknown |
| free_breakfast | Optional | Se a propriedade tem café da manhã incluso. | Yes/No/Unknown |
| gym_fitness_equipment | Optional | Se a propriedade tem academia ou equipamentos de ginástica. | Yes/No/Unknown |
| heating | Optional | Indica se a propriedade tem aquecimento. | Yes/No/Unknown |
| hot_tub | Optional | Se a propriedade tem banheira de hidromassagem. | Yes/No/Unknown |
| instant_bookable | Optional | Se a propriedade pode ser reservada instantaneamente pelo processo de finalização da compra. A alternativa está aguardando aprovação. | Yes/No/Unknown |
| ironing_board | Optional | Se a propriedade tem tábuas de passar roupa disponíveis. | Yes/No/Unknown |
| kitchen | Optional | Se a propriedade tem cozinha. | Yes/No/Unknown |
| license_num | Optional | Número de licença (turista ou empresa) necessário para mostrar as propriedades em determinadas regiões do mundo. Ele pode ser repetido e, se houver várias licenças, sugerimos adicionar autoridade da licença como contexto. Por exemplo: "Paris: 123456ABC". | Free text |
| microwave | Optional | Se a propriedade tem micro-ondas disponível. | Yes/No/Unknown |
| minimum_days_advance_purchase | Optional | Número mínimo de dias de antecedência para reservar a propriedade. | Non-negative integer |
| minimum_night_stay | Optional | O número mínimo de noites que um hóspede pode reservar na propriedade. | Positive integer (more than zero) |
| max_night_stay | Optional | Número máximo de noites que um hóspede pode reservar na propriedade. | Positive integer (more than zero) |
| number_of_living_rooms | Optional | Número de salas de estar. | Non-negative integer value |
| outdoor_grill | Optional | Se a propriedade tem churrasqueira. | Yes/No/Unknown |
| oven_stove | Optional | Se a propriedade tem fogão. | Yes/No/Unknown |
| parking_type | Optional | Tipo de estacionamento disponível na propriedade. | Free/Paid/None |
| patio | Optional | Se a propriedade tem um pátio. | Yes/No/Unknown |
| pets_allowed | Optional | Alguns ou todos os quartos permitem que os hóspedes levem animais de estimação (cães ou gatos que não são animais de serviço) com eles. | Yes/No/Unknown |
| pool_type | Optional | Tipo de pool (acesso ao pool) que a propriedade tem. | Indoors, Outdoors, Indoors/Outdoors, None |
| private_beach_access | Optional | Se a propriedade tem acesso dedicado a uma praia particular. | Yes/No/Unknown |
| room_type | Optional | Tipo de propriedade que está sendo compartilhada com o Google.
Observação: por enquanto, aceita apenas o lugar inteiro. |
Entire Place, Shared room, Private Room |
| smoking_free_property | Optional | Se a propriedade é exclusiva para não fumantes ou não é permitido fumar. | Yes/No/Unknown |
| square_footage | Optional | A área da propriedade em pés quadrados. | Non-negative float value |
| square_meters | Optional | A área da propriedade em metros quadrados. | Non-negative float |
| tv | Optional | Indica se a propriedade tem TV. | Yes/No/Unknown |
| washer_dryer | Optional | Se a propriedade tem utensílios de lavanderia. | Yes/No/Unknown |
| wheelchair_accessible | Optional | Se a propriedade tem acessibilidade para cadeirantes. | Yes/No/Unknown |
| internet_type | Optional | Tipo de acesso à Internet por Wi-Fi fornecido pela propriedade. | Free/Paid/None |
| host_language | Optional | Idiomas que o host fala. | Uma lista separada por vírgulas de códigos de idioma, por exemplo: de, en |
Elementos XML filhos
Os seguintes elementos XML filhos são obrigatórios:
| Elemento filho | Obrigatório? | Tipo | Descrição |
|---|---|---|---|
| <country> | Optional (strongly recommended) | string | O país em que a ficha da empresa está localizada. O valor precisa ser um código de país ISO 3116 com duas letras maiúsculas. Por exemplo, os Estados Unidos são US e o Canadá é CA:
<country>US</country>
|
| <id> | Required | string | Identificador exclusivo da propriedade. Cada aluguel por temporada precisa ter um ID exclusivo do seu site e 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 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 (strongly recommended) | integer | Precisão do local da propriedade enviada em metros, geralmente 500 metros ou mais, quando a latitude e a longitude da propriedade são ofuscadas.
O padrão é 500 metros. Zero significa que não há ofuscação e que esse é o local exato, e menos de 100 metros é considerado exato.
Este elemento se aplica apenas a aluguéis por temporada. |
| <name> | Required | string | O nome da propriedade. No máximo 300 caracteres. |
Exemplo de listagem de aluguéis 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">Detailed Address</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>
<location_precision>500</location_precision>
<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="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="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="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="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="smoking_free_property">Yes</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>