Request links

AI-generated Key Takeaways

outlined_flag

• The Merchant API is the new version of the Content API for Shopping and represents the future of the platform.

• To establish a relationship, partners must send a linking request using the accounts.link method, specifying the desired services and partner type.

• The link request requires approval from the receiving merchant before it becomes fully established.

• Partners can be categorized as either channelPartner or eCommercePlatform and must use their designated linkType in the API call.

• The services field allows partners to indicate the specific features they offer to merchants, such as product and order management.

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.

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.

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 Buy on Google, formerly known as Shopping Actions) features.

POST https://shoppingcontent.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.