Stay organized with collections
Save and categorize content based on your preferences.
Both Shopping partners and individual merchant accounts can have multiple
flagged links between their accounts and others.
The listlinks method
returns a list of all these links for the merchant center account
making the API call. It does not require any parameters and is invoked using an
HTTP GET request.
Service status
When listing links, responses will show a status for each individual service
within a link. Merchants have the option to either approve all listed services
or only a subset of those proposed in the request.
Services start out in a pending status until explicitly approved by a
merchant. After they are approved, services have an active status.
Removed services will show a status of inactive if there are other pending
or active services also present. Once all services comprising a link are
removed, the link will no longer be returned by the
listlinks method.
Example request
To list the link request sent by partner 123456789, send a GET
request with no parameters using the listlinks method.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
Example response
In this example, the merchant 98765 has yet to approve the request, so the
individual services have a pending status.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-13 UTC."],[[["The Merchant API is the new version of the Content API for Shopping and represents the future of the platform."],["The `listlinks` method allows retrieval of all flagged links between accounts, providing insight into account relationships."],["Each service within a link has a status, starting as `pending`, transitioning to `active` upon approval, and ultimately becoming `inactive` when removed."],["A simple HTTP GET request to the `listlinks` endpoint is sufficient to retrieve link information without requiring any parameters."]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. The `listlinks` method retrieves all links between merchant accounts without parameters via a `GET` request. Each service within a link has a `status`: `pending` (awaiting merchant approval), `active` (approved), or `inactive` (removed, but other services remain). Once all services are removed, the link is no longer listed. A `GET` request example and the `listlinks` method's response format are provided.\n"]]