Try the MCP server for Google Analytics. Install from
GitHub, and see the
announcement for more details.
REST Resource: properties.googleAdsLinks
Stay organized with collections
Save and categorize content based on your preferences.
Resource: GoogleAdsLink
A link between a Google Analytics property and a Google Ads account.
| JSON representation |
{
"name": string,
"customerId": string,
"canManageClients": boolean,
"adsPersonalizationEnabled": boolean,
"createTime": string,
"updateTime": string,
"creatorEmailAddress": string
} |
| Fields |
name |
string
Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID.
|
customerId |
string
Immutable. Google Ads customer ID.
|
canManageClients |
boolean
Output only. If true, this link is for a Google Ads manager account.
|
adsPersonalizationEnabled |
boolean
Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update, it will be defaulted to true.
|
createTime |
string (Timestamp format)
Output only. Time when this link was originally created. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
|
updateTime |
string (Timestamp format)
Output only. Time when this link was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
|
creatorEmailAddress |
string
Output only. Email address of the user that created the link. An empty string will be returned if the email address can't be retrieved.
|
Methods |
|
|
Creates a GoogleAdsLink. |
|
|
Deletes a GoogleAdsLink on a property |
|
|
Lists GoogleAdsLinks on a property. |
|
|
Updates a GoogleAdsLink on a property |
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-04-02 UTC.
[null,null,["Last updated 2025-04-02 UTC."],[[["\u003cp\u003eA GoogleAdsLink connects a Google Analytics 4 property and a Google Ads account, enabling features like personalized advertising and remarketing.\u003c/p\u003e\n"],["\u003cp\u003eGoogleAdsLinks can be managed through the Google Analytics Admin API, allowing for creation, deletion, listing, and updates.\u003c/p\u003e\n"],["\u003cp\u003eKey GoogleAdsLink data includes \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003ecustomerId\u003c/code\u003e, \u003ccode\u003ecanManageClients\u003c/code\u003e, \u003ccode\u003eadsPersonalizationEnabled\u003c/code\u003e, creation and update timestamps, and the creator's email address.\u003c/p\u003e\n"],["\u003cp\u003eThis resource enables data sharing between Google Analytics 4 and Google Ads for enhanced advertising and marketing insights.\u003c/p\u003e\n"]]],["GoogleAdsLink represents a connection between a Google Analytics property and a Google Ads account. Key information includes the link's `name`, `customerId`, creation and update timestamps, and creator's email. It also indicates if it manages a Google Ads manager account and if personalized advertising is enabled. The resource provides methods to `create`, `delete`, `list`, and `patch` (update) GoogleAdsLinks, and a JSON representation is provided for data formatting.\n"],null,["# REST Resource: properties.googleAdsLinks\n\n- [Resource: GoogleAdsLink](#GoogleAdsLink)\n - [JSON representation](#GoogleAdsLink.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: GoogleAdsLink\n-----------------------\n\nA link between a Google Analytics property and a Google Ads account.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"customerId\": string, \"canManageClients\": boolean, \"adsPersonalizationEnabled\": boolean, \"createTime\": string, \"updateTime\": string, \"creatorEmailAddress\": string } ``` |\n\n| Fields ||\n|-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID. |\n| `customerId` | `string` Immutable. Google Ads customer ID. |\n| `canManageClients` | `boolean` Output only. If true, this link is for a Google Ads manager account. |\n| `adsPersonalizationEnabled` | `boolean` Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update, it will be defaulted to true. |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time when this link was originally created. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `updateTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time when this link was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `creatorEmailAddress` | `string` Output only. Email address of the user that created the link. An empty string will be returned if the email address can't be retrieved. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------------------|---------------------------------------|\n| ### [create](/analytics/devguides/config/admin/v1/rest/v1beta/properties.googleAdsLinks/create) | Creates a GoogleAdsLink. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1beta/properties.googleAdsLinks/delete) | Deletes a GoogleAdsLink on a property |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1beta/properties.googleAdsLinks/list) | Lists GoogleAdsLinks on a property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1beta/properties.googleAdsLinks/patch) | Updates a GoogleAdsLink on a property |"]]
