Atrybuty

Na tej stronie znajdziesz opisy, wartości i wymagania dotyczące atrybutów i elementów podrzędnych. Te wartości mają zastosowanie tylko do obiektów kwater wakacyjnych.

Ogólna struktura XML ma format podobny do plików danych z informacjami o hotelach. Więcej informacji znajdziesz w dokumentacji XML listy hoteli.

Niedodanie tych wymaganych elementów powoduje automatyczne wyłączenie wizytówki.

• Wymagane elementy podrzędne XML: id, name, latitude, longitude, address.
• Atrybuty wymagane: capacity i website.
  • Skorzystaj z bezpośredniego linku do witryny do usługi w pliku danych z informacjami o produkcie. Dzięki temu użytkownicy będą mogli odwiedzić witrynę nieruchomości.

Szczegółowe informacje o wymaganych elementach podrzędnych XML znajdziesz w sekcji dotyczącej elementów podrzędnych XML.

Więcej informacji o kwaterach wakacyjnych znajdziesz w artykule Atrybuty unikalne dla kwater wakacyjnych.

Gdy na podstawie innych źródeł Google ustali, że wartość atrybutu różni się od podanej w pliku danych oferty kwater wakacyjnych, wyświetlimy wartość danego atrybutu. Jeśli na przykład na podstawie zdjęć w wizytówce stwierdzimy, że jest w niej kuchnia, ale brakuje atrybutu kitchen lub ma on wartość No, potraktujemy ją jako kuchnię. Takie atrybuty są nazywane „atrybutami wywnioskowanymi” i wyświetlają się tylko wtedy, gdy jesteśmy z dużym prawdopodobieństwem pewności co do dokładności wnioskowania.

Ważne: w przypadku kwater wakacyjnych udogodnienia są podawane za pomocą atrybutów w pliku danych z listą hoteli.

Wartości zmiennej atrybutu nazwa_atrybutu

W tabeli poniżej znajdziesz listę prawidłowych wartości parametru attribute_name w elemencie <client_attr name="attribute_name">. Zalecamy jednak podanie dodatkowych wartości attribute_name, jeśli są dostępne.

Wartości dla kolumny attribute_name	Wymagana?	Opis	Prawidłowe wartości treści
capacity	Required	Maksymalna liczba gości, jaką może pomieścić obiekt. Ta wartość powinna być równa lub większa niż „liczba_sypialni”.	Non-negative integer value
website	Required	Adres URL witryny powiązanej z usługą.	Free text
partner_hygiene_link	Strongly recommended	Link do zewnętrznej witryny partnera z dodatkowymi informacjami o zasadach dotyczących higieny w ofercie.	Free text (the site's URL)
number_of_bathrooms	Strongly recommended	Liczba łazienek.	Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms	Strongly recommended	Liczba sypialni.	Non-negative integer value
number_of_beds	Strongly recommended	Liczba łóżek we wszystkich pokojach.	Non-negative integer value
self_checkin_checkout	Recommended	Czy obiekt umożliwia samodzielne zameldowanie się i wymeldowanie.	Yes/No/Unknown
rating	Strongly recommended	Liczba zmiennoprzecinkowa reprezentująca zbiorczą ocenę właściwości. Ta liczba mieści się zwykle w przedziale 0–5, 0–10 lub 0–100, ale możesz użyć dowolnego zakresu, który odpowiada Twojemu systemowi ocen.	Non-negative float value
rating_num	Strongly recommended	Liczba ocen usługi.	Non-negative integer value
rating_scale	Strongly recommended	Maksymalna możliwa ocena miejsca zakwaterowania	Non-negative integer value
instant_bookable	Strongly recommended	Określa, czy obiekt można od razu zarezerwować w trakcie procesu płatności. Alternatywne rozwiązanie oczekuje na zatwierdzenie.	Yes/No/Unknown
description	Strongly recommended	Swobodny tekst opisujący unikalne cechy właściwości	Free text
category	Strongly recommended	typ obiektu, na przykład willa, bungalow, domek lub apartament;	Free text
ac	Recommended	Czy obiekt jest klimatyzowany.	Yes/No/Unknown
beach_access	Recommended	Określa, czy obiekt ma dostęp do publicznej plaży w pobliżu.	Yes/No/Unknown
check_in_time	Recommended	Dokładna godzina zameldowania w hotelu. Akceptowany jest format GG:MM, GG:MM lub GG:MM:SS. Użyj np. 14:00 zamiast 14:00 lub 14:00. Pozostałe formaty nie będą analizowane ani wyświetlane.	Time
check_out_time	Recommended	Dokładna godzina wymeldowania z hotelu. Akceptowany jest format GG:MM, GG:MM lub GG:MM:SS. Użyj np. 11:00 zamiast 11:00 lub 11:00. Pozostałe formaty nie będą analizowane ani wyświetlane.	Time
child_friendly	Recommended	Czy obiekt jest odpowiedni dla dzieci.	Yes/No/Unknown
crib	Recommended	Dostępność łóżeczka dziecięcego.	Yes/No/Unknown
elevator	Recommended	Czy w obiekcie znajduje się winda.	Yes/No/Unknown
gym_fitness_equipment	Recommended	Określa, czy w obiekcie znajduje się siłownia lub sprzęt fitness.	Yes/No/Unknown
heating	Recommended	Czy obiekt jest ogrzewany.	Yes/No/Unknown
hot_tub	Recommended	Czy obiekt ma jacuzzi.	Yes/No/Unknown
ironing_board	Recommended	Czy w obiekcie znajduje się deska do prasowania.	Yes/No/Unknown
kitchen	Recommended	Czy w obiekcie znajduje się kuchnia.	Yes/No/Unknown
microwave	Recommended	Czy w obiekcie znajduje się kuchenka mikrofalowa.	Yes/No/Unknown
minimum_days_advance_purchase	Recommended	Minimalna liczba dni przed zarezerwowaniem danego miejsca zakwaterowania.	Non-negative integer value
minimum_night_stay	Recommended	Minimalna liczba nocy, które gość może zarezerwować w obiekcie.	Positive integer (more than zero)
max_night_stay	Recommended	Maksymalna liczba nocy w hotelu, jaką gość może zarezerwować.	Positive integer (more than zero)
outdoor_grill	Recommended	Czy obiekt ma grilla.	Yes/No/Unknown
oven_stove	Recommended	Określa, czy w obiekcie znajduje się kuchenka.	Yes/No/Unknown
parking_type	Recommended	Rodzaj parkingu dostępny na terenie obiektu.	Free/Paid/None
patio	Recommended	Czy obiekt ma patio.	Yes/No/Unknown
pets_allowed	Recommended	W niektórych lub wszystkich pokojach goście mogą zabrać ze sobą zwierzęta domowe – psy lub koty, które nie są zwierzętami domowymi.	Yes/No/Unknown
pool_type	Recommended	Rodzaj basenu (dostęp do basenu) hotelowego.	Indoors, Outdoors, Indoors/Outdoors, None
smoking_free_property	Recommended	Określa, czy w obiekcie obowiązuje zakaz palenia.	Yes/No/Unknown
special_service_level	Recommended	Czy poziom usług we wpisie jest z jakiegoś powodu szczególny. Przykłady: verified, luxury, premium	Yes/No/Unknown
square_footage	Recommended	Powierzchnia nieruchomości w stopach kwadratowych.	Non-negative float value
square_meters	Recommended	Powierzchnia nieruchomości w metrach kwadratowych.	Non-negative float
tv	Recommended	Czy w obiekcie znajduje się telewizor.	Yes/No/Unknown
washer_dryer	Recommended	Czy w obiekcie znajdują się pralki.	Yes/No/Unknown
wheelchair_accessible	Recommended	Dostępność obiektu dla osób na wózkach inwalidzkich.	Yes/No/Unknown
internet_type	Recommended	Rodzaj dostępu do sieci Wi-Fi zapewnianej przez obiekt.	Free/Paid/None
airport_shuttle	Optional	Czy host zapewnia transport między lotniskiem a innymi terminalami.	Yes/No/Unknown
balcony	Optional	Czy obiekt ma balkon.	Yes/No/Unknown
fire_place	Optional	Czy w obiekcie znajduje się kominek.	Yes/No/Unknown
free_breakfast	Optional	Czy śniadanie jest wliczone w cenę.	Yes/No/Unknown
host_description	Optional	Opis gospodarza kwatery wakacyjnej.	Free text
host_language	Optional	Języki, którymi może posługiwać się gospodarz.	Rozdzielona przecinkami lista kodów języków, np. de, en.
host_name	Optional	Imię i nazwisko właściciela kwatery wakacyjnej.	Free text
host_response_rate	Optional	Średni współczynnik odpowiedzi hosta.	Non-negative float value, for example, 1, 0.75, 0.5
host_response_time	Optional	Średni czas odpowiedzi hosta.	Free text
license_num	Optional	Numer licencji (turystycznej lub biznesowej) wymagany w przypadku miejsc zakwaterowania w niektórych regionach świata. Można go powtarzać. Jeśli istnieje kilka licencji, zalecamy dodanie uprawnień jako kontekstu, na przykład „Paryż: 123456ABC”.	Free text
number_of_half_bathrooms	Optional	Liczba łazienek na pół.	Non-negative integer value
number_of_living_rooms	Optional	Liczba salonów.	Non-negative integer value
private_beach_access	Optional	Czy obiekt ma specjalny dostęp do niepublicznej plaży.	Yes/No/Unknown
refund_policy	Optional	Zasady zwrotów w usłudze.	Free text

Elementy podrzędne XML

Wymagane są te elementy podrzędne XML:

Element podrzędny	Wymagana?	Typ	Opis
<country>	Strongly recommended	string	Kraj, w którym znajduje się dana wizytówka. Wartością musi być 2-literowy kod kraju w standardzie ISO 3116, na przykład Stany Zjednoczone to US, a Kanada to CA: <country>US</country>
<id>	Required	string	Unikalny identyfikator usługi. Pamiętaj, że każda kwatera wakacyjna musi mieć unikalny identyfikator, który należy do Twojej witryny, i nie należy go nigdy używać ponownie.
<latitude>	Required	float	Szerokość geograficzna odpowiadająca lokalizacji hotelu, Na przykład: <latitude>37.423738</latitude> Tę wartość można wygenerować za pomocą narzędzi do geokodowania, takich jak interfejs API Map Google.
<longitude>	Required	float	Długość geograficzna odpowiadająca lokalizacji hotelu, Na przykład: <longitude>-122.090101</longitude> Tę wartość można wygenerować za pomocą narzędzi do geokodowania, takich jak interfejs API Map Google.
<name>	Required	string	Nazwa usługi. Maksymalnie 300 znaków.
<address>	Required	Object or string	Pełna, fizyczna lokalizacja nieruchomości. Ten element przyjmuje pojedynczy atrybut – format, który musisz ustawić na simple. Musisz podać co najmniej ulicę, numer domu, miasto, stan lub region oraz kod pocztowy nieruchomości. Do opisania tych części adresu użyj elementów podrzędnych <component>: addr1: główny adres nieruchomości. addr2: dodatkowy adres, w tym numer lokalu, jeśli jest to konieczne. addr3: trzecia część adresu pocztowego. city: nazwa miasta, w którym znajduje się obiekt. province: nazwa stanu, regionu lub prowincji. postal_code: kod pocztowy nieruchomości. Na przykład: <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> Możesz też podać adres w formacie dowolnym, choć nie jest to zalecane. Na przykład: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Pamiętaj, że skrytki pocztowe i inne adresy pocztowe nie są uznawane za pełne adresy pocztowe.

Przykład oferty kwater wakacyjnych

<?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>