Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Aby skonfigurować listę hoteli, możesz użyć jednej z tych metod:
Prześlij plik CSV lub XML
Przesyłanie pliku z Hotel Center
Hostowanie pliku na serwerze
W tym przewodniku znajdziesz informacje o tym, jak skonfigurować listę hoteli za pomocą plików XML i umieścić plik danych XML na serwerze, aby Google mógł pobierać pliki XML zgodnie z podanym harmonogramem. Inne metody konfigurowania listy hoteli znajdziesz w artykule Konfigurowanie zasobów reklamowych hotelu.
Listy hoteli w formacie XML
Plik z listą hoteli zawiera dane opisowe, takie jak nazwa obiektu, adres i lokalizacja GeoCode, uporządkowane według obiektu dla wszystkich obiektów na koncie Hotel Center.
Poniżej przedstawiamy bardzo prosty przykład pliku listy hoteli w formacie XML. Ten przykład pokazuje tylko jeden z wielu elementów <listing> określonych w pliku. Każdy element <listing> reprezentuje właściwość.
Za pomocą metody dostarczania danych z listy hoteli możesz przechowywać listę hoteli na swoim serwerze, a Google będzie pobierać plik danych z ustawioną przez Ciebie częstotliwością. Po utworzeniu listy hoteli i sprawdzeniu jej plików XML wykonaj te czynności:
harmonogram pobierania danych do Google (zwykle raz w tygodniu);
Adres URL do pobrania i wymagania dotyczące uwierzytelniania
Jeśli nie ma żadnych błędów, lista hoteli zostanie opublikowana, a wszystkie obiekty, które zostały pomyślnie dopasowane w Mapach Google, pojawią się na Twoim koncie Hotel Center na karcie Obiekty.
Jeśli wystąpią błędy, Google poinformuje Cię o nich, aby umożliwić ich poprawienie i ponowne przygotowanie plików do pobrania.
Wymagania dotyczące hostingu
Podczas hostowania pliku danych XML należy przestrzegać tych wymagań:
Wymagania dotyczące serwera
Serwer musi być dostępny przez HTTP lub HTTPS.
Wymagania dotyczące katalogu
Aby mieć pewność, że Google pobiera kompletny zrzut Twoich danych i nie
próbuje pobierać niekompletnych plików, przestrzegaj tych wytycznych, gdy przesyłasz pliki na serwer HTTP.
Tworzenie i sprawdzanie plików XML pliku danych w katalogu innym niż ten, z którego pliki pobiera Google, czyli nie używaj katalogu download.
Po pomyślnym sprawdzeniu plików XML pliku danych utwórz dowiązanie symboliczne z katalogu pobierania do nowo utworzonego pliku danych.
Jeśli przesyłasz plik .zip, dołącz pliki XML na poziomie głównym, a nie w katalogu pobierania.
Wymagania dotyczące plików
Używaj plików tekstowych, a nie sformatowanych plików, takich jak pliki programu Microsoft Word.
Rozpakowany plik XML nie może mieć rozmiaru większego niż 100 MB. Pojedynczy plik XML lub wiele takich plików można skompresować do jednego pliku .zip. Nie ma limitu dla spakowanych plików XML ani plików .zip.
Nazwij pliki w ten sposób:
W przypadku pojedynczego pliku XML użyj PARTNER_NAME_local.xml.
W przypadku pojedynczego pliku XML lub wielu plików XML w skompresowanym pliku ZIP użyj:PARTNER_NAME_local.xml.zip
Poszczególne pliki XML w archiwum ZIP mogą mieć dowolne nazwy, ale zalecamy dodanie kodu języka do nazwy każdego pliku.
Wymagania dotyczące uwierzytelniania
Opcjonalnie możesz zabezpieczyć swoje pliki nazwą użytkownika i hasłem, używając uwierzytelniania BASIC lub DIGEST.
Protokół NTLM nie jest obsługiwany.
Wszelkie prawa zastrzeżone. Java jest zastrzeżonym znakiem towarowym firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eThis guide explains how to set up a hotel list using XML files hosted on your server, allowing Google to download them on a scheduled basis.\u003c/p\u003e\n"],["\u003cp\u003eHotel list files contain descriptive data for each property, such as name, address, and location, organized by property and requiring a separate file for each supported language.\u003c/p\u003e\n"],["\u003cp\u003eTo create a hotel list feed in XML, review file requirements, code files according to the Hotel List XML Reference, and validate them using the provided schema.\u003c/p\u003e\n"],["\u003cp\u003eAfter validation, host the feed on your server, ensuring it meets the hosting requirements including server accessibility, directory structure, file size and naming conventions, and optional authentication.\u003c/p\u003e\n"],["\u003cp\u003eGoogle will fetch the hosted feed at a scheduled frequency, and if there are no errors, your hotel list will be published and properties matched in Google Maps will be displayed in your Hotel Center account.\u003c/p\u003e\n"]]],[],null,["# Set Up a Hotel List in XML\n\n| **Important:** Before continuing, review [How to set up your hotel\n| inventory](https://support.google.com/hotelprices/answer/9218458) to determine the best method for setting up a [hotel list](//hotelcenter.google.com/properties/allhotels) for your properties, such as [hotels or vacation rentals](https://support.google.com/hotelprices/answer/9970971).\n\nTo set up your hotel list, you can use one of these methods:\n\n- Provide a CSV or XML file\n- Upload a file from Hotel Center\n- Host a file on a server\n\nThis guide describes how to set up a hotel list using XML files and host the\nXML feed on your server for Google to download your XML files at the requested\nschedule. For other methods of setting up a hotel list, see\n[How to set up your hotel inventory](https://support.google.com/hotelprices/answer/9218458).\n\nAbout hotel lists in XML\n------------------------\n\nA hotel list file contains descriptive data---such as property name,\naddress, GeoCode location---organized by property, for all of the\nproperties in a Hotel Center account.\n| **Key Point:** A separate file is required for each supported language. The language is specified with the `\u003clanguage\u003e` element.\n\nA very basic example of a hotel list file in the XML file format is shown\nbelow. This example shows only one of the several `\u003clisting\u003e` elements that are\nspecified in the file. Each `\u003clisting\u003e` element represents a property. \n\n \u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n \u003clistings xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n xsi:noNamespaceSchemaLocation=\"http://www.gstatic.com/localfeed/local_feed.xsd\"\u003e\n \u003clanguage\u003een\u003c/language\u003e\n \u003clisting\u003e\n \u003c!-- The value of \u003cid\u003e must be unique to your site for all time. Do NOT reuse IDs. --\u003e\n \u003cid\u003e123abc\u003c/id\u003e\n \u003cname\u003eBelgrave House\u003c/name\u003e\n \u003caddress format=\"simple\"\u003e\n \u003ccomponent name=\"addr1\"\u003e6 Acacia Ave\u003c/component\u003e\n \u003ccomponent name=\"addr2\"\u003eFloor 5\u003c/component\u003e\n \u003ccomponent name=\"city\"\u003eLondon\u003c/component\u003e\n \u003ccomponent name=\"province\"\u003eGreater London\u003c/component\u003e\n \u003ccomponent name=\"postal_code\"\u003eSW1W 9TQ\u003c/component\u003e\n \u003c/address\u003e\n \u003ccountry\u003eGB\u003c/country\u003e\n \u003clatitude\u003e35.070374\u003c/latitude\u003e\n \u003clongitude\u003e-106.213648\u003c/longitude\u003e\n \u003cphone type=\"main\"\u003e123-456-7890\u003c/phone\u003e\n \u003ccategory\u003ehotel\u003c/category\u003e \u003c!-- You can use whatever property type categories you wish --\u003e\n \u003c/listing\u003e\n ...\n \u003c/listings\u003e\n\nCreate a hotel list in XML\n--------------------------\n\nTo create a hotel list feed in XML, follow these steps:\n\n1. Review the [file requirements](/hotels/hotel-prices/dev-guide/hlf#file-reqs).\n\n2. Code your files as described in the [Hotel List XML\n Reference](/hotels/hotel-prices/xml-reference/hotel-list-feed).\n\n3. Validate the files using the hotel list feed\n [schema](/hotels/hotel-prices/dev-guide/schemas).\n\nAfter validating your files, host the feed on your server. Alternatively, you\ncan manually [upload your list in Hotel\nCenter](https://support.google.com/hotelprices/answer/9218458#upload_a_hotel_list_feed).\n\nHost XML feed on your server\n----------------------------\n\nWith the Hotel List Pull delivery method, you can host a hotel list on your\nserver, and Google will fetch the feed at your preferred frequency. After you've\ncreated your hotel list and validated its XML files, do the following:\n\n1. Prepare the files for Google as described in [Hosting\n requirements](#hosting-reqs).\n\n2. Contact your Technical Account Manager (TAM) to set up the following:\n\n - A download schedule for Google, typically once a week\n - The download URL and authentication requirements\n\nIf there are no errors, your hotel list is published and all the properties\nthat are successfully matched in Google Maps are displayed on your Hotel\nCenter account, under the Properties tab.\n\nIf there are errors, Google shares the errors with you so that you can fix\nthem and prepare the files for download again.\n\n### Hosting requirements\n\nObserve the following requirements when hosting your XML feed:\n\n#### Server requirement\n\n- The server must be accessible through either HTTP or HTTPS.\n\n#### Directory requirements\n\nTo ensure that Google retrieves a complete snapshot of your data and does not\nattempt to download incomplete files, follow these guidelines when posting\nfiles to your HTTP server:\n\n- Develop and validate your feed's XML files in a directory other than the one\n Google fetches from, that is: Don't use the `download` directory.\n\n- After you've successfully validated your feed's XML files, create a symbolic\n link from the download directory to the newly created feed.\n\n- If you're providing a `.zip` file, include the XML files at the root level\n and not within the download directory.\n\n#### File requirements\n\n- Use plain text files and not a formatted file like a Microsoft Word\n file.\n\n- Make sure that the uncompressed XML file does not exceed 100 MB. Single or\n multiple XML files can be compressed into a single `.zip` file. There is no\n limit for zipped XML files or `.zip` files.\n\n- Name the files as follows:\n\n - For a single XML file, use \u003cvar translate=\"no\"\u003ePARTNER_NAME\u003c/var\u003e`_local.xml`.\n - For single or multiple XML files in a zip, use \u003cvar translate=\"no\"\u003ePARTNER_NAME\u003c/var\u003e`_local.xml.zip`\n\n The individual XML files in the zip can be named in any manner,\n however, we recommend appending a language code to each filename.\n | **Key Point:** Only **`STORED`** and **`DEFLATED`** compression methods are supported.\n\n#### Authentication requirements\n\n- Optionally, you can secure your files with a username and password using\n either BASIC or DIGEST authentication.\n\n- NTLM is not supported."]]
