Requesting links

To flag a relationship with a merchant account, a Shopping partner must first use the Accounts.link method to send a linking request.

The link request contains a linkedAccountId that identifies the merchant receiving the request and has an action type of request. Each link should also specificy a set of services that enumerates which features the partner provides to the merchant. The following services values are supported.

Service Description
shoppingAdsProductManagement Product data management for Shopping ads
shoppingActionsProductManagement Product data management for Shopping Actions
shoppingActionsOrderManagement Order management for Shopping Actions

Additionally, a request must also contain a valid linkType that describes the type of Shopping partner making the request. Shopping partners are assigned one of the following labels and should use their designated label in the linkType field when calling the API.

Valid linkTypes
channelPartner
eCommercePlatform

Example

The following API call sends a link request from a partner's account 123456789 to a merchant with linkedAccountId of "98765".

The "eCommercePlatform" linkType identifies the partner as an e-commerce platform. The services list indicates that the partner provides "shoppingAdsProductManagement" (product data management for Shopping ads) and "shoppingActionsOrderManagement" (order management for Shopping Actions) features.

POST https://www.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
  "linkedAccountId": "98765",
  "linkType": "eCommercePlatform",
  "services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
  "action": "request"
}

The next section describes how to get a list of existing links.