Nesta página, abordamos 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 geral de XML tem um formato semelhante aos feeds de fichas 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 será desativada automaticamente.
- Elementos filhos XML obrigatórios:
id
,name
,latitude
,longitude
,address
. - Atributos obrigatórios:
capacity
ewebsite
.- Consulte o link direto do site para a propriedade no feed de fichas. Isso dá aos usuários a oportunidade de visitar o site da propriedade.
Para detalhes sobre os elementos filhos XML obrigatórios, consulte Elementos filhos XML.
Para mais informações sobre aluguéis por temporada, consulte Atributos exclusivos para aluguéis por temporada.
Por fim, quando o Google determina por outras fontes que o valor de um atributo é diferente do que é especificado no feed de uma listagem de aluguel por temporada, vamos mostrar o valor para a listagem. Por exemplo, se determinarmos, pelas fotos de uma ficha, que ela tem uma cozinha, mas o atributo kitchen
estiver ausente ou definido como No
, consideraremos a listagem como tendo uma cozinha. Esses atributos são chamados de "atributos
inferidos" e só são exibidos quando estamos muito confiantes na
precisão da inferência.
Valores do 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 attribute_name
extra, se disponível.
Valores para attribute_name |
Obrigatório? | Descrição | Valores de conteúdo válidos |
---|---|---|---|
capacity | Required | O número máximo de hóspedes que a propriedade pode acomodar. Esse valor precisa ser igual ou maior que "number_of_quartos". | Non-negative integer value |
website | Required | O URL do site da propriedade. | Free text |
partner_hygiene_link | Strongly recommended | Link para o site externo do parceiro com mais informações sobre os detalhes de integridade da ficha da empresa. | 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 permite check-in e check-out. | Yes/No/Unknown |
rating | Strongly recommended | Um número de ponto flutuante que representa a classificação da propriedade agregada. Normalmente, esse número vai de 0 a 5, de 0 a 10 ou de 0 a 100, mas é possível 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 | 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 finalização da compra. A alternativa está aguardando aprovação. | Yes/No/Unknown |
description | Strongly recommended | Texto em formato livre que descreve as qualidades exclusivas da propriedade | Free text |
category | Strongly recommended | O tipo de propriedade, como uma casa de campo, um bangalô, uma cabana 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 a ela. | Yes/No/Unknown |
check_in_time | Recommended | Hora exata do dia para 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. Nenhum outro formato será analisado nem exibido. | Time |
check_out_time | Recommended | Hora exata do dia para o 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. Nenhum outro formato será analisado nem exibido. | Time |
child_friendly | Recommended | Indica se a propriedade é adequada para crianças. | Yes/No/Unknown |
crib | Recommended | Indica se a propriedade oferece berços. | 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 roupa disponíveis. | Yes/No/Unknown |
kitchen | Recommended | Se a propriedade tem cozinha. | Yes/No/Unknown |
microwave | Recommended | Se a propriedade tem micro-ondas disponível. | Yes/No/Unknown |
minimum_days_advance_purchase | Recommended | Número mínimo de dias de antecedência para reservar a propriedade. | Non-negative integer value |
minimum_night_stay | Recommended | O 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 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 levem animais de estimação (cães ou gatos que não sejam animais de serviço) com eles. | Yes/No/Unknown |
pool_type | Recommended | Tipo de piscina (acesso à piscina) que a propriedade tem. | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | Se a propriedade é exclusiva para não fumantes ou não é permitido. | Yes/No/Unknown |
special_service_level | Recommended | Indica 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 | Indica se a propriedade tem TV. | Yes/No/Unknown |
washer_dryer | Recommended | Se a propriedade tem utensílios de lavanderia. | Yes/No/Unknown |
wheelchair_accessible | Recommended | Indica se a propriedade é acessível para cadeira de rodas. | Yes/No/Unknown |
internet_type | Recommended | Tipo de acesso à Internet por Wi-Fi fornecido pela propriedade. | Free/Paid/None |
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 |
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 host fala. | Uma lista separada por vírgulas de códigos de idioma, 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 de licença (turista ou comercial) necessário para exibição de propriedades em determinadas regiões do mundo. Pode ser repetido e, se houver várias licenças, sugerimos adicionar autoridade como contexto. Por exemplo: "Paris: 123456ABC". | Free text |
number_of_half_bathrooms | Optional | Número de meios 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 XML filhos
Os seguintes elementos-filho XML são obrigatórios:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<country> | 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 de duas letras. 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 para seu site, e ele 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. |
<name> | Required | string | O nome da propriedade. No máximo 300 caracteres. |
<address> | Required | Object or string | A localização física completa da propriedade. Esse elemento assume um único atributo, No mínimo, você precisa fornecer o endereço, a cidade, o estado ou a região e o CEP da propriedade. Use elementos filhos
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> Outra opção é fornecer um endereço em "formato 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. |
Exemplo de um 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="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>