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.
Chúng tôi thiết kế Merchant API sao cho quen thuộc với các nhà phát triển Content API for Shopping, nhưng đơn giản và linh hoạt hơn. Sau đây là một số thông tin chi tiết về thiết kế của Merchant API.
API phụ
Merchant API là một tập hợp các API phụ. API phụ là các nhóm dịch vụ và tài nguyên có liên quan. Thiết kế này có nghĩa là bạn có thể chọn chỉ sử dụng các API phụ cần thiết cho hoạt động tích hợp riêng của mình.
Merchant API bao gồm các API phụ sau:
Tài khoản: Quản lý tài khoản Merchant Center trên quy mô lớn.
Sản phẩm: Quản lý dữ liệu sản phẩm, chẳng hạn như giá và tình trạng còn hàng.
Nguồn dữ liệu: Xem và quản lý nguồn dữ liệu cho sản phẩm của bạn.
Kho hàng: Giới thiệu sản phẩm của bạn theo cửa hàng hoặc khu vực trên Google.
Báo cáo: Xem dữ liệu về sản phẩm, hiệu suất và tình hình cạnh tranh của bạn trên Google.
Chương trình khuyến mãi: Tạo và quản lý chương trình khuyến mãi để giới thiệu các ưu đãi đặc biệt cho sản phẩm của bạn.
Các trường enum trên Merchant API có thể sẽ hiển thị các giá trị mới trong tương lai. Mã của bạn phải được cấu trúc theo cách có thể xử lý các giá trị không được nhận dạng một cách hiệu quả. Bạn nên theo dõi sự xuất hiện của các giá trị enum không nhận dạng được và can thiệp để giữ cho mã luôn mới.
Lập phiên bản
Các API phụ được lập phiên bản riêng. Điều này có nghĩa là bạn không cần làm gì cả nếu chúng tôi cập nhật một API phụ mà bạn không sử dụng. Bạn chỉ cần cập nhật mã khi các phiên bản mới của API phụ mà bạn sử dụng được phát hành. Để biết thêm thông tin, hãy xem phần Tạo phiên bản.
Các phiên bản có đuôi "beta" có thể thay đổi hoặc bị xoá.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-08 UTC."],[[["\u003cp\u003eThe Merchant API offers a collection of sub-APIs for managing various aspects of your online product data and presence on Google, including accounts, products, inventory, and reports.\u003c/p\u003e\n"],["\u003cp\u003eIt's designed for flexibility, allowing developers to choose and use only the specific sub-APIs relevant to their needs.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports both gRPC and REST transport mechanisms and features independent versioning for each sub-API, minimizing the impact of updates on existing integrations.\u003c/p\u003e\n"],["\u003cp\u003eAlthough in beta and subject to change, Google provides at least 30 days' notice for breaking changes, ensuring developers have ample time to adapt.\u003c/p\u003e\n"],["\u003cp\u003eThe Merchant API shares similarities with the Content API for Shopping but aims to provide a simpler and more adaptable development experience.\u003c/p\u003e\n"]]],[],null,["# Merchant API design\n\nWe designed Merchant API to be familiar to Content API for Shopping developers,\nyet simpler and more flexible. Here's some detailed information on the design of\nMerchant API.\n\nSub-APIs\n--------\n\nMerchant API is a collection of sub-APIs. The sub-APIs are groups of related\nservices and resources. This design means you can choose to use only the\nsub-APIs needed for your unique integration.\n\nMerchant API includes the following sub-APIs:\n\n- **[Accounts](/merchant/api/guides/accounts/overview)**: Manage Merchant Center accounts at scale.\n- **[Products](/merchant/api/guides/products/overview)**: Manage product data, like price and availability.\n- **[Data sources](/merchant/api/guides/data-sources/overview)**: View and manage the data sources for your products.\n- **[Inventories](/merchant/api/guides/inventories/overview):** Showcase your products by store or region on Google.\n- **[Reports](/merchant/api/guides/reports/overview):** View data on your products, performance, and competitive landscape across Google.\n- **[Promotions](/merchant/api/guides/promotions/overview)**: Create and manage promotions to showcase special offers for your products.\n- **[Local feeds\n partnership](/merchant/api/guides/local-feeds-partnership/overview)**: Upload your local product inventory feed.\n- **[Conversion sources](/merchant/api/guides/conversion-sources/overview)**: Manage conversion sources for your account.\n- **[Notifications](/merchant/api/guides/accounts/notifications)**: Manage notification subscriptions.\n- **[Quota](/merchant/api/reference/rest/quota_v1/accounts.quotas)**: Check the API quota of your accounts.\n\nTransport\n---------\n\nMerchant API's default transport mechanism is [gRPC](//grpc.io/docs/guides/).\nYou can also use\n[REST](//en.wikipedia.org/wiki/Representational_state_transfer).\n\nSee the [quickstart guide](/merchant/api/guides/quickstart#use_grpc_or_rest) for\nmore information.\n\nEnums\n-----\n\nEnum fields across Merchant API might be exposing new values in the future. Your\ncode should be structured in such a way that it can handle unrecognized values\ngracefully. You should monitor the occurrence of unrecognized enum values and\nintervene to keep the code up to date.\n\nVersioning\n----------\n\nSub-APIs are versioned separately. This means you don't need to do anything if\nwe update a sub-API that you don't use. You only need to update your code when\nnew versions of the sub-APIs you use are released. For more information, see\n[Versioning](/merchant/api/guides/versioning).\n\nVersions that end in \"beta\" are subject to change or removal.\n| **Note:** During the Merchant API beta, we might make breaking changes without updating the major version. We'll give at least 30 days of notice before making a breaking change. For the duration of the beta, all sub-APIs will remain on v1beta."]]
