Dokumentacja XML listy hoteli

Lista hoteli to co najmniej jeden plik XML zawierający listę wszystkich hoteli, podać ceny. Sam plik z listą hoteli nie zawiera cen i informacjami o nich.

Głównym elementem listy hoteli jest element <listings>, który zawiera Elementy <listing> opisujące Twoje właściwości.

Listę hoteli tworzysz w ramach początkowej implementacji, a potem w ramach regularnych prac konserwacyjnych dodawać lub usuwać hotele.

Upewnij się, że pliki są zgodne ze wskazówkami dotyczącymi składni. Na przykład użyj kodowania UTF-8 i określ ten schemat kodowania, dodając do niego tag encoding w tagu XML.

Po utworzeniu listy hoteli możesz ręcznie przesłać ją do Google za pomocą funkcji Hotele Center lub przeprowadź hosting na swoim

Znajdowanie i rozwiązywanie problemów z danymi

Aby znaleźć i rozwiązać problemy z danymi na liście hoteli, zapoznaj się z tymi artykułami:

Wymagania dotyczące informacji o produkcie

Aby kwalifikować się do korzystania z Reklam hoteli w Google, miejsce zakwaterowania na Twojej liście hoteli musi mieć:

  • pokoje, w których goście mogą zatrzymać się za opłatą;
  • stałą, fizyczną lokalizację, która jest dostępna dla wszystkich;
  • Naprawione ściany i hydraulika
  • minimalny okres pobytu, który nie przekracza 7 dni.

Typowe przykłady obiektów niekwalifikujących się to rejsy czy mieszkania, ponieważ zwykle nie spełniają kryteriów Listing requirements.

Domki kempingowe i inne pola kempingowe ze stałymi ścianami, instalacjami hydraulicznymi i klimatyzatora (w tym piec na drewno i grzejniki na propan). Noclegi na świeżym powietrzu, które nie kwalifikują się do tej oferty, to:

  • Kempingi, w przypadku których goście zatrzymują się w namiotach
  • Parkingi dla kamperów, do których goście przyjeżdżają własnym kamperem

<listings>

<listings> jest głównym elementem listy hoteli i zawiera element <language> i co najmniej 1 element <listing>.

Element <listings> pojawia się w tym miejscu na liście hoteli Hierarchia XML:

+ <listings>
    + <language>
    + <datum>
    + <listing>

Składnia

Element <listings> ma taką składnię:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language> language_code</language>
  <datum> datum_code </datum>
  <listing> listing</listing>
  ...
</listings>

Atrybuty

Element <listings> ma te atrybuty:

Atrybut Wymagana? Opis
xmlns:xsi Wymagane Ustaw jako: http://www.w3.org/2001/XMLSchema-instance.
xsi:noNamespaceSchemaLocation Wymagane Ustaw jako: http://www.gstatic.com/localfeed/local_feed.xsd.

Elementy potomne

Element <listings> ma te elementy podrzędne:

Element podrzędny Wymagana? Typ Opis
<language> Required string Język, w którym napisany jest plik danych. Ustaw wartość tej element na dwuliterowy kod języka. na przykład en w przypadku języka angielskiego.
<datum> Optional enum Ten element określa odniesienie geodetyczne lub model referencyjny dla szerokości i długości geograficznej podanych w pliku danych. Jeśli brak wartości punktu odniesienia jest podana, domyślna wartość tego elementu to WGS84, która jest stosowany przez większość współczesnych urządzeń GPS. Punkt odniesienia Tokio ma zastosowanie tylko do w Japonii.

Prawidłowe wartości tego elementu to:

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
. Uwaga: aby użyć domyślnej wartości WGS84, nie uwzględniaj element <datum> na liście hoteli.
<listing> Required <listing> Co najmniej 1 wpis opisujący każdy hotel w pliku danych. Pamiętaj, że każdy hotel na liście musi mieć unikalny identyfikator dla Twojej witryny. że identyfikatora nie wolno używać ponownie.

Przykłady

Uporządkowany adres

Przykład poniżej pokazuje częściową listę hoteli ze strukturą adres:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <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>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Adres w dowolnej formie

Ten przykład to częściowa lista hoteli w formacie dowolnym adres:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Treść opcjonalna

Poniższy przykład pokazuje częściową listę hoteli z wizytówką, która zawiera opcjonalny element <content>:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<listing>

Definicja hotelu w elemencie listy hoteli <listings>.

Element <listing> pojawia się w tym miejscu na liście hoteli Hierarchia XML pliku danych:

+ <listings>
    + <language>
    + <listing>

Składnia

Element <listing> ma taką składnię:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <!-- Specify <listing>'s child elements in the order shown below. -->
    <id>hotel_ID</id>
    <name>hotel_name</name>
    <address>
      <component name="addr1">street_address_1</component>
      <component name="addr2">street_address_2</component>
      <component name="city">city_name</component>
      <component name="province">province_name</component>
      <component name="postal_code">postal_code</component>
    </address>
    <!-- You can also define an address freeform, although this is not recommended: -->
    <!-- <address>freeform_address</address> -->

    <country>country_code</country>
    <latitude>hotel_latitude</latitude>
    <longitude>hotel_longitude</longitude>
    <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>content</content>
  </listing>
</listings>

Atrybuty

Element <listing> nie ma atrybutów.

Elementy potomne

Element <listing> ma te elementy podrzędne:

Element podrzędny Wymagana? Typ Opis
<id> Required string Unikalny identyfikator hotelu.

Uwaga: ta wartość musi być niepowtarzalna przez cały czas w Twojej witrynie. Tak nie wykorzystuj ponownie identyfikatorów, ponieważ może to powodować problemy rozwiązywać problemy z dopasowaniem usług.
<name> Required string Nazwa hotelu, Na przykład: 
<name>Belgrave House</name>
<address> Required Object or string

Pełna lokalizacja fizyczna hotelu.

Ten element przyjmuje tylko jeden atrybut, format, którego musi mieć wartość simple.

Musisz podać przynajmniej ulicę i numer, miasto, województwo lub region i kod pocztowy hotelu. Użyj konta podrzędnego <component> aby opisać poszczególne części adresu:

  • addr1: główny adres hotelu.
  • addr2: w razie potrzeby dodatkowy adres.
  • addr3: trzecia część adresu, jeśli niezbędną.
  • city: nazwa miasta hotelu.
  • province: nazwa stanu, regionu lub nazwy hotelu. prowincja.
  • postal_code: kod pocztowy hotelu.

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ć nazwę w formacie dowolnym, chociaż jest to niezalecane. Na przykład:

<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>

Pamiętaj, że P.O. ani skrytek pocztowych, ani innych adresów są uznawane za pełne adresy fizyczne.
<country> Required string Kraj, w którym znajduje się ta wizytówka. Wartość musi być dwuliterowy kod kraju. np. Polska to „PL”, a Niemcy to „DE”. Na przykład: 
<country>US</country>
<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.
<location_precision> Optional integer Dokładność lokalizacji nieruchomości wysyłana w metrach, gdy szerokość i długość geograficzna obiektu mają zaciemniony. Zero (0) oznacza, że nie ma zaciemnienia kodu i że widoczna jest dokładna lokalizacja. Uwaga: ten element dotyczy tylko kwater wakacyjnych.
<phone> Required* string

Co najmniej jeden numer kontaktowy hotelu. Jeśli wizytówka jest firmowa oddział, podaj numer telefonu do konkretnego oddziału (nie jest to numer telefonu centrali).

Atrybut type może mieć jedną z tych wartości:

  • fax: numer telefonu faksu.
  • main: główny numer telefonu głosowego.
  • mobile: numer telefonu komórkowego.
  • tdd: urządzenie telekomunikacyjne dla osób niesłyszących (TDD) Numer telefonu.
  • tollfree: bezpłatny numer telefonu.

Na przykład:

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

Wymagane minimum to typ main.
<category> Optional string Typ obiektu, np. hotel. Partnerzy mogą korzystać z dowolnych wewnętrznych kategorii, jakie muszą opisać nieruchomości, takich jak „hotele biznesowe”, „ośrodki wypoczynkowe”, „motele”, i podobne.
<content> Optional <content> Opcjonalne informacje związane z wizytówką, takie jak opis, oceny i cechami nieruchomości.

* Wymagany jest numer telefonu lub szerokość/długość geograficzna. Śr zalecamy zdefiniowanie obu.

Przykłady

Uporządkowany adres

Przykład poniżej pokazuje częściową listę hoteli ze strukturą adres:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <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>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Adres w dowolnej formie

Ten przykład to częściowa lista hoteli w formacie dowolnym adres:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Treść opcjonalna

Poniższy przykład pokazuje częściową listę hoteli z wizytówką, która zawiera opcjonalny element <content>:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<content>

Dodaje informacje o firmie, takie jak oceny, opinie, udogodnienia czy inne szczegóły. Element <content> jest opcjonalny. W ciągu <content>: Wszystkie elementy podrzędne są opcjonalne.

Element <content> pojawia się w tym miejscu na liście hoteli Hierarchia XML pliku danych:

+ <listings>
    + <language>
    + <listing>
        + <content>

Składnia

Element <content> ma taką składnię:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      <!-- Specify <text>'s child elements in the order shown below. -->
      <text type="description">
        <link>listing_link</link>
        <title>listing_title</title>
        <author>listing_author</author>
        <body>listing_description</body>
        <date month="MM" day="DD" year="YYYY"/>
      </text>
      <!-- 0 or more reviews: -->
      <review type="[editorial|user]">
        ...
      </review>
      <!-- 0 or more attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="custom_0">custom_attribute_0</client_attr>
        <client_attr name="custom_1">custom_attribute_1</client_attr>
        <client_attr name="custom_2">custom_attribute_2</client_attr>
        <client_attr name="custom_3">custom_attribute_3</client_attr>
        <client_attr name="custom_4">custom_attribute_4</client_attr>
        <client_attr name="hotel_brand">hotel_brand</client_attr>
        <client_attr name="num_reviews">number_of_reviews</client_attr>
        <client_attr name="rating">aggregate_rating</client_attr>
      </attributes>
      <!-- a picture of the hotel or property-->
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main Hotel Picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

Atrybuty

Element <content> nie ma atrybutów.

Elementy potomne

Element <content> ma te elementy podrzędne:

Element podrzędny Wymagana? Typ Opis
<text type="description"> Optional Object

Strona internetowa powiązana z wizytówką dostawcy. Ma następujące elementy podrzędne:

  • <link>: link do opisu. Dołącz „http://” lub
    "https://" (opcjonalnie).
  • <title>: tytuł opisu. (opcjonalne).
  • <author>: autor opisu (opcjonalne).
  • <body>: treść tekstu reklamy (wymagane).
  • <date>: data opisu (opcjonalnie).

    • Uwaga: te elementy muszą pojawić się w powyższej kolejności.
<review type="[editorial|user]"> Optional <review>

Zawiera opinię użytkownika lub opinię redakcyjną wizytówki. Twoje może zawierać dowolną liczbę opinii każdego typu.

Nie musisz uwzględniać wszystkich opinii o miejscu zakwaterowania w <listing>; ten element jest przeznaczony do uwzględnienia wybranych opinii, które ilustrują funkcje danego wpisu lub jakości.
<attributes> Optional Object

Zawiera co najmniej 0 elementów podrzędnych <client_attr>, które podać szczegóły dotyczące nieruchomości. Elementy podrzędne używają tego składnia:

<client_attr name="attribute_name">attribute_value<client_attr>

Listę i opis elementów podrzędnych znajdziesz tutaj: <attributes>

Wszystkie elementy <client_attr> są opcjonalne.

Jeśli istnieje element podrzędny <website>, musi on zawierać: znajduje się przed dowolnym elementem <client_attr>.
<image> Optional Object Powtórzony tag zawiera szczegółowe informacje o obrazie.

Przykład

Poniżej znajduje się przykład częściowej listy hoteli, która zawiera Element <content>:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<review>

zawiera opinię użytkownika lub opinię redakcyjną. Nie musisz uwzględniać wszystkich opinie o wizytówce w elemencie <listing>; jest przeznaczony dla tego elementu uwzględnij wybrane recenzje, które wskazują na cechy danego wpisu. czy jakości.

Element <review> pojawia się w tym miejscu na liście hoteli Hierarchia XML pliku danych:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

Składnia

Element <review> ma taką składnię:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

Atrybuty

Element <review> ma te atrybuty:

Atrybut Wymagana? Opis
type Required Typ opinii. Ustaw jedną z tych wartości:
  • editorial: opinia z witryny lub innej opinii organu władzy.
  • user: opinia użytkownika.

Elementy potomne

Element <review> ma te elementy podrzędne:

Element podrzędny Wymagana? Typ Opis
<link> Optional string Link do opinii. Dodaj przedrostek „http://” lub „https://” tego procesu .
<title> Optional string (Tylko opinie redakcyjne) Tytuł opinii.
<author> Optional string autor opinii; na przykład „Zuzanna von Trapp”. To może też być nazwa witryny lub publikacji, w której pojawia się opinia, jeśli Użytkownik nie ma kredytu.
<rating> Optional string Liczba zmiennoprzecinkowa od 0 do 10 (włącznie) reprezentująca ocenę. np. „8.9”.
<body> Optional string Tekst opinii. Ten element nie powinien zawierać kodu HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Dotyczy tylko opinii użytkowników) Data opinii podana przez Ciebie w atrybucie następujące atrybuty tego elementu:
  • day: dzień miesiąca; np. „7”.
  • month: miesiąc, w którym 1 = styczeń ... 12 = grudzień.
  • year: czterocyfrowy rok; np. „2023”.

Na przykład 7 czerwca 2023 r. wygląda tak:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Dotyczy tylko opinii użytkowników) Data wizyty autora opinii w opinii. Format jest taki sam jak w polu <data>. powyżej.

Na przykład 7 czerwca 2023 r. wygląda tak:

<servicedate month="6" day="7" year="2023"/>

Opinie bez miesiąca i roku <servicedate> może nie być wyświetlana. Dzień nie jest wymagany.

Pamiętaj, że <title> jest prawidłowym elementem podrzędnym elementu <review> tylko wtedy, gdy atrybut type opinii ma wartość editorial, a <date> jest prawidłowy tylko wtedy, gdy type ma wartość user.

Przykład

Poniższy przykład pokazuje częściową listę hoteli z wizytówką, która zawiera komentarz redakcyjny i opinię użytkownika:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<attributes>

Tagu <attributes> można używać do opisywania udogodnień w obiekcie oraz do klasyfikowanie ocen i opinii o miejscu zakwaterowania.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>

Elementy potomne

Element podrzędny Wymagana? Opis
<website> Optional Główna witryna hotelu. Jeśli istnieje, musi znajdować się w odpowiednim położeniu przed pierwszym elementem <client_attr>. Przykład: 
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional Dodatkowa cecha lub „atrybut” usługi, która można określić za pomocą obsługiwanej funkcji attribute_name lub attribute_name w przypadku kwater wakacyjnych.

Wartości parametru placeholder_name

W tabeli poniżej znajdziesz prawidłowe wartości dla parametru attribute_name w <client_attr name="attribute_name"> .

Wartości dla: attribute_name Opis Prawidłowe wartości treści
alternate_hotel_id Alternatywny identyfikator miejsca zakwaterowania. Posiadanie oddzielnych identyfikatorów jest przydatne , jeśli potrzebujesz jednego identyfikatora usługi na potrzeby informacji w pliku danych oraz inny identyfikator usługi rezerwacji. Dowolna wartość ciągu znaków
custom_[0-4] Dowolny atrybut niestandardowy typu ciągu znaków. Nie są one widoczne dla użytkowników. Dowolna wartość ciągu znaków
hotel_brand Marka, do której należy ten hotel, Na przykład „Marriott” lub „Hilton”. Te informacje nie są widoczne dla użytkowników, ale mogą służyć do grupowania hoteli. Dowolna wartość ciągu znaków
lodging Zakodowana reprezentacja wszystkich pól dostępnych w Lodging Proto. Ciąg znaków funkcji zakodowany algorytmem Base64 zakodowane Lodging proto
num_reviews Liczba opinii o firmie. Dowolna nieujemna liczba całkowita.
rating Liczba zmiennoprzecinkowa reprezentująca zbiorczą ocenę właściwości. Zwykle mieści się w zakresie 0-5, 0-10 lub 0-100, ale możesz użyć dowolnego zakresu reprezentującego Twój system ocen.

Wartości zmiennejattribute_name (nazwa atrybutu kwatery wakacyjne)

Zapoznaj się z atrybutami dotyczącymi kwater wakacyjnych i przykładowym plikiem XML.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>
            + <image>

Obrazy służą do pokazania miejsca zakwaterowania w identyfikatorze oferty. Wszystkie wykorzystane obrazy muszą postępuj zgodnie z tymi wytycznymi:

  • Zalecany współczynnik proporcji obrazów to 4:3.
  • Adres URL obrazu musi być dostępny dla robota Googlebot Image_1.

  • Jeśli witryna zawiera plik robots.txt na poziomie głównym, sprawdź, czy zawiera możesz wybrać jedną z 2 poniższych opcji:

    1. Umożliwia robotowi Googlebot indeksowanie treści w Twojej witrynie, w tym obrazów.

      • User-agent: Googlebot
      • Allow: /

    2. Zezwala robotowi indeksującemu obrazy Googlebot na indeksowanie obrazów w Twojej witrynie.

      • User-agent: Googlebot-Image
      • Allow: /

  • Niedozwolone są zrzuty ekranu z obrazami lub stronami internetowymi. Obrazy muszą być oryginalne i rzeczywiste obrazy lub fotografie.

.

Atrybuty

  • "ad", jeśli obraz jest reklamą
  • "menu", jeśli obraz przedstawia menu restauracji
  • "photo", jeśli obraz jest zdjęciem firmy
Nazwa atrybutu Wymagana? Format Opis
type Required Text

Dozwolone są następujące obrazy:
url Required Text Adres URL obrazu w pełnym rozmiarze. Użyj atrybutu url, aby określić który ma być używany na tej stronie.
width Required A non-negative integer Szerokość obrazu w pikselach (powyżej 720 pikseli zalecane)
height Required A non-negative integer Wysokość obrazu w pikselach (powyżej 720 zalecane)

Elementy potomne

Element podrzędny Wymagana? Opis
<link> Wymagana, ale wymagana w przypadku lokalnych wizytówek zdjęć. Ten tag zawiera prawidłowy i aktualny URL strony w Twojej witrynie czy odpowiednie zdjęcie jest włączone. Nie zawiera adresu URL samego obrazu. Przykład:
<link><http://www.example.com/magic_pizza/></link>
<title> Wysłano prośbę Ten tag zawiera tytuł obrazu. Przykład: 
<title>"Luxury Apartment"</title>
<author> Niewymagane Imię i nazwisko autora treści. Wartość może być albo być nazwą użytkownika lub imieniem i nazwiskiem w formacie „Imię Nazwisko”.
<date> Wymagane

Ten tag określa datę utworzenia elementu treści. Ty należy wpisać rok, miesiąc i dzień, jak w tym przykładzie:

<date month="6" day="7" year="2023"/>

Przykład

Poniżej znajduje się przykład częściowej listy hoteli z tagami graficznymi:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <content>
      <review>
      </review>
      <attributes>
      </attributes>
      <image type="photo" url="https://image_url" width="400" height="300">
        <link>https://image_url</link>
        <title>Apartment at Sandstone</title>
        <author>Jessica Landlord</author>
        <date month="6" day="7" year="2023"/>
      </image>
    </content>
  </listing>
  ...
</listings>

Wytyczne dotyczące składni

Tworząc listę hoteli w formacie XML, przestrzegaj tych wytycznych:

  • Zweryfikuj pliki XML z listą hoteli za pomocą schematu XSD Google.

  • Użyj kodowania UTF-8. Określ ten schemat kodowania, dodając tag encoding w tagu XML, jak pokazano w poniższych przykładach.

  • W pliku danych możesz określić wartości danych za pomocą sekcji CDATA. Jeśli używasz CDATA – nie zmieniaj znaczenia znaków specjalnych.

  • Używaj kodów zmiany znaczenia w przypadku wartości danych, które nie znajdują się w sekcjach CDATA, w tym: Adresy URL. Do reprezentowania możesz użyć kodu jednostki lub kodu znaku te znaki specjalne. W poniższej tabeli znajdziesz typowe kody elementów i znaków, których możesz użyć:

    Znak Jednostka Kod znaku
    Znak & (&) &amp; &#38;
    Pojedynczy cudzysłów (') &apos; &#39;
    Podwójny cudzysłów (") &quot; &#34;
    Większe niż (>) &gt; \62
    Mniejsze niż (<) &lt; \60

  • Pomiń elementy XML, które nie zawierają danych. Jeśli na przykład nie masz szerokości i długości geograficznej hotelu, nie wpisuj długości. Elementy <latitude/> i <longitude/>.

  • Pod żadnym pozorem nie używaj języka HTML w elementach XML (nawet ).

  • Aby sprawdzić kanał przed jego przesłaniem, możesz użyć lokalnego pliku XSD http://www.gstatic.com/localfeed/local_feed.xsd.

  • Aby używać komentarzy w źródle treści, umieść komentarz w tagach <!-- i -->. co widać w następnym przykładzie:

    <!-- This is a comment -->

  • Pamiętaj, aby zamknąć element <date> w interfejsie użytkownika <review> Na przykład:

    <date day="2" month="12" year="2017"/>