试用 Google Analytics 的 MCP 服务器。从
GitHub 安装,并参阅
公告了解详情。
REST Resource: properties.googleAdsLinks
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:GoogleAdsLink
Google Analytics 媒体资源与 Google Ads 账号之间的关联。
JSON 表示法 |
{
"name": string,
"customerId": string,
"canManageClients": boolean,
"adsPersonalizationEnabled": boolean,
"createTime": string,
"updateTime": string,
"creatorEmailAddress": string
} |
字段 |
name |
string
仅限输出。格式:properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} 注意:googleAdsLinkId 不是 Google Ads 客户 ID。
|
customerId |
string
不可变。Google Ads 客户 ID。
|
canManageClients |
boolean
仅限输出。如果为 true,则表示此关联是针对 Google Ads 经理账号。
|
adsPersonalizationEnabled |
boolean
通过此集成启用个性化广告功能。自动将我的 Google Analytics 受众群体名单和 Google Analytics 再营销事件/参数发布到关联的 Google Ads 账号。如果在创建/更新时未设置此字段,则默认为 true。
|
createTime |
string (Timestamp format)
仅限输出。此关联的初始创建时间。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30" 。
|
updateTime |
string (Timestamp format)
仅限输出。此链接上次更新的时间。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30" 。
|
creatorEmailAddress |
string
仅限输出。创建关联的用户的电子邮件地址。如果无法检索到电子邮件地址,则会返回空字符串。
|
方法 |
|
创建 GoogleAdsLink。 |
|
删除媒体资源的 GoogleAdsLink |
|
列出媒体资源的 GoogleAdsLinks。 |
|
更新媒体资源的 GoogleAdsLink |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\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 |"]]