Questa pagina illustra le descrizioni, i valori e i requisiti per gli attributi e gli elementi secondari. Questi valori sono applicabili solo alle proprietà di case vacanze.
La struttura XML generale ha un formato simile a quello dei feed elenco di hotel. Consulta la pagina di riferimento sul file XML dell'elenco di hotel.
La mancata inclusione dei seguenti elementi obbligatori comporta la disattivazione automatica della scheda:
- Elementi secondari XML obbligatori:
id,name,latitude,longitude,address. - Attributi obbligatori:
capacityewebsite. Consulta la sezione Link diretti per le case vacanze nel feed elenco. In questo modo, gli utenti hanno la possibilità di visitare il sito web della proprietà.
Per informazioni dettagliate sugli elementi secondari XML obbligatori, consulta la sezione Elementi secondari XML.
Per ulteriori informazioni sulle case vacanze, consulta la sezione Attributi specifici per le case vacanze.
Infine, quando Google stabilisce da altre fonti che il valore di un
attributo è diverso da quello
specificato nel feed per una scheda di una casa vacanze, Google mostra il
valore per la scheda. Ad esempio, se Google stabilisce dalle foto di una scheda che è presente una cucina, ma l'attributo kitchen non è presente o è impostato su No, considera che la scheda abbia una cucina. Questi attributi sono chiamati "attributi dedotti" e vengono visualizzati solo quando l'accuratezza dell'inferenza è molto elevata.
Valori per il segnaposto attribute_name
La tabella seguente fornisce un elenco di valori validi per attribute_name nell'elemento <client_attr name="attribute_name">. Tuttavia, ti consigliamo di fornire attribute_name aggiuntivi, se disponibili.
Valori per attribute_name |
Obbligatorio? | Descrizione | Valori validi dei contenuti |
|---|---|---|---|
| capacity | Required | Numero massimo di ospiti consentito per la proprietà. Questo valore deve essere uguale o superiore a "number_of_bedrooms". | Non-negative integer value |
| website | Required | L'URL del sito web della struttura. | Free text |
| partner_hygiene_link | Strongly recommended | Link al sito esterno del partner che fornisce ulteriori informazioni sui dettagli legati all'igiene della proprietà. | Free text (the site's URL) |
| number_of_bathrooms | Strongly recommended | Numero di bagni. | Non-negative float value, for example, 1, 1.5, 2 |
| number_of_bedrooms | Strongly recommended | Numero di camere da letto. | Non-negative integer value |
| number_of_beds | Strongly recommended | Numero di letti in tutte le camere. | Non-negative integer value |
| self_checkin_checkout | Recommended | Indica se la struttura consente il check-in e il check-out automatici. | Yes/No/Unknown |
| rating | Strongly recommended | Un numero con virgola mobile che rappresenta la valutazione complessiva della proprietà. Generalmente questo numero è compreso tra 0 e 5, tra 0 e 10 o tra 0 e 100, ma puoi utilizzare qualsiasi intervallo che rappresenti il tuo sistema di valutazione. | Non-negative float value |
| rating_num | Strongly recommended | Numero di valutazioni della proprietà. | Non-negative integer value |
| rating_scale | Strongly recommended | La valutazione massima possibile per una proprietà. Ad esempio, la valutazione della struttura deve essere 3 o 4 per una scala di valutazione di 5.
Nota: se non specificato, il valore predefinito di rating_scale è 0-10. |
Non-negative integer value |
| instant_bookable | Strongly recommended | Indica se la proprietà può essere prenotata subito tramite la procedura di pagamento. L'alternativa è attendere l'approvazione. | Yes/No/Unknown |
| description | Strongly recommended | Testo libero che descrive le qualità uniche della proprietà | Free text |
| category | Strongly recommended | Il tipo di proprietà, ad esempio villa, bungalow, baita o appartamento | Free text |
| ac | Recommended | Indica se la proprietà è dotata di aria condizionata. | Yes/No/Unknown |
| beach_access | Recommended | Indica se la proprietà ha accesso a una spiaggia pubblica nelle vicinanze. | Yes/No/Unknown |
| check_in_time | Recommended | L'ora del giorno esatta per il check-in nella proprietà. Formato HHMM, HH:MM o HH:MM:SS accettato; ad esempio, utilizza 14:00 anziché 14:00 o 14:00. Tutti gli altri formati non verranno analizzati né visualizzati. | Time |
| check_out_time | Recommended | L'ora del giorno esatta per il check-out dalla proprietà. Formato HHMM, HH:MM o HH:MM:SS accettato. Ad esempio, utilizza 11:00 anziché 11:00 o 11:00. Tutti gli altri formati non verranno analizzati o visualizzati. | Time |
| child_friendly | Recommended | Indica se la proprietà è adatta ai bambini. | Yes/No/Unknown |
| crib | Recommended | Indica se la proprietà fornisce una culla. | Yes/No/Unknown |
| elevator | Recommended | Indica se la proprietà è dotata di ascensore. | Yes/No/Unknown |
| gym_fitness_equipment | Recommended | Indica se la proprietà è dotata di palestra o qualsiasi attrezzatura per il fitness. | Yes/No/Unknown |
| heating | Recommended | Indica se la proprietà è dotata di riscaldamento. | Yes/No/Unknown |
| hot_tub | Recommended | Indica se la proprietà è dotata di vasca idromassaggio. | Yes/No/Unknown |
| ironing_board | Recommended | Indica se la proprietà è dotata di ferro e asse da stiro. | Yes/No/Unknown |
| kitchen | Recommended | Indica se la proprietà è dotata di cucina. | Yes/No/Unknown |
| microwave | Recommended | Indica se la proprietà è dotata di forno a microonde. | Yes/No/Unknown |
| min_days_advance_purchase | Recommended | Numero minimo di giorni di anticipo con cui è possibile prenotare la proprietà. | Non-negative integer value |
| min_night_stay | Recommended | Numero minimo di notti per cui un ospite può prenotare la proprietà. | Positive integer (more than zero) |
| max_night_stay | Recommended | Numero massimo di notti per cui un ospite può prenotare la proprietà. | Positive integer (more than zero) |
| outdoor_grill | Recommended | Indica se la proprietà ha una griglia per barbecue. | Yes/No/Unknown |
| oven_stove | Recommended | Indica se la proprietà è dotata di piano cottura. | Yes/No/Unknown |
| parking_type | Recommended | Tipo di parcheggio disponibile nella proprietà. | Free/Paid/None |
| patio | Recommended | Indica se la proprietà è dotata di un patio. | Yes/No/Unknown |
| pets_allowed | Recommended | Alcune o tutte le camere consentono agli ospiti di portare con sé animali domestici (cani o gatti che non sono animali di servizio). | Yes/No/Unknown |
| pool_type | Recommended | Tipo di piscina (accesso alla piscina) di cui è dotata la proprietà. | Indoors, Outdoors, Indoors/Outdoors, None |
| room_type | Recommended | Il tipo di camera. ENTIRE_PLACE è l'unico valore supportato. |
ENTIRE_PLACE
|
| smoking_free_property | Recommended | Indica se la struttura è per non fumatori o se non è consentito fumare. | Yes/No/Unknown |
| special_service_level | Recommended | Indica se il livello del servizio della scheda è speciale in qualche modo.
Ad esempio, verified, luxury,
premium |
Yes/No/Unknown |
| square_footage | Recommended | La superficie della proprietà in piedi quadrati. | Non-negative float value |
| square_meters | Recommended | La superficie della proprietà in metri quadrati. | Non-negative float |
| tv | Recommended | Indica se la proprietà è dotata di TV. | Yes/No/Unknown |
| washer_dryer | Recommended | Indica se la proprietà è dotata di lavatrice/asciugatrice. | Yes/No/Unknown |
| wheelchair_accessible | Recommended | Indica se la proprietà è accessibile in sedia a rotelle. | Yes/No/Unknown |
| internet_type | Recommended | Tipo di accesso a internet Wi-Fi fornito dalla struttura. | Free/Paid/None |
| airport_shuttle | Optional | Indica se l'host offre un servizio di trasporto da o per l'aeroporto o altri capolinea. | Yes/No/Unknown |
| balcony | Optional | Indica se la proprietà ha un balcone. | Yes/No/Unknown |
| fire_place | Optional | Indica se la proprietà include un camino. | Yes/No/Unknown |
| free_breakfast | Optional | Indica se la colazione è inclusa nel prezzo. | Yes/No/Unknown |
| host_description | Optional | Descrizione dell'host della casa vacanze. | Free text |
| host_language | Optional | Lingue parlate dall'host. | Un elenco separato da virgole di
codici lingua; ad esempio: de, en |
| host_name | Optional | Nome dell'host della casa vacanze. | Free text |
| host_response_rate | Optional | Tasso di risposta medio dell'host. | Non-negative float value, for example, 1, 0.75, 0.5 |
| host_response_time | Optional | Tempo di risposta medio dell'host. | Free text |
| license_num | Optional | Numero di licenza (turistica o aziendale) la cui indicazione è obbligatoria per le proprietà in alcune aree geografiche. Può essere ripetuto e, se esistono più licenza, suggeriamo di aggiungere l'autorità che ha emesso la licenza come contesto; ad esempio: "Parigi: 123456ABC". | Free text |
| number_of_half_bathrooms | Optional | Numero di bagni di servizio. | Non-negative integer value |
| number_of_living_rooms | Optional | Numero di salotti. | Non-negative integer value |
| private_beach_access | Optional | Indica se la proprietà ha accesso dedicato a una spiaggia non pubblica. | Yes/No/Unknown |
| refund_policy | Optional | Norme sui rimborsi per la struttura. | Free text |
Elementi secondari XML
Sono obbligatori i seguenti elementi secondari XML:
| Elemento secondario | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
| <country> | Strongly recommended | string | Il paese in cui si trova la scheda. Il valore deve essere un
codice paese ISO 3116
di due lettere. Ad esempio, gli Stati Uniti sono US
e il Canada è CA:
<country>US</country> |
| <id> | Required | string | L'identificatore univoco della struttura. Tieni presente che ogni casa vacanze deve avere un ID univoco per il tuo sito e che questo ID non deve mai essere riutilizzato. |
| <latitude> | Required | float | La latitudine corrispondente alla posizione dell'hotel. Ad esempio:
<latitude>37.423738</latitude> Questo valore può essere generato con strumenti di geocodifica come l'API di Google Maps. |
| <longitude> | Required | float | La longitudine corrispondente alla posizione dell'hotel. Ad esempio:
<longitude>-122.090101</longitude> Questo valore può essere generato con strumenti di geocodifica come l'API di Google Maps. |
| <name> | Required | string | Il nome della proprietà. Massimo 300 caratteri. |
| <address> | Required | string or Object | La posizione fisica completa della proprietà sotto forma di stringa. L'indirizzo deve includere il nome e il numero civico della via. In caso contrario, l'indirizzo deve includere un Plus Code. Se applicabile, devono essere inclusi anche i numeri degli appartamenti o delle unità. In alternativa, puoi fornire un indirizzo "composto". Utilizza gli elementi secondari
Caselle postali e altri indirizzi solo postali non sono considerati indirizzi fisici completi. Ecco alcuni esempi di indirizzo 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> Di seguito sono riportati alcuni esempi di indirizzo completo che utilizzano un 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> Evita quanto segue:
|
Esempio di scheda di case vacanze
<?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>