Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trước tiên, bạn cần tạo nguồn cấp dữ liệu, sau đó Google sẽ đánh giá các nguồn cấp dữ liệu đó.
Tạo nguồn cấp dữ liệu
Tạo(các) nguồn cấp dữ liệu. Bạn truyền hầu hết dữ liệu kho hàng cho Google thông qua nguồn cấp dữ liệu. Để bắt đầu, hãy tạo nguồn cấp dữ liệu Người bán (và nguồn cấp dữ liệu Dịch vụ nếu có):
Nguồn cấp dữ liệu người bán: Nguồn cấp dữ liệu người bán mô tả người bán và các đường liên kết đến hành động ở cấp người bán.
Nguồn cấp dữ liệu dịch vụ(không bắt buộc / không nên dùng): Bạn không nên triển khai nguồn cấp dữ liệu dịch vụ cho các chế độ tích hợp mới của Đường liên kết doanh nghiệp cho tính năng Đặt phòng.
Nếu bạn muốn duy trì chế độ tích hợp hiện có, hãy làm theo tài liệu cũ này.
Bạn có thể tìm hiểu thêm về cách chỉ định đường liên kết hành động trong nguồn cấp dữ liệu tích hợp của Đường liên kết doanh nghiệp của tính năng Đặt phòng tại đây.
Thêm siêu dữ liệu nguồn cấp dữ liệu vào từng nguồn cấp dữ liệu để hướng dẫn Google cách diễn giải nguồn cấp dữ liệu.
Sau đây là đoạn mã siêu dữ liệu của nguồn cấp dữ liệu:
Xuất nguồn cấp dữ liệu. Định dạng nguồn cấp dữ liệu được mô tả bằng ngữ pháp vùng đệm giao thức 3, tuy nhiên, bạn có thể tham khảo các mẫu được đề cập ở trên để xem định dạng JSON.
Bạn nên tải nguồn cấp dữ liệu lên ở định dạng JSON.
Nếu bạn thực sự muốn tiếp tục với định dạng pb3, hãy xem Kiến thức cơ bản về vùng đệm giao thức: Java để biết thông tin chung về cách sử dụng vùng đệm giao thức nhằm tạo tệp pb3.
Tải nguồn cấp dữ liệu lên máy chủ SFTP. Để tải nguồn cấp dữ liệu lên, hãy sử dụng
thông tin máy chủ SFTP mà Google cung cấp cho bạn và
khoá riêng tư mà bạn đã tạo trong phần
Thiết lập. Máy chủ SFTP của Google có sẵn tại sftp://partnerupload.google.com trên cổng 19321.
Tải tệp lên bằng tên riêng biệt, chẳng hạn như tên có chứa dấu thời gian. Tên riêng biệt giúp khắc phục sự cố và cho phép truy vấn trạng thái nguồn cấp dữ liệu.
Để xác định kích thước nguồn cấp dữ liệu và tần suất phân phối, hãy sử dụng các nguyên tắc sau:
Kích thước của tệp nguồn cấp dữ liệu và mảnh:
Giữ kích thước tệp nguồn cấp dữ liệu dưới 200 MB (sau khi nén). Nén các tệp đó bằng gzip
Nếu tệp của bạn có thể đạt hơn 200 MB (sau khi nén), hãy chia tệp thành nhiều phân đoạn theo hướng dẫn
Phân đoạn tệp nguồn cấp dữ liệu
. Tuy nhiên, chỉ riêng tính năng tích hợp này khó có thể đạt đến giới hạn 200 MB.
Tần suất cập nhật đầy đủ:
Nguồn cấp dữ liệu đầy đủ của người bán được cung cấp một lần mỗi ngày.
(Nếu được triển khai) Nguồn cấp dữ liệu dịch vụ đầy đủ được cung cấp một lần mỗi ngày.
Google đánh giá nguồn cấp dữ liệu
Sau khi bạn tải nguồn cấp dữ liệu lên, Google sẽ xử lý và đánh giá chất lượng cũng như tính hoàn chỉnh của nguồn cấp dữ liệu đó. Chúng tôi xem xét một số yếu tố:
Nguồn cấp dữ liệu đáp ứng các quy cách.
Nguồn cấp dữ liệu bao gồm tất cả các trường bắt buộc.
Mỗi người bán có ít nhất một action_link hoặc một dịch vụ có ít nhất action_link được xác định.
Phần lớn dữ liệu người bán của bạn khớp với các vị trí trên Google Maps.
[null,null,["Cập nhật lần gần đây nhất: 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."]]