Quản lý sản phẩm của bạn
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.
API con Sản phẩm cho phép bạn quản lý kho hàng theo cách lập trình trong Google Merchant Center. Bạn có thể tạo, truy xuất, cập nhật và xoá sản phẩm, giúp bạn linh hoạt tích hợp hệ thống của mình trực tiếp với Google.
Một khái niệm quan trọng trong Merchant API là sự khác biệt giữa dữ liệu bạn gửi và sản phẩm cuối cùng mà Google sử dụng. Việc tách biệt này cung cấp một mô hình rõ ràng hơn về vòng đời dữ liệu sản phẩm và giúp bạn kiểm soát thông tin sản phẩm chính xác hơn. API này phản ánh điều này bằng 2 tài nguyên chính:
ProductInput:
Đây là dữ liệu thô về sản phẩm mà bạn gửi đến một nguồn dữ liệu cụ thể.
Hãy xem đây là hàng mà bạn tải lên trong một tệp nguồn cấp dữ liệu hoặc dữ liệu mà bạn gửi bằng một lệnh gọi API trước khi Merchant Center xử lý. Bạn sử dụng tài nguyên này cho tất cả các thao tác ghi (insert, patch, delete).
Product:
Đây là một tài nguyên chỉ đọc, thể hiện sản phẩm đã được xử lý cuối cùng khi sản phẩm đó xuất hiện trong Merchant Center và trên các nền tảng của Google. Nguồn cấp dữ liệu này được tạo từ một ProductInput chính và không hoặc nhiều tài nguyên ProductInput bổ sung sau khi tất cả các quy tắc và quy trình xử lý nguồn cấp dữ liệu được áp dụng. Tài nguyên này bao gồm trạng thái cuối cùng của sản phẩm và mọi vấn đề về chất lượng dữ liệu.
Bạn sử dụng tài nguyên này cho tất cả các thao tác đọc (get, list).
Định dạng và yêu cầu đối với tất cả các thuộc tính sản phẩm được gửi bằng tài nguyên ProductInput được xác định trong Quy cách dữ liệu sản phẩm.
Những việc bạn có thể làm với API phụ Sản phẩm
API con Products cho phép bạn thực hiện các tác vụ chính sau đây. Khám phá các hướng dẫn để biết hướng dẫn chi tiết và mẫu mã cho từng trường hợp sử dụng.
- Thêm và quản lý sản phẩm: Tìm hiểu cách thêm sản phẩm mới vào tài khoản, cung cấp dữ liệu bổ sung cho sản phẩm hiện có và xoá sản phẩm bạn không còn bán nữa.
- Thường xuyên cập nhật sản phẩm: Tìm hiểu cách cập nhật một phần hiệu quả cho những thuộc tính sản phẩm thường xuyên thay đổi, chẳng hạn như giá và tình trạng còn hàng.
- Liệt kê dữ liệu sản phẩm và các vấn đề về sản phẩm: Tìm hiểu cách truy xuất các sản phẩm đã được xử lý, kiểm tra trạng thái phê duyệt của sản phẩm cho nhiều vị trí xuất hiện và xác định mọi vấn đề về chất lượng dữ liệu có thể ảnh hưởng đến khả năng hiển thị của sản phẩm.
Trước khi bắt đầu
Trước khi sử dụng API phụ Sản phẩm, bạn phải tạo ít nhất một nguồn dữ liệu API trong tài khoản Merchant Center. API con Products chỉ có thể chèn hoặc cập nhật sản phẩm trong nguồn dữ liệu thuộc loại API. Để biết hướng dẫn, hãy xem hướng dẫn Quản lý nguồn dữ liệu API để tải sản phẩm lên.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-22 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-22 UTC."],[[["\u003cp\u003eThe Merchant Products API allows you to programmatically manage your product data, including inserting, updating, retrieving, and deleting products.\u003c/p\u003e\n"],["\u003cp\u003eProducts are managed through two key resources: \u003ccode\u003eproductInputs\u003c/code\u003e (representing input data) and \u003ccode\u003eproducts\u003c/code\u003e (representing processed products in the Shopping database).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eproductInputs\u003c/code\u003e can be primary or supplementary and are used to construct the final \u003ccode\u003eproduct\u003c/code\u003e that appears in your online or local store catalogs.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers advantages over file-based uploads, such as faster response times and real-time updates.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, ensure you have a data source set up and are familiar with Shopping Ads and free listings policies.\u003c/p\u003e\n"]]],["The Merchant Products API allows programmatic product data management via `productInputs` and `products` resources. Actions include inserting `productInput` data with required fields like `channel`, `offerId`, `contentLanguage`, and `feedLabel` using `accounts.productInputs.insert`. Processed products can be retrieved using `accounts.products.get` and listed with `accounts.products.list`. Product inputs are deleted using `accounts.productInputs.delete`, specifying the data source. Products are built from primary and supplemental data sources, enabling real-time catalog management. You can use Batch mode to manage many products.\n"],null,["# Manage your products\n\nThe Products sub-API lets you programmatically manage your product inventory in\nGoogle Merchant Center. You can create, retrieve, update, and delete products,\ngiving you the flexibility to integrate your systems directly with Google.\n\nA key concept in Merchant API is the distinction between the data you submit and\nthe final product that Google uses. This separation provides a clearer model of\nthe product data lifecycle and gives you more precise control over your product\ninformation. The API reflects this with two main resources:\n\n- **[`ProductInput`](/merchant/api/reference/rest/products_v1/accounts.productInputs#ProductInput):**\n This represents the raw product data you submit to a specific data source.\n Think of this as the row you upload in a feed file or the data you submit\n with an API call before any Merchant Center processing happens. You use this\n resource for all **write** operations (`insert`, `patch`, `delete`).\n\n- **[`Product`](/merchant/api/reference/rest/products_v1/accounts.products#Product):**\n This is a read-only resource that represents the final, processed product as\n it appears in Merchant Center and on Google surfaces. It is built from one\n primary `ProductInput` and zero or more supplemental `ProductInput`\n resources after all feed rules and processing have been applied. This\n resource includes the product's final status and any data quality issues.\n You use this resource for all **read** operations (`get`, `list`).\n\nThe format and requirements for all product attributes submitted using the\n`ProductInput` resource are defined in the [Product data\nspecification](https://support.google.com/merchants/answer/7052112).\n\nWhat you can do with the Products sub-API\n-----------------------------------------\n\nThe Products sub-API lets you to perform the following key tasks. Explore the\nguides for detailed instructions and code samples for each use case.\n\n- [Add and manage products](/merchant/api/guides/products/add-manage): Learn how to add new products to your account, provide supplemental data for existing ones, and delete products you no longer sell.\n- [Make frequent updates to your\n products](/merchant/api/guides/products/frequent-updates): Discover how to make efficient, partial updates to product attributes that change often, such as price and availability.\n- [List your products data and product\n issues](/merchant/api/guides/products/list-products-data-issues): Find out how to retrieve your processed products, check their approval status for different destinations, and identify any data quality issues that may be affecting their visibility.\n\nBefore you begin\n----------------\n\nBefore using the Products sub-API, you must create at least one API data source\nin your Merchant Center account. The Products sub-API can only insert or update\nproducts in data sources of type `API`. For instructions, see the [Manage API\ndata sources for product uploads](/merchant/api/guides/data-sources/api-sources) guide."]]
