rocket
Meet
Merchant API
– phiên bản chính thức thay thế Content API for Shopping.
updateNhận thông tin mới nhất
về các tính năng mới, bản sửa lỗi và thông tin cập nhật về bản phát hành của Merchant API.
point_of_sale
Tìm hiểu cách quản lý doanh nghiệp và sản phẩm của bạn trên Google, cũng như cách truy cập vào dữ liệu, thông tin chi tiết và các chức năng riêng biệt ở quy mô lớn theo phương thức lập trình.
Bắt đầu sử dụng Merchant API ngay hôm nay!
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.
Tóm tắt
Tài khoản Merchant Center lưu trữ thông tin sản phẩm cho chiến dịch Mua sắm.
Bạn tải thông tin sản phẩm lên tài khoản người bán của mình thông qua nguồn cấp dữ liệu sản phẩm.
Bạn có thể tạo nguồn cấp dữ liệu sản phẩm để tải nhiều sản phẩm lên cùng một lúc trong Merchant Center hoặc thông qua Content API for Shopping. Content API for Shopping cũng cho phép bạn tải lên và cập nhật từng sản phẩm.
Khi tải lên bằng cả nguồn cấp dữ liệu và API, các sản phẩm mới tải lên phải trải qua quy trình kiểm tra chất lượng dữ liệu. Quá trình này có thể mất đến 72 giờ để giải quyết. Trong thời gian chờ đợi, những sản phẩm này sẽ có
trạng thái pending. Hãy xem trang Định nghĩa trạng thái sản phẩm để tìm hiểu thêm.
Nếu đã có thông tin sản phẩm trong một nền tảng thương mại điện tử, bạn có thể kết nối nền tảng thương mại điện tử đó với Merchant Center để thông tin được chia sẻ tự động. Hãy kiểm tra với nhà cung cấp nền tảng thương mại điện tử của bạn để xem có trình kết nối nào để chia sẻ thông tin sản phẩm với Merchant Center hay không.
Tất cả sản phẩm phải tuân thủ quy cách dữ liệu sản phẩm. Hãy đọc kỹ quy cách để hiểu bạn cần cung cấp những thuộc tính sản phẩm nào để một sản phẩm hợp lệ. Một số loại sản phẩm yêu cầu các thuộc tính khác với các thuộc tính khác.
Các bước thủ công
Nếu đây là lần đầu tiên bạn tạo nguồn cấp dữ liệu, thì bạn có thể phải đợi vài lần để khắc phục tất cả các lỗi. Hãy truy cập vào Cộng đồng nhà quảng cáo Google để được trợ giúp.
Bạn có thể sử dụng Content API for Shopping để tải hàng loạt thông tin sản phẩm lên thông qua nguồn cấp dữ liệu và để gửi từng thông tin sản phẩm riêng lẻ.
Bạn chỉ có thể tự động hoá nguồn cấp dữ liệu theo lịch.
Sử dụng dịch vụ datafeeds để tạo, cập nhật và xoá các nguồn cấp dữ liệu đã đăng ký.
Sử dụng tài nguyên products để tải lên và cập nhật từng sản phẩm.
Lỗi sản phẩm được báo hiệu bằng thông báo trạng thái HTTP không phải 2xx và phần nội dung của phản hồi chứa thêm thông tin.
Ngay cả những sản phẩm đã tải lên thành công cũng có thể trả về cảnh báo mà bạn nên kiểm tra để cải thiện dữ liệu tự hào của mình. Hãy xem hướng dẫn về các lỗi phổ biến để biết thêm thông tin.
Bạn có thể sử dụng dịch vụ productstatuses để xem trạng thái của sản phẩm trên tài khoản của mình.
Từng sản phẩm riêng lẻ được tải lên qua Content API for Shopping sẽ hết hạn sau 30 ngày hoặc vào ngày hết hạn được đặt theo cách thủ công, tuỳ theo điều kiện nào đến trước.
Để sản phẩm không hết hạn, bạn phải cập nhật hoặc chèn lại sản phẩm. Bạn cần phải lên lịch làm mới định kỳ cho điểm cuối products của Content API for Shopping.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eMerchant Center accounts store product information for Shopping campaigns, which is uploaded via product feeds or the Content API.\u003c/p\u003e\n"],["\u003cp\u003eGoogle strongly recommends using the Content API for Shopping for its flexibility and scalability over manual feed uploads.\u003c/p\u003e\n"],["\u003cp\u003eProducts uploaded through any method undergo data quality checks and may take up to 72 hours to resolve before becoming active.\u003c/p\u003e\n"],["\u003cp\u003eAll products must adhere to the Product data specification, which outlines the required attributes for different product types.\u003c/p\u003e\n"],["\u003cp\u003eThe Content API for Shopping offers methods for bulk uploads via feeds and individual product updates, requiring regular refreshes to prevent product expiration.\u003c/p\u003e\n"]]],[],null,["# Create a feed\n\nSummary\n-------\n\nMerchant Center accounts store the product information for Shopping campaigns.\nYou upload product information to your merchant account through product feeds.\nYou can create product feeds that upload multiple products at a time in\nthe [Merchant Center](https://merchants.google.com) or through the [Content API for Shopping](/shopping-content/guides/products/products-api). The Content API\nfor Shopping also lets you upload and update individual products.\n| **Objective:** We strongly recommend you use the Content API for Shopping. The Content API is much more flexible and scalable than the manual steps.\n\nWith both feed and API uploads, newly uploaded products are subject to data\nquality checks that may take up to 72 hours to resolve. These products will have\nthe `pending` status in the meantime. See the [Product status definitions](//support.google.com/merchants/answer/160491) page\nto learn more.\n\nIf you already have product information in an eCommerce platform, you may be\nable to connect that eCommerce platform to the Merchant Center and have the\ninformation shared automatically. Check with your eCommerce platform provider to\nsee if any connectors exist for sharing product information with the Merchant\nCenter.\n\nAll products must adhere to the [Product data specification](//support.google.com/merchants/answer/188494). Read\nthrough the specification to understand what product attributes must be provided\nfor a product to be valid. Some types of products require different attributes\nthan others.\n\nManual steps\n------------\n\nIf this if your first time creating a feed, it may take a few tries to\nresolve all the errors. See the [Google Advertiser Community](//www.en.advertisercommunity.com/t5/Google-Shopping-and-Merchant/bd-p/google-shopping) for help.\n\n1. See [About feeds](//support.google.com/merchants/answer/188478) and [File formats for product data](//support.google.com/merchants/answer/160567) to plan the structure of your feed.\n2. Follow the steps in [Upload a feed](//support.google.com/merchants/answer/188477).\n\nAutomatic steps\n---------------\n\nYou can use the Content API for Shopping to bulk upload product information\nthrough feeds and to send individual product information.\n\nYou can only automate scheduled feeds.\n\n- Use the [`datafeeds`](/shopping-content/reference/rest/v2.1/datafeeds) service to create, update, and delete registered feeds.\n- Use the [`products`](/shopping-content/reference/rest/v2.1/products) resource to upload and update individual products.\n\n See the [Product data specification](//support.google.com/merchants/answer/188494) to learn which fields are required\n for your specific product.\n\n Use [`products.insert`](/shopping-content/reference/rest/v2.1/products/insert) to upload product information. If you're sending\n multiple products at once, see [Sending batch requests](/shopping-content/guides/how-tos/batch).\n\n Product errors are signaled with a non-2xx HTTP status message, and\n the body of the response contains more information.\n\n Even successfully uploaded products may return warnings that you\n should examine to improve your proudct data. See the [common errors](/shopping-content/guides/how-tos/common-errors) guide\n for more information.\n\n You can use the [`productstatuses`](/shopping-content/reference/rest/v2.1/productstatuses) service to see the status of products on\n you account.\n\n Individual products uploaded through the Content API for Shopping\n expire either after 30 days or on their manually set expiration date,\n whichever comes first.\n\n In order to keep products from expiring, they must be updated or\n re-inserted. It's important to schedule a regularly occurring refresh to the\n Content API for Shopping's [`products`](/shopping-content/reference/rest/v2.1/products) endpoint."]]
