Esta página aborda as descrições, valores e requisitos para atributos e elementos filhos. Esses valores são aplicáveis apenas a propriedades de aluguel por temporada.
A estrutura XML geral tem um formato semelhante aos feeds de fichas de hotéis. Consulte Referência XML da lista de hotéis
A não inclusão dos seguintes itens obrigatórios desativa automaticamente o ficha:
- Elementos filhos XML obrigatórios:
id,name,latitude,longitude,address. - Atributos obrigatórios:
capacityewebsite. Confira os links diretos para aluguéis por temporada. no seu feed de fichas. Isso dá aos usuários a oportunidade de visitar a propriedade site.
Para detalhes sobre os elementos filhos XML obrigatórios, consulte XML filho elementos.
Para mais informações sobre aluguéis por temporada, consulte Atributos exclusivos para aluguéis por temporada.
Por fim, quando o Google determina, com base em outras fontes, que o valor de
attribute for diferente de
especificado no feed de uma listagem de aluguel por temporada, o Google exibe
para a listagem. Por exemplo, se o Google determinar com base nas fotos de uma ficha
que tem uma cozinha, mas o atributo kitchen está ausente ou definido como No.
O Google trata a listagem como se fosse uma cozinha. Esses atributos são chamados
"atributos inferidos", que são exibidos somente quando há alto nível de confiança
na acurácia da inferência.
Valores do marcador de posição "attribute_name"
A tabela a seguir fornece uma lista de valores válidos para attribute_name em
o elemento <client_attr name="attribute_name">; No entanto,
recomendamos que você informe o valor adicional de attribute_name, 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 deve ser igual ou maior que "número_de_quartos". | Non-negative integer value |
| website | Required | O URL do site da propriedade. | Free text |
| partner_hygiene_link | Strongly recommended | Link para o site do parceiro externo com mais informações sobre a detalhes de integridade da listagem. | 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 | Se a propriedade permite check-in e check-out automáticos. | Yes/No/Unknown |
| rating | Strongly recommended | Um número de ponto flutuante que representa a classificação da propriedade agregada. Isso normalmente é de 0-5, 0-10 ou 0-100, mas você pode usar qualquer intervalo que representa seu sistema de classificação. | Non-negative float value |
| rating_num | Strongly recommended | Número de notas que a propriedade tem. | Non-negative integer value |
| rating_scale | Strongly recommended | Classificação máxima possível para uma propriedade | Non-negative integer value |
| instant_bookable | Strongly recommended | Se a propriedade pode ser reservada instantaneamente pelo processo de check-out. A alternativa é aguardar aprovação. | Yes/No/Unknown |
| description | Strongly recommended | Texto em formato livre descrevendo as qualidades únicas da propriedade | Free text |
| category | Strongly recommended | O tipo de propriedade, como uma casa de campo, bangalô, chalé ou 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 ao . | Yes/No/Unknown |
| check_in_time | Recommended | Hora exata do dia para o check-in na propriedade. HHMM, HH:MM ou HH:MM:SS formato aceito, por exemplo, use 14h em vez de 14h ou 14h. Todos e outros formatos não serão analisados nem exibidos. | Time |
| check_out_time | Recommended | Hora exata do dia para o check-out da propriedade. HHMM, HH:MM ou HH:MM:SS formato aceito, por exemplo, use 11h em vez de 11h ou 11h. Todos e outros formatos não serão analisados nem exibidos. | Time |
| child_friendly | Recommended | Se a propriedade é adequada para crianças. | Yes/No/Unknown |
| crib | Recommended | Se a propriedade tem 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 equipamento 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 roupa 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 para reservar a propriedade. | Positive integer (more than zero) |
| max_night_stay | Recommended | Número máximo de noites que um hóspede pode reservar na 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 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 pátio. | Yes/No/Unknown |
| pets_allowed | Recommended | Alguns ou todos os quartos permitem que os hóspedes tragam animais de estimação, como cães ou gatos que não são animais de serviço. | Yes/No/Unknown |
| pool_type | Recommended | Tipo de piscina (acesso à piscina) que a propriedade tem. | Indoors, Outdoors, Indoors/Outdoors, None |
| smoking_free_property | Recommended | Indica se a propriedade é exclusiva para não fumantes ou é proibida para fumar. | Yes/No/Unknown |
| special_service_level | Recommended | Se o nível de serviço da ficha da empresa é 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 da propriedade em metros quadrados. | Non-negative float |
| tv | Recommended | Se a propriedade tem uma TV. | Yes/No/Unknown |
| washer_dryer | Recommended | Se a propriedade tem utensílios de lavanderia. | Yes/No/Unknown |
| wheelchair_accessible | Recommended | Se a propriedade é acessível para cadeirantes. | Yes/No/Unknown |
| internet_type | Recommended | O tipo de acesso à Internet Wi-Fi fornecido pela propriedade. | Free/Paid/None |
| airport_shuttle | Optional | Se o anfitrião oferece transporte de ida e volta para o aeroporto ou outros terminais. | Yes/No/Unknown |
| balcony | Optional | Se a propriedade tem sacada. | 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 |
| host_description | Optional | Descrição do host de aluguel por temporada. | Free text |
| host_language | Optional | Idiomas que o organizador fala. | Uma lista separada por vírgulas de
idioma
códigos por exemplo: de, en |
| host_name | Optional | Nome do host de aluguel por temporada. | Free text |
| host_response_rate | Optional | Taxa média de resposta 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 | Número da licença (turista ou empresa) a ser exibido para as propriedades em determinadas regiões do mundo. Ele pode ser repetido e, se vários se as licenças existirem, sugerimos adicionar a autoridade da licença como contexto. por exemplo: "Paris: 123456ABC". | Free text |
| number_of_half_bathrooms | Optional | Número de banheiros. | 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 esta ficha está localizada. O valor deve ser um
ISO 3116
O código do país com duas letras por exemplo, Estados Unidos é US
e Canadá é CA:
<country>US</country>
|
| <id> | Required | string | O identificador exclusivo da propriedade. Vale lembrar que cada aluguel por temporada precisa ter um ID exclusivo do seu site, e esse ID nunca deve ser reutilizadas. |
| <latitude> | Required | float | A latitude correspondente ao local da lista. Para
exemplo:
<latitude>37.423738</latitude>
Esse valor pode ser gerado com ferramentas de GeoCoding, como API Google Maps. |
| <longitude> | Required | float | A longitude correspondente ao local da lista. Para
exemplo:
<longitude>-122.090101</longitude>
Esse valor pode ser gerado com ferramentas de GeoCoding, como API Google Maps. |
| <name> | Required | string | O nome da propriedade. No máximo 300 caracteres. |
| <address> | Required | string or Object | A localização física completa da propriedade como uma string. O endereço deve incluir um nome de rua e número. Se não houver nenhum, o endereço deverá incluir um Plus Code. Os números de apartamento ou unidade também precisam ser incluídos, se aplicável. Como alternativa, você pode fornecer um "composto" endereço IP. Usar
Observe que a caixa postal ou outros endereços somente para correspondência não são considerados endereços físicos completos. Veja alguns exemplos de um endereço completo: <address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address> <address> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Apt. 2</component> <component name="city">Sidney</component> <component name="postal_code">V8L 3B8 9TQ</component> <component name="country">Canada</component> </address> Veja alguns exemplos de um endereço completo usando um Plus Code: <address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address> <address> <component name="addr1">84WRMJ53+HM</component> <component name="city">Sidney</component> <component name="postal_code">V8L 3B8 9TQ</component> <component name="country">Canada</component> </address> Evite o seguinte:
|
Exemplo de listagem 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>