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.
Để gắn cờ mối quan hệ với một tài khoản người bán, trước tiên, đối tác Mua sắm phải sử dụng phương thức accounts.link để gửi yêu cầu liên kết.
Yêu cầu liên kết chứa một linkedAccountId xác định người bán nhận được yêu cầu và có loại action là request. Mỗi đường liên kết cũng phải chỉ định một bộ services liệt kê những tính năng mà đối tác cung cấp cho người bán. Các giá trị services sau đây được hỗ trợ.
Dịch vụ
Mô tả
shoppingAdsProductManagement
Quản lý dữ liệu sản phẩm cho quảng cáo Mua sắm
shoppingActionsProductManagement
Quản lý dữ liệu sản phẩm cho chương trình Mua bằng Google (trước đây gọi là Mua sắm Trực tiếp)
shoppingActionsOrderManagement
Quản lý đơn đặt hàng cho chương trình Mua bằng Google (trước đây gọi là Mua sắm Trực tiếp)
Ngoài ra, yêu cầu cũng phải chứa một linkType hợp lệ mô tả loại đối tác Mua sắm đưa ra yêu cầu. Các đối tác mua sắm được chỉ định một trong những nhãn sau đây và phải sử dụng nhãn được chỉ định trong trường linkType khi gọi API.
Valid linkTypes
channelPartner
eCommercePlatform
Ví dụ:
Lệnh gọi API sau đây sẽ gửi yêu cầu liên kết từ tài khoản của đối tác 123456789 đến một người bán có linkedAccountId là "98765".
"eCommercePlatform"linkType xác định đối tác là một nền tảng thương mại điện tử. Danh sách services cho biết rằng đối tác cung cấp các tính năng "shoppingAdsProductManagement" (quản lý dữ liệu sản phẩm cho quảng cáo Mua sắm) và "shoppingActionsOrderManagement" (quản lý đơn đặt hàng cho chương trình Mua bằng Google, trước đây gọi là Mua sắm Trực tiếp).
[null,null,["Cập nhật lần gần đây nhất: 2025-08-13 UTC."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eTo establish a relationship, partners must send a linking request using the \u003ccode\u003eaccounts.link\u003c/code\u003e method, specifying the desired services and partner type.\u003c/p\u003e\n"],["\u003cp\u003eThe link request requires approval from the receiving merchant before it becomes fully established.\u003c/p\u003e\n"],["\u003cp\u003ePartners can be categorized as either \u003ccode\u003echannelPartner\u003c/code\u003e or \u003ccode\u003eeCommercePlatform\u003c/code\u003e and must use their designated \u003ccode\u003elinkType\u003c/code\u003e in the API call.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eservices\u003c/code\u003e field allows partners to indicate the specific features they offer to merchants, such as product and order management.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. Shopping partners must use the `accounts.link` method to request a link to a merchant account. This requires specifying the `linkedAccountId` of the merchant, the `linkType` (e.g., `channelPartner`, `eCommercePlatform`), the provided `services` (e.g., `shoppingAdsProductManagement`), and an `action` of `request`. The link requires the receiving merchant's approval to be established. An example API call is provided.\n"],null,["# Request links\n\nTo flag a relationship with a merchant account, a Shopping partner must first\nuse the [`accounts.link`](/shopping-content/reference/rest/v2.1/accounts/link)\nmethod to send a linking request.\n| **Note:** The link is not fully established until the receiving merchant approves the request.\n\nThe link request contains a [`linkedAccountId`](/shopping-content/reference/rest/v2.1/accounts/link#linkedAccountId)\nthat identifies the merchant receiving the request and has an [`action`](/shopping-content/reference/rest/v2.1/accounts/link#action)\ntype of `request`. Each link should also specificy a set of [`services`](/shopping-content/reference/rest/v2.1/accounts/link#linkType)\nthat enumerates which features the partner provides to the merchant. The following\n[`services`](/shopping-content/reference/rest/v2.1/accounts/link#linkType) values\nare supported.\n\n| Service | Description |\n|------------------------------------|--------------------------------------------------------------------------------|\n| `shoppingAdsProductManagement` | Product data management for Shopping ads |\n| `shoppingActionsProductManagement` | Product data management for Buy on Google (formerly known as Shopping Actions) |\n| `shoppingActionsOrderManagement` | Order management for Buy on Google (formerly known as Shopping Actions) |\n\nAdditionally, a request must also contain a valid [`linkType`](/shopping-content/reference/rest/v2.1/accounts/link#linkType)\nthat describes the type of Shopping partner making the request. Shopping\npartners are assigned one of the following labels and should use their designated\nlabel in the `linkType` field when calling the API.\n\n| Valid linkTypes |\n|---------------------|\n| `channelPartner` |\n| `eCommercePlatform` |\n\nExample\n-------\n\nThe following API call sends a link request from a partner's account\n`123456789` to a merchant with `linkedAccountId` of `\"98765\"`.\n\nThe `\"eCommercePlatform\"` `linkType` identifies the partner as an e-commerce\nplatform. The `services` list indicates that the partner provides\n`\"shoppingAdsProductManagement\"` (product data management for Shopping ads) and\n`\"shoppingActionsOrderManagement\"` (order management for Buy on Google, formerly\nknown as Shopping Actions) features. \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link\n {\n \"linkedAccountId\": \"98765\",\n \"linkType\": \"eCommercePlatform\",\n \"services\": [\"shoppingAdsProductManagement\", \"shoppingActionsOrderManagement\"],\n \"action\": \"request\"\n }\n\nThe [next section](/shopping-content/guides/flagging/list) describes how to get a list of existing links."]]
