Teste o servidor MCP do Google Analytics. Instale no
GitHub e confira o
anúncio para mais detalhes.
REST Resource: properties.googleAdsLinks
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: GoogleAdsLink
Uma vinculação entre uma propriedade do Google Analytics e uma conta do Google Ads.
| Representação JSON |
{
"name": string,
"customerId": string,
"canManageClients": boolean,
"adsPersonalizationEnabled": boolean,
"createTime": string,
"updateTime": string,
"creatorEmailAddress": string
} |
| Campos |
name |
string
Apenas saída. Formato: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Observação: googleAdsLinkId não é o ID de cliente do Google Ads.
|
customerId |
string
Imutável. ID de cliente do Google Ads.
|
canManageClients |
boolean
Apenas saída. Se for o caso, o link é para uma conta de administrador do Google Ads.
|
adsPersonalizationEnabled |
boolean
Ativar recursos de publicidade personalizados com essa integração. Publicar automaticamente minhas listas de público-alvo e os eventos/parâmetros de remarketing do Analytics a serem vinculados à conta do Google Ads. Se esse campo não for definido na criação/atualização, o padrão será "verdadeiro".
|
createTime |
string (Timestamp format)
Apenas saída. Hora em que a vinculação foi criada. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
|
updateTime |
string (Timestamp format)
Apenas saída. Hora em que o link foi atualizado pela última vez. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
|
creatorEmailAddress |
string
Apenas saída. Endereço de e-mail do usuário que criou o link. Uma string vazia será retornada se o endereço de e-mail não puder ser recuperado.
|
Métodos |
|
|
Cria um link do Google Ads. |
|
|
Exclui um GoogleAdsLink de uma propriedade |
|
|
Lista os links do Google Ads em uma propriedade. |
|
|
Atualiza um GoogleAdsLink em uma propriedade |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 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 |"]]
