Dokumentacja XML listy hoteli

Lista hoteli to co najmniej 1 plik XML zawierający listę wszystkich hoteli, dla których będziesz podawać informacje o cenach. Sam plik z listą hoteli nie zawiera informacji o cenach.

Elementem głównym listy hoteli jest element <listings>, który zawiera elementy <listing> opisujące Twoje obiekty.

Listę hoteli tworzysz w ramach początkowego wdrożenia, a potem dodajesz do niej hotele lub je z niej usuwasz w ramach regularnej konserwacji.

Upewnij się, że pliki są zgodne z wytycznymi dotyczącymi składni. Użyj na przykład kodowania UTF-8 i określ ten schemat kodowania, dodając atrybut encoding do tagu XML.

Po utworzeniu listy hoteli możesz przesłać ją ręcznie do Google na stronie https://support.google.com/hotelprices/ lub umieścić ją na swoim serwerze.

Wykrywanie 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 móc korzystać 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;
  • Stałe ściany i instalacje wodno-kanalizacyjne
  • minimalny okres pobytu, który nie przekracza 7 dni.

Wśród obiektów, które zazwyczaj nie spełniają kryteriów Listing requirements, są statki wycieczkowe i apartamenty.

Kwalifikują się domki kempingowe i inne obiekty kempingowe ze stałymi ścianami, instalacją wodno-kanalizacyjną i klimatyzacją (w tym piece na drewno lub grzejniki na propan). Niedozwolone obiekty noclegowe na świeżym powietrzu to:

  • pola namiotowe, na których goście nocują w namiotach;
  • parkingi dla kamperów, na których goście przyjeżdżają własnymi kamperami;

<listings>

<listings> to element główny listy hoteli, który zawiera element <language> i co najmniej jeden element <listing>.

Element <listings> występuje w hierarchii XML listy hoteli w tym miejscu:

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

Składnia

Element <listings> ma tę 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 Wymagany? 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 Wymagany? Typ Opis
<language> Required string Język, w którym zapisany jest plik danych. Ustaw wartość tego elementu na dwuliterowy kod języka. Na przykład en w przypadku języka angielskiego.
<datum> Optional enum Ten element określa datum geodezyjne lub model referencyjny dla współrzędnych geograficznych podanych w pliku danych. Jeśli nie podasz wartości daty, domyślna wartość tego elementu to WGS84, która jest używana przez większość nowoczesnych urządzeń GPS. Punkt odniesienia Tokio dotyczy tylko adresów w Japonii.

Prawidłowe wartości tego elementu to:

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
Uwaga: aby użyć wartości domyślnej WGS84, nie uwzględniaj elementu <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ć identyfikator, który jest unikalny w Twojej witrynie i nie może być ponownie użyty.

Przykłady

Adres strukturalny

Ten przykład przedstawia częściową listę hoteli z adresem w formacie strukturalnym:

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

Ten przykład przedstawia częściową listę hoteli z adresem w dowolnym formacie:

<?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ści opcjonalne

Ten przykład przedstawia częściową listę hoteli z informacjami o miejscu zakwaterowania, które zawierają 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 <listings> listy hoteli.

Element <listing> występuje w tym miejscu w hierarchii pliku danych XML listy hoteli:

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

Składnia

Element <listing> ma tę 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 Wymagany? Typ Opis
<id> Required string Unikalny identyfikator hotelu.

Uwaga: ta wartość musi być unikalna dla Twojej witryny przez cały czas. Nie używaj ponownie identyfikatorów, ponieważ może to powodować problemy podczas rozwiązywania problemów z dopasowaniem miejsc zakwaterowania.
<name> Required string Nazwa hotelu, Na przykład: 
<name>Belgrave House</name>
<address> Required Object or string

Pełny adres fizycznej lokalizacji hotelu.

Ten element przyjmuje jeden atrybut, format, który musisz ustawić na simple.

Musisz podać co najmniej ulicę, miasto, stan lub region oraz kod pocztowy hotelu. Użyj elementów podrzędnych <component>, aby opisać poszczególne części adresu:

  • addr1: główny adres hotelu.
  • addr2: dodatkowy adres ulicy (w razie potrzeby).
  • addr3: trzecia część adresu, jeśli jest potrzebna.
  • city: nazwa miasta, w którym znajduje się hotel.
  • province: nazwa stanu, regionu lub prowincji, w których znajduje się hotel.
  • 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ć adres w formie dowolnego tekstu, ale nie jest to zalecane. Na przykład:

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

Skrytki pocztowe ani inne adresy korespondencyjne nie są uznawane za pełne adresy hoteli.
<country> Required string Kraj, w którym znajduje się ta wizytówka. Wartością 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, 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.
<location_precision> Optional integer Dokładność lokalizacji obiektu wysyłana w metrach, gdy szerokość i długość geograficzna obiektu są zamaskowane. Wartość 0 oznacza, że lokalizacja nie jest zamazana i jest dokładna. Uwaga: ten element dotyczy tylko kwater wakacyjnych.
<phone> Required* string

Co najmniej jeden numer kontaktowy hotelu. Jeśli wizytówka dotyczy oddziału firmy, podaj numer telefonu konkretnego oddziału (a nie numer telefonu centrali).

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

  • fax: numer faksu.
  • main: główny numer telefonu głosowego.
  • mobile: numer telefonu komórkowego.
  • tdd: numer telefonu urządzenia telekomunikacyjnego dla osób niesłyszących (TDD).
  • 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>

Musisz podać co najmniej typ main.
<category> Optional string Rodzaj obiektu, np. hotel. Partnerzy mogą używać dowolnych kategorii wewnętrznych do opisywania swoich obiektów, np. „hotele biznesowe”, „ośrodki wypoczynkowe”, „motele” itp.
<content> Optional <content> Opcjonalne szczegóły używane w informacjach, takie jak opis, oceny i funkcje obiektu.

* Wymagany jest numer telefonu lub szerokość/długość geograficzna. Zalecamy zdefiniowanie obu tych wartości.

Przykłady

Adres strukturalny

Ten przykład przedstawia częściową listę hoteli z adresem w formacie strukturalnym:

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

Ten przykład przedstawia częściową listę hoteli z adresem w dowolnym formacie:

<?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ści opcjonalne

Ten przykład przedstawia częściową listę hoteli z informacjami o miejscu zakwaterowania, które zawierają 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 ogłoszeniu, takie jak oceny, udogodnienia i inne szczegóły. Element <content> jest opcjonalny. W elemencie <content> wszystkie elementy podrzędne są opcjonalne.

Element <content> występuje w tym miejscu w hierarchii pliku danych XML listy hoteli:

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

Składnia

Element <content> ma tę 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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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 Wymagany? Typ Opis
<text type="description"> Optional Object

Strona internetowa powiązana z informacjami od dostawcy. Ma następujące elementy podrzędne:

  • <link>: link do opisu; Ten element może zawierać „http://” lub
    „https://” (opcjonalnie).
  • <title>: Tytuł opisu (opcjonalnie).
  • <author>: autor opisu (opcjonalnie).
  • <body>: treść opisu (wymagany).
  • <date>: data opisu (opcjonalnie);

    • Uwaga: te elementy muszą występować w podanej wyżej kolejności.
<review type="[editorial|user]"> Optional <review>

Zawiera opinię użytkownika lub redakcyjną opinię o ofercie. W Twojej wizytówce może być dowolna liczba opinii dowolnego typu.

W elemencie <listing> nie musisz uwzględniać wszystkich opinii o obiekcie. Ten element służy do umieszczania wybranych opinii, które ilustrują funkcje lub jakość tego obiektu.

Ważne: element <review> powinien być wysyłany tylko w przypadku kont obiektów wakacyjnych. Aby uzyskać więcej informacji, skontaktuj się z menedżerem technicznym konta.
<attributes> Optional Object

Zawiera co najmniej 0 elementów podrzędnych <client_attr>, które zawierają szczegółowe informacje o usłudze. Elementy podrzędne mają następującą składnię:

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

Listę i opis elementów podrzędnych znajdziesz w sekcji <attributes>.

Wszystkie elementy <client_attr> są opcjonalne.

Jeśli występuje element podrzędny <website>, musi on znajdować się przed elementem <client_attr>.
<image> Optional Object Powtarzający się tag zawierający szczegółowe informacje o obrazie.

Przykład

Ten przykład przedstawia częściową listę 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>

Tag <attributes> może służyć do opisywania udogodnień w obiekcie i klasyfikowania ocen obiektu.

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

Elementy potomne

Element podrzędny Wymagany? Opis
<website> Optional Główna witryna hotelu. Jeśli występuje, musi znajdować się przed pierwszym elementem <client_attr>. Przykład: 
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional Dodatkowa cecha lub „atrybut” obiektu, którą można określić za pomocą obsługiwanych właściwości attribute_name lub attribute_name w przypadku kwater wakacyjnych.

Wartości zmiennej attribute_name

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

Wartości dla: attribute_name Opis Prawidłowe wartości treści
alternate_hotel_id Alternatywny identyfikator miejsca zakwaterowania. Oddzielne identyfikatory są przydatne, jeśli potrzebujesz jednego identyfikatora miejsca zakwaterowania do informacji w pliku danych, a innego do systemu rezerwacji online. Dowolna wartość w formie ciągu znaków
Wycofany: dowolny atrybut niestandardowy typu ciąg znaków. Nie są one wyświetlane użytkownikom.

Ważne: jeśli chcesz używać zmiennych CUSTOM, skontaktuj się z technicznym menedżerem konta.

 Dowolna wartość w formie ciągu znaków
hotel_brand Marka, do której należy ten hotel, np. „Marriott” lub „Hilton”. Nie jest on widoczny dla użytkowników, ale można go używać do grupowania hoteli. Dowolna wartość w formie ciągu znaków
lodging Zakodowana reprezentacja wszystkich pól dostępnych w Lodgingproto. Ciąg tekstowy zakodowany w formacie Base64, który zawiera protokół encoded Lodging.
num_reviews Liczba opinii o wizytówce.

Ważne: parametr „num_reviews” należy przesyłać tylko w przypadku plików danych dotyczących obiektów wakacyjnych.

 Dowolna nieujemna liczba całkowita.
rating Liczba zmiennoprzecinkowa reprezentująca łączną ocenę obiektu. Zwykle jest to liczba z zakresu 0–5, 0–10 lub 0–100, ale możesz użyć dowolnego zakresu, który odpowiada Twojemu systemowi ocen. Na przykład ocena obiektu powinna wynosić 3 lub 4, jeśli skala oceny to 5.

Uwaga: jeśli nie podasz wartości, domyślna skala oceny to 0–10.

Wartości obiektu zastępczego attribute_name w przypadku wynajmu wakacyjnego

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

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

Zdjęcia służą do wyświetlania nieruchomości w identyfikatorze oferty. Wszystkie użyte obrazy muszą być zgodne z tymi wytycznymi:

  • Zalecany format obrazu to 4:3.
  • Adres URL obrazu musi być dostępny dla robota Googlebot indeksującego obrazy.

  • Jeśli Twoja witryna zawiera plik robots.txt w katalogu głównym, sprawdź, czy zawiera on jedną z dwóch opcji:

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

      • User-agent: Googlebot
      • Allow: /

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

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

  • Zrzuty ekranu przedstawiające obrazy lub strony internetowe są niedozwolone. Obrazy muszą być oryginalne i przedstawiać rzeczywiste zdjęcia.

Atrybuty

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

Obraz musi być jednym z tych typów:
url Required Text Adres URL obrazu w pełnym rozmiarze. Użyj atrybutu url, aby określić obraz, który ma być używany na tej stronie.
width Required A non-negative integer Szerokość obrazu w pikselach (zalecana wartość to ponad 720 pikseli).
height Required A non-negative integer Wysokość obrazu w pikselach (zalecana wartość to ponad 720 pikseli).

Elementy potomne

Element podrzędny Wymagany? Opis
<link> Wymagane w przypadku lokalnych informacji ze zdjęciami. Ten tag zawiera prawidłowy i aktualny adres URL strony w Twojej witrynie, na której znajduje się odpowiedni obraz. 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ć nazwą użytkownika lub pełnym imieniem i nazwiskiem w formacie „Imię Nazwisko”.
<date> Wymagane

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

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

Przykład

Ten przykład przedstawia częściową listę hoteli z tagami obrazów:

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

Wskazówki dotyczące składni

Podczas tworzenia listy hoteli opartej na XML-u postępuj zgodnie z tymi wskazówkami:

  • Sprawdź poprawność plików XML z listą hoteli za pomocą schematu XSD Google.

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

  • Wartości danych w pliku danych możesz określać za pomocą sekcji CDATA. Jeśli używasz sekcji 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 adresów URL. Do reprezentowania tych znaków specjalnych możesz używać kodu encji lub kodu znaku. W tabeli poniżej znajdziesz listę najczęściej używanych kodów encji i znaków:

    Znak Jednostka Kod znaku
    Ampersand (&) &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 dodawaj pustych elementów <latitude/> i <longitude/>.

  • Pod żadnym pozorem nie używaj kodu HTML w elementach XML (nawet jeśli jest on poprzedzony znakiem zmiany znaczenia).

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

  • Aby użyć komentarzy w pliku danych, umieść je między tagami <!-- i -->, jak w tym przykładzie:

    <!-- This is a comment -->