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\u003eGoogleAdsLink connects a Google Analytics 4 property with a Google Ads account, enabling personalized advertising and data sharing.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods for creating, deleting, listing, and updating these links.\u003c/p\u003e\n"],["\u003cp\u003eKey properties of a GoogleAdsLink include its name, Google Ads customer ID, manager account status, personalization settings, creation and update timestamps, and creator's email address.\u003c/p\u003e\n"],["\u003cp\u003eGoogleAdsLinks have a JSON representation detailing their properties and values, such as name, customerId, canManageClients, adsPersonalizationEnabled, and timestamps.\u003c/p\u003e\n"]]],["A GoogleAdsLink establishes a connection between a Google Analytics property and a Google Ads account. Key actions include creating, deleting, listing, and updating these links. The JSON representation includes the link's name, customer ID, management permissions, personalization settings, creation and update timestamps, and creator's email. Personalized advertising features can be enabled, automatically publishing Google Analytics audience lists and remarketing data to the linked Google Ads account. The system uses RFC 3339 timestamp 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/v1alpha/properties.googleAdsLinks/create) | Creates a GoogleAdsLink. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.googleAdsLinks/delete) | Deletes a GoogleAdsLink on a property |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.googleAdsLinks/list) | Lists GoogleAdsLinks on a property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.googleAdsLinks/patch) | Updates a GoogleAdsLink on a property |"]]
