Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Najpierw musisz utworzyć pliki danych, a potem Google je oceni.
Tworzenie plików danych
Wygeneruj pliki danych. Przesyłasz większość danych o asortymencie do Google za pomocą plików danych. Aby rozpocząć, utwórz plik danych sprzedawcy (i w odpowiednich przypadkach plik danych usług):
Plik danych o firmach: plik danych o firmach opisuje Twoich sprzedawców i linki do działań na poziomie sprzedawcy.
Plik danych Usługi(opcjonalny / nie zalecany):
Nie zalecamy wdrażania plików danych Usługi w przypadku nowych integracji z Business Link Rezerwacji.
Jeśli chcesz zachować dotychczasową integrację, postępuj zgodnie z tą starszą dokumentacją.
Informacje o precyzyjnych linkach do konkretnych sprzedawców
Tak
Sprzedawca
action_link_type
Typ działania związanego z linkiem. Partnerzy korzystający z linku do strony składania rezerwacji powinni używać ACTION_LINK_TYPE_MAKE_DINING_RESERVATION.
Sprzedawca
brand_id
Ciąg znaków identyfikujący markę przeznaczoną dla klientów, której należy użyć
Opcjonalny
Na początek zapoznaj się z przykładowymi plikami danych
Wyeksportuj swoje pliki danych. Format plików danych jest opisany za pomocą składniki protokołu bufora 3, ale możesz też skorzystać z wymienionych powyżej przykładów, aby zobaczyć format JSON.
Zalecamy przesyłanie plików danych w formacie JSON.
Jeśli naprawdę chcesz użyć formatu pb3, ogólne informacje o używaniu buforów protokołu do generowania plików pb3 znajdziesz w artykule Podstawy bufora protokołu: Java.
Przesłać pliki danych na serwer SFTP. Aby przesłać pliki danych, użyj
informacji o serwerze SFTP, które otrzymasz od Google, oraz klucza prywatnego utworzonego w konfiguracji. Serwer SFTP Google jest dostępny pod adresem sftp://partnerupload.google.com na porcie 19321.
Przesyłaj pliki o niepowtarzalnych nazwach, np. z dodatkiem sygnatury czasowej. Unikalne nazwy ułatwiają rozwiązywanie problemów i umożliwiają wysyłanie zapytań dotyczących stanu kanału.
Aby określić rozmiar plików danych i częstotliwość przesyłania, zastosuj te wskazówki:
Rozmiar plików i fragmentów pliku danych:
Rozmiar pliku danych nie może przekraczać 200 MB (po skompresowaniu). Skompresuj je za pomocą gzip
Jeśli plik może mieć więcej niż 200 MB (po skompresowaniu), podziel go na kilka części zgodnie z instrukcjami w artykule
Podział plików danych na części
. Jednak sama ta integracja raczej nie spowoduje przekroczenia limitu 200 MB.
Częstotliwość pełnych aktualizacji:
Pełny plik danych sprzedawcy jest przesyłany raz dziennie.
(jeśli jest to możliwe) pełny plik danych o usłudze jest dostarczany raz dziennie;
Google ocenia pliki danych
Gdy prześlesz pliki danych, Google przetworzy je i oceni ich jakość oraz kompletność. Uwzględniamy kilka czynników:
pliki danych są zgodne ze specyfikacją,
Pliki danych zawierają wszystkie wymagane pola.
Każdy sprzedawca ma co najmniej 1 element action_link lub 1 usługę z co najmniej 1 elementem action_link.
Większość danych o sprzedawcy jest zgodna z lokalizacjami w Mapach Google.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eCreate and upload Merchant feeds daily to provide Google with your restaurant data, including location, contact details, and a deep link for reservations.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your feeds adhere to the provided specifications, include all required fields, and are in JSON format for optimal processing.\u003c/p\u003e\n"],["\u003cp\u003eGoogle will then evaluate your feeds for quality, completeness, and accuracy against Google Maps locations.\u003c/p\u003e\n"],["\u003cp\u003eWhile optional, consider providing a \u003ccode\u003ecategory\u003c/code\u003e field using Google's Place types and a \u003ccode\u003ebrand_id\u003c/code\u003e to enhance your listing.\u003c/p\u003e\n"],["\u003cp\u003eUse the SFTP dropbox provided by Google to upload your feeds, ensuring file sizes remain below 200MB after gzip compression.\u003c/p\u003e\n"]]],["To transmit inventory data, you must first generate a Merchant feed (and optionally a Services feed, though not recommended for new integrations). The Merchant feed, containing merchant details and action links, is required; other fields are optional. You'll then export the feed, preferably in JSON format, and upload it to Google's SFTP dropbox, using unique file names. Google will process it as soon as the last file is uploaded. Once they are uploaded, Google will evaluate your feed.\n"],null,["# Step 2: Feeds\n\nFirst you need to create your feeds, then Google evaluates them.\n\nCreate feeds\n------------\n\n1. **Generate your feed(s).** You transmit most of your inventory data to\n Google by feeds. To get started, create your Merchant feed (and Services feed if applicable):\n\n - [Merchants feed:](/actions-center/verticals/reservations/bl/reference/feeds/merchants-feed) The Merchants feed describes your merchants and merchant level action links.\n - [Services feed](/actions-center/verticals/reservations/bl/reference/feeds/services-feed) **(optional / not recommended)** : It is not recommended to implement services feeds for new Reservations Business Link integrations. If you are looking to maintain your existing integration, follow [this legacy documentation](/actions-center/legacy/archived-guides/starter-integration-feeds).\n\n **Required and Recommended fields**\n\n | Feed | Field name | Description | Required? |\n |----------|------------------|-----------------------------------------------------------------------------------------------------------------|--------------|\n | Merchant | merchant_id | Unique identifier for the merchant | Yes |\n | Merchant | name | Name of the merchant | Yes |\n | Merchant | geo | Address and geo coordinates of the merchant | Yes |\n | Merchant | telephone | Telephone of the merchant | Yes |\n | Merchant | category | [Place type](/maps/documentation/places/web-service/supported_types#table1) of the merchant | Nice to Have |\n | Merchant | action_link | Information regarding Merchant Specific Deep Links | Yes |\n | Merchant | action_link_type | Type of link action. Reservations Business Link partners should use `ACTION_LINK_TYPE_MAKE_DINING_RESERVATION`. |\n | Merchant | brand_id | String that identifies the consumer-facing brand to use | Optional |\n\n | **Note:** All additional fields outlined in the reference section should be ignored.\n | **Key Point:** You are only required to upload merchant feed.\n\n To start, check out the sample feeds\n - [Dining Reservation Feeds](/actions-center/verticals/reservations/bl/reference/feeds/merchants-feed#samples)\n\n You can learn more about specifying action links in Reservations Business Link integration\n feeds\n [here](/actions-center/verticals/reservations/bl/reference/tutorials/specifying-action-links).\n\n Include feed metadata in each of your feeds that instructs Google on\n how to interpret the feed.\n\n The following is a feed metadata snippet: \n\n ```scdoc\n \"metadata\": {\n \"generation_timestamp\": \"1467993600\",\n \"processing_instruction\": \"PROCESS_AS_COMPLETE\",\n \"total_shards\": 1\n }\n ```\n | **Note:** All feeds must be uploaded with processing_instruction PROCESS_AS_COMPLETE. PROCESS_AS_INCREMENTAL is deprecated and cannot be used.\n | **Note:** This integration can also be implemented in conjunction with the Actions Center end-to-end integration or as an addon to the end-to-end integration. In order to support this you will also be required to implement availability feeds and the end-to-end integration required fields as per this [guide](/actions-center/verticals/reservations/bl/policies/platform-policies#merchant_and_service_eligibility).\n2. **Export your feeds.** The feeds format is described with the\n [protocol buffer 3 syntax](/protocol-buffers/docs/proto3),\n however you can reference the samples mentioned above to see the JSON format.\n We recommend that you upload the feeds in JSON format.\n\n\n If you really want to proceed with pb3 format, for general information on how to use protocol\n buffers to generate a pb3 file, see\n [Protocol Buffer Basics: Java](/protocol-buffers/docs/javatutorial).\n3. **Upload the feeds to your SFTP server.** To upload your feeds, use\n the\n [SFTP server information](/actions-center/verticals/reservations/bl/integration-steps/setup#create-sftp) that Google provided to you and the\n private key that you created in\n [Setup](/actions-center/verticals/reservations/bl/integration-steps/setup#create-keys). The Google SFTP server is available at\n `sftp://partnerupload.google.com` on port `19321`.\n\n Upload your files with unique names, such as a name that includes a\n timestamp. Unique names help with troubleshooting and allow queries for\n the feed status.\n\n To determine the size of the feeds and frequency of delivery, use the\n following guidelines:\n - Size of feed files and shards:\n - Keep the feed file size below 200MB (after compression). Compress them using `gzip`\n - If your file may reach more than 200MB (after compression), split them in multiple shards following the [Sharding feed files](/actions-center/verticals/reservations/bl/reference/tutorials/sharding) tutorial. However, this integration alone is unlikely to reach the 200MB limit.\n - Frequency of complete updates:\n - A complete merchant feed is provided once a day.\n - (If implemented) A complete service feed is provided once a day.\n\n | **Note:** Google processes feed files as soon as they're uploaded to the SFTP server. If the feed is sharded into multiple files, the process begins after you upload the last file. If your feed contains errors, you receive an email with the [feed error codes](/actions-center/verticals/reservations/bl/reference/feeds/feed-errors).\n\nGoogle evaluates feeds\n----------------------\n\nOnce you upload your feeds, Google processes and evaluates them for quality\nand completeness. We look at several factors:\n\n- Feeds meet the specifications.\n- Feeds include all required fields.\n- Each merchant has at least one `action_link` or one service with at least `action_link` defined.\n- The majority of your merchant data matches with Google Maps locations.\n\n| **Note:** To ensure a smooth integration, perform a pre-evaluation of the factors above, except for the last one, before you submit your feeds."]]
