rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
Method: conversionsources.list
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves the list of conversion sources the caller has access to.
HTTP request
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/conversionsources
Path parameters
Parameters |
merchantId |
string (int64 format)
Required. The ID of the account that owns the new conversion source.
|
Query parameters
Parameters |
pageSize |
integer
The maximum number of conversion sources to return in a page. If no pageSize is specified, 100 is used as the default value. The maximum value is 200 . Values above 200 will be coerced to 200 . Regardless of pagination, at most 200 conversion sources are returned in total.
|
pageToken |
string
Page token.
|
showDeleted |
boolean
If true, also returns archived conversion sources.
|
Request body
The request body must be empty.
Response body
Response message for the conversionsources.list method.
If successful, the response body contains data with the following structure:
JSON representation |
{
"conversionSources": [
{
object (ConversionSource )
}
],
"nextPageToken": string
} |
Fields |
conversionSources[] |
object (ConversionSource )
List of conversion sources.
|
nextPageToken |
string
Token to be used to fetch the next results page.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eRetrieves a list of conversion sources accessible to the caller, with pagination options and the ability to include archived sources.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the merchant ID as a path parameter and accepts optional query parameters for page size, page token, and inclusion of deleted sources.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of conversion sources and a token for retrieving the next page of results, if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the 'https://www.googleapis.com/auth/content' OAuth scope.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of conversion sources via an HTTP GET request to `https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/conversionsources`. The `merchantId` path parameter is required. Optional query parameters include `pageSize` (default 100, max 200), `pageToken`, and `showDeleted`. The request body should be empty. The response body, in JSON, contains an array of conversion sources and a `nextPageToken` for pagination. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"],null,["# Method: conversionsources.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.ListConversionSourcesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves the list of conversion sources the caller has access to.\n\n### HTTP request\n\n`GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/conversionsources`\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 owns the new conversion source. |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of conversion sources to return in a page. If no `pageSize` is specified, `100` is used as the default value. The maximum value is `200`. Values above `200` will be coerced to `200`. Regardless of pagination, at most `200` conversion sources are returned in total. |\n| `pageToken` | `string` Page token. |\n| `showDeleted` | `boolean` If true, also returns archived conversion sources. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the conversionsources.list method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"conversionSources\": [ { object (/shopping-content/reference/rest/v2.1/conversionsources#ConversionSource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `conversionSources[]` | `object (`[ConversionSource](/shopping-content/reference/rest/v2.1/conversionsources#ConversionSource)`)` List of conversion sources. |\n| `nextPageToken` | `string` Token to be used to fetch the next results page. |\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)."]]