Atrybuty

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

Ogólna struktura XML ma podobny format jak pliki danych z informacjami o hotelach. Zobacz Dokumentacja XML listy hoteli

Jeśli nie uwzględnisz tych wymaganych elementów, wpis:

  • Wymagane elementy podrzędne XML: id, name, latitude, longitude oraz address.
  • Atrybuty wymagane: capacity i website. Skorzystaj z linków bezpośrednich do kwater wakacyjnych. w pliku danych z informacjami o produktach. Dzięki temu użytkownicy będą mogli odwiedzić obiekt witryny.

Szczegółowe informacje o wymaganych elementach podrzędnych XML znajdziesz w sekcji elementy podrzędne XML XML. .

Więcej informacji o kwaterach wakacyjnych znajdziesz tutaj: Atrybuty unikalne dla kwater wakacyjnych.

Gdy Google ustala z innych źródeł, że wartość attribute różni się od co jest określone w pliku danych o kwaterach wakacyjnych, Google wyświetla dla listy. Jeśli na przykład Google ustali, na podstawie zdjęć w wizytówce że jest w nim kuchnia, ale atrybut kitchen jest niedostępny lub ma wartość No, Google traktuje tę ofertę jak kuchnię. Atrybuty te nazywane są „wywnioskowane atrybuty”. Są one wyświetlane tylko wtedy, gdy istnieje wysoki poziom ufności. dokładności wnioskowania.

Wartości parametru placeholder_name

W tabeli poniżej znajdziesz listę prawidłowych wartości dla attribute_name w element <client_attr name="attribute_name">; jest to jednak zalecamy podanie dodatkowych attribute_name, jeśli są dostępne.

Wartości dla: attribute_name Wymagana? Opis Prawidłowe wartości treści
capacity Required Maksymalna liczba gości, jaką może pomieścić hotel. Ta wartość powinna być równa lub większa od „liczba_sypialni”. Non-negative integer value
website Required Adres URL witryny danej usługi. Free text
partner_hygiene_link Strongly recommended Link do zewnętrznej witryny partnera, na której można znaleźć więcej informacji Szczegóły dotyczące higieny wizytówki. 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 Określa, czy w hotelu można się zameldować i wymeldować samodzielnie. Yes/No/Unknown
rating Strongly recommended Liczba zmiennoprzecinkowa reprezentująca zbiorczą ocenę właściwości. Ten zwykle mieści się w zakresie 0-5, 0-10 lub 0-100, ale możesz użyć dowolnego zakresu który reprezentuje Twój system ocen. Non-negative float value
rating_num Strongly recommended Liczba ocen wystawionych obiektowi. Non-negative integer value
rating_scale Strongly recommended Maksymalna możliwa ocena obiektu Non-negative integer value
instant_bookable Strongly recommended Określa, czy w danym miejscu można natychmiast zarezerwować obiekt w momencie wymeldowania. Alternatywą jest oczekiwanie na zatwierdzenie. Yes/No/Unknown
description Strongly recommended Swobodny tekst opisujący wyjątkowe cechy nieruchomości Free text
category Strongly recommended rodzaj nieruchomości, np. willa, bungalow, domek lub apartament; Free text
ac Recommended Czy obiekt jest klimatyzowany. Yes/No/Unknown
beach_access Recommended Informacja, czy obiekt ma dostęp do publicznej plaży w pobliżu usłudze. Yes/No/Unknown
check_in_time Recommended Dokładna godzina zameldowania w hotelu. GGMM, GG:MM lub GG:MM:SS akceptowany format; na przykład wpisz 14:00 zamiast 14:00 lub 14:00. Wszystkie inne formaty nie są analizowane ani wyświetlane. Time
check_out_time Recommended Dokładna godzina wymeldowania z hotelu. GGMM, GG:MM lub GG:MM:SS akceptowany format; na przykład wpisz 11:00 zamiast 11:00 lub 11:00. Wszystkie inne formaty nie są 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 czy na terenie obiektu znajduje się siłownia lub sprzęt do fitnessu. 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
min_days_advance_purchase Recommended Minimalna liczba dni wcześniej, na którą można zarezerwować obiekt. Non-negative integer value
min_night_stay Recommended Minimalna liczba nocy, przez które gość może zarezerwować pokój. Positive integer (more than zero)
max_night_stay Recommended Maksymalna liczba nocy, na jaką gość może zarezerwować pokój. Positive integer (more than zero)
outdoor_grill Recommended Czy obiekt ma grilla. Yes/No/Unknown
oven_stove Recommended Informacja, czy w obiekcie jest piec. Yes/No/Unknown
parking_type Recommended Typ dostępnego parkingu na terenie obiektu. Free/Paid/None
patio Recommended Czy obiekt ma patio. Yes/No/Unknown
pets_allowed Recommended Do niektórych lub wszystkich pokoi można przyjechać ze zwierzętami (psami lub kotami), to nie są zwierzęta domowe. Yes/No/Unknown
pool_type Recommended Typ puli (dostęp do basenu) w miejscu zakwaterowania. Indoors, Outdoors, Indoors/Outdoors, None
smoking_free_property Recommended Informacja, czy w obiekcie obowiązuje zakaz palenia. Yes/No/Unknown
special_service_level Recommended Czy poziom usług w informacjach o firmie jest w jakiś sposób specjalny. Na przykład: 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 hotel. Free/Paid/None
airport_shuttle Optional czy gospodarz zapewnia transport na lotnisko i z lotniska lub inne za pomocą złączy. 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 Informacja, czy w hotelu serwowane jest wliczone w cenę śniadanie. Yes/No/Unknown
host_description Optional Opis firmy oferującej kwaterę wakacyjną. Free text
host_language Optional Języki, którymi posługuje się gospodarz spotkania Rozdzielona przecinkami lista wartości language, na przykład: de, en
host_name Optional Nazwa firmy oferującej kwaterę wakacyjną. 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 (turystyki lub firmy) wymagany w przypadku miejsc zakwaterowania w niektórych regionach świata. Może się powtarzać, a jeśli jest kilka licencje, zalecamy dodanie uprawnień w ramach licencji jako kontekstu; na przykład „Paryż: 123456ABC”. Free text
number_of_half_bathrooms Optional Liczba łazienek połowa. 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 przypadku obiektu. Free text

Elementy podrzędne XML

Wymagane są następujące elementy podrzędne kodu XML:

Element podrzędny Wymagana? Typ Opis
<country> Strongly recommended string Kraj, w którym znajduje się ta wizytówka. Wartość musi być ISO 3116 dwuliterowy kod kraju, na przykład Stany Zjednoczone to US a Kanada jest CA: 
    <country>US</country>
<id> Required string Unikalny identyfikator usługi. Pamiętaj, że każda kwatera wakacyjna musi mieć identyfikator, który jest unikalny dla Twojej witryny. Taki identyfikator nigdy nie powinien ponownie użyte.
<latitude> Required float Szerokość geograficzna odpowiadająca lokalizacji hotelu, Dla: przykład: 
    <latitude>37.423738</latitude>

Tę wartość można wygenerować przy użyciu narzędzi do geokodowania, takich jak Interfejs API Map Google.
<longitude> Required float Długość geograficzna odpowiadająca lokalizacji hotelu, Dla: przykład: 
    <longitude>-122.090101</longitude>

Tę wartość można wygenerować przy użyciu narzędzi do geokodowania, takich jak Interfejs API Map Google.
<name> Required string Nazwa usługi. Maksymalnie 300 znaków.
<address> Required string or Object

Pełna lokalizacja fizyczna usługi w postaci ciągu znaków. Adres musi zawierać nazwę ulicy i numer. Jeśli takiego nie ma, adres powinien zawierać kod plus. W razie potrzeby należy też podać numer mieszkania lub lokalu.

Możesz też podać parametr „kompozytowy”, adresu. Użyj konta podrzędnego <component> aby opisać poszczególne części adresu:

  • addr1: główny adres.
  • addr2: w razie potrzeby dodatkowy adres, w tym numer lokalu.
  • city: miasto.
  • province: w razie potrzeby stan, region lub prowincja.
  • postal_code: kod pocztowy.
  • country: kraj.

Pamiętaj, że P.O. ani skrytek pocztowych, ani innych adresów są uznawane za pełne adresy fizyczne.

Oto przykłady pełnego adresu:

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

Oto przykłady pełnego adresu z użyciem kodu plus:

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

Unikaj:

  • Zbędne informacje: nie podawaj zbędnych informacji ani nie powtarzaj komponentów adresu.
  • Brak adresu ulicy: adresy muszą zawierać ulicę i numer.

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="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>