The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).
pageToken
string
A page token, received from a previous googleAdsLinks.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to googleAdsLinks.list must match the call that provided the page token.
Request body
The request body must be empty.
Response body
Response message for googleAdsLinks.list RPC.
If successful, the response body contains data with the following structure:
[[["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-04-02 UTC."],[[["\u003cp\u003eLists all Google Ads Links on a specified Google Analytics 4 property.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by page size and supports pagination for retrieving large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e OAuth scopes for authorization.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of Google Ads Links and a token for accessing subsequent pages, if available.\u003c/p\u003e\n"]]],["This document details how to list Google Ads links associated with a Google Analytics property. The core actions involve sending a `GET` request to a specific URL, including the `parent` property ID in the path. Optional query parameters `pageSize` and `pageToken` can be used for pagination. The request body must be empty. The successful response returns a JSON object containing an array of `googleAdsLinks` and an optional `nextPageToken` for retrieving further results. This request also needs authorization scopes.\n"],null,["# Method: properties.googleAdsLinks.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.ListGoogleAdsLinksResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists GoogleAdsLinks on a property.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/googleAdsLinks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------|\n| `parent` | `string` Required. Example format: properties/1234 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum). |\n| `pageToken` | `string` A page token, received from a previous `googleAdsLinks.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `googleAdsLinks.list` must match the 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 googleAdsLinks.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"googleAdsLinks\": [ { object (/analytics/devguides/config/admin/v1/rest/v1beta/properties.googleAdsLinks#GoogleAdsLink) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `googleAdsLinks[]` | `object (`[GoogleAdsLink](/analytics/devguides/config/admin/v1/rest/v1beta/properties.googleAdsLinks#GoogleAdsLink)`)` List of GoogleAdsLinks. |\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/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics.edit`"]]