Lists the collections in your Merchant Center account. The response might contain fewer items than specified by pageSize. Rely on nextPageToken to determine if there are more items to be requested.
HTTP request
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/collections
[[["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-02-25 UTC."],[[["\u003cp\u003eThis operation lists the collections within a specified Merchant Center account, enabling pagination for retrieving large sets of data.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003emerchantId\u003c/code\u003e as a path parameter, specifying the account containing the collections.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e control the number of results per page and navigation between pages.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of collections and a \u003ccode\u003enextPageToken\u003c/code\u003e if additional pages are available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document outlines how to retrieve a list of collections from a Merchant Center account using an HTTP GET request. The endpoint `https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/collections` requires the `merchantId` as a path parameter. Optional query parameters include `pageSize` (defaulting to 50, max 1000) and `pageToken` for pagination. The request body must be empty. The response contains an array of `resources` and a `nextPageToken` for subsequent pages. Authorization requires the `https://www.googleapis.com/auth/content` scope.\n"],null,["# Method: collections.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListCollectionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the collections in your Merchant Center account. The response might contain fewer items than specified by pageSize. Rely on nextPageToken to determine if there are more items to be requested.\n\n### HTTP request\n\n`GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/collections`\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the account that contains the collection. This account cannot be a multi-client account. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of collections to return in the response, used for paging. Defaults to 50; values above 1000 will be coerced to 1000. |\n| `pageToken` | `string` Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the collections.list method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"resources\": [ { object (/shopping-content/reference/rest/v2.1/collections#Collection) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `resources[]` | `object (`[Collection](/shopping-content/reference/rest/v2.1/collections#Collection)`)` The collections listed. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]