Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para sinalizar uma relação com uma conta de comerciante, um parceiro do Shopping precisa primeiro
usar o método accounts.link
para enviar uma solicitação de vinculação.
A solicitação de vinculação contém um linkedAccountId
que identifica o comerciante que recebe a solicitação e tem um tipo action
de request. Cada link também precisa especificar um conjunto de services
que enumera quais recursos o parceiro oferece ao comerciante. Os seguintes valores de
services são compatíveis.
Serviço
Descrição
shoppingAdsProductManagement
Gerenciamento de dados de produtos para anúncios do Shopping
shoppingActionsProductManagement
Gerenciamento de dados do produto para o Comprar com o Google (antigo Ações do Shopping)
shoppingActionsOrderManagement
Gerenciamento de pedidos do Comprar com o Google (antes conhecido como Ações do Shopping)
Além disso, uma solicitação também precisa conter um linkType válido
que descreva o tipo de parceiro do Shopping que está fazendo a solicitação. Os parceiros do Shopping recebem um dos seguintes rótulos e precisam usar o rótulo designado no campo linkType ao chamar a API.
linkTypes válidos
channelPartner
eCommercePlatform
Exemplo
A chamada de API a seguir envia uma solicitação de vinculação da conta de um parceiro
123456789 para um comerciante com linkedAccountId de "98765".
O "eCommercePlatform"linkType identifica o parceiro como uma plataforma de e-commerce. A lista services indica que o parceiro oferece recursos de "shoppingAdsProductManagement" (gerenciamento de dados de produtos para anúncios do Shopping) e "shoppingActionsOrderManagement" (gerenciamento de pedidos para o Comprar com o Google, antes conhecido como Ações do Shopping).
[null,null,["Última atualização 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."]]
