Registro de alterações

Para receber anúncios oficiais da API Google Analytics, inscreva-se no grupo de notificações da API Google Analytics.

15/12/2023 Os relatórios de acesso a dados já estão disponíveis para todas as propriedades do Google Analytics.

Alguns campos do recurso Relatórios de acesso a dados agora estão disponíveis para todas as propriedades do Google Analytics, tanto clientes padrão quanto do Google Analytics 360.

Consulte a documentação do esquema para mais informações.

15/12/2023 A dimensão accessDateHour foi adicionada ao esquema do relatório de acesso a dados.

A dimensão accessDateHour adicionada ao esquema do relatório de acesso a dados. Ela contém a data e hora do usuário do GA que acessou os dados de relatórios do GA.

05/10/2023 Propriedades com modelos de atribuição linear, baseado na posição, de primeiro clique e de iminência da conversão adotam como padrão a DDA cross-channel.

A partir de meados de outubro de 2023, os modelos de atribuição de primeiro clique, linear, redução de tempo e baseado na posição não vão estar disponíveis para uso com o método UpdateAttributionSettings em todas as propriedades.

Se a sua propriedade estiver configurada para usar um desses modelos, ela será alterada para atribuição baseada em dados de vários canais. Você ainda terá a opção de usar o último clique em vários canais ou o último clique preferencial do Google Ads.

01/09/2023 Adicionamos métodos de configuração do esquema de valor da conversão da SKAdNetwork.

Os métodos GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema e ListSKAdNetworkConversionValueSchemas foram adicionados à API Admin v1alpha.

Essa funcionalidade permite gerenciar a configuração do esquema de valor de conversão da SKAdNetwork para um fluxo do iOS.

01/09/2023 Adição do método UpdateConversionEvent.

O método UpdateConversionEvent foi adicionado à API Admin v1beta.

O campo BigQueryLink.enterprise_export_enabled 2023-09-01 foi renomeado como fresh_daily_export_enabled.

O campo enterprise_export_enabled do recurso BigQueryLink foi renomeado como fresh_daily_export_enabled.

14/07/2023 Mudanças interruptivas nos métodos properties.updateAttributionSettings e properties.getAttributionSettings.

A partir de 24 de julho de 2023, mudanças interruptivas serão feitas na API Admin v1 Alfa, o que vai afetar a funcionalidade dos métodos properties.getAttributionSettings e properties.updateAttributionSettings.

Os membros da enumeração ReportingAttributionModel serão renomeados desta forma:

Nome antigo	Novo nome
CROSS_CHANNEL_DATA_DRIVEN	PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK	PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK	PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR	PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED	PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY	PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK	GOOGLE_PAID_CHANNELS_LAST_CLICK

Os membros da enumeração AdsWebConversionDataExportScope serão renomeados desta forma:

Nome antigo	Novo nome
CROSS_CHANNEL	PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED	GOOGLE_PAID_CHANNELS

10/07/2023 Adicionamos o campo ads_web_conversion_data_export_scope ao tipo AttributionSettings

O campo ads_web_conversion_data_export_scope foi adicionado ao tipo AttributionSettings, que pode ser modificado usando o método UpdateAttributionSettings.

05/06/2023 Suspensão de uso dos modelos de atribuição linear, baseado na posição, de primeiro clique e de iminência da conversão.

A partir de junho de 2023, o método UpdateAttributionSettings não vai poder ser usado para configurar propriedades do GA4 com modelos de atribuição de primeiro clique, linear, redução de tempo e baseado na posição. A partir de setembro de 2023, esses modelos ficarão indisponíveis para todas as propriedades.

Consulte o comunicado sobre o produto Google Analytics para mais informações.

31/05/2023 Adicionamos métodos de gerenciamento de vinculações do Google AdSense.

Os métodos GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink e ListAdSenseLinks foram adicionados à API Admin v1alpha.

Com essa funcionalidade, é possível gerenciar as vinculações do Google AdSense ao Google Analytics em uma propriedade do GA4.

31/05/2023 Adicionamos um método para pesquisar uma propriedade do GA4 conectada.

O método FetchConnectedGa4Property foi adicionado à API Admin v1alpha.

Essa funcionalidade permite acessar informações sobre uma propriedade do GA4 vinculada à sua propriedade do Universal Analytics durante o processo de migração do GA4.

31/05/2023 Adicionamos um método para gerenciar regras de criação de eventos.

Os métodos CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules e GetEventCreateRule foram adicionados à API Admin v1alpha.

Essa funcionalidade permite gerenciar as regras de criação de eventos que podem acionar a criação de um evento totalmente novo com base nos critérios correspondentes de um evento de origem.

31/05/2023 Adicionamos métodos para gerenciar grupos de canais personalizados.

Os métodos GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup e DeleteChannelGroup foram adicionados à API Admin v1alpha.

Com essa funcionalidade, é possível gerenciar grupos de canais personalizados para as origens de tráfego do seu site.

Depois de criados, os grupos de canais personalizados podem ser consultados usando a API Data v1 do Google Analytics.

31/03/2023 Adicionamos métodos de gerenciamento de configurações de medição otimizada.

Os métodos properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings foram adicionados à API Admin v1alpha.

Com essa funcionalidade, é possível gerenciar as configurações de medição otimizada de um fluxo de dados da Web em uma propriedade do GA4.

31/03/2023 Adicionamos métodos de gerenciamento de tags do site conectadas.

Os métodos properties.createConnectedSiteTag, properties.deleteConnectedSiteTag e properties.listConnectedSiteTags foram adicionados à API Admin v1alpha.

Essa funcionalidade permite gerenciar as tags do site conectadas e é útil para encaminhar o tráfego de uma propriedade do Universal Analytics para uma do Google Analytics 4.

31/03/2023 Adicionamos os métodos runAccessReport no nível da conta e da propriedade à API Admin v1beta.

Os métodos properties.runAccessReport e accounts.runAccessReport foram adicionados à versão v1beta da API Admin. Os métodos retornam um relatório personalizado de registros de acesso a dados.

24/02/2023 Adicionamos métodos de gerenciamento de conjuntos de dados expandidos.

O recurso ExpandedDataSet foi adicionado à versão v1alpha da API, junto com as operações properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get. Essa funcionalidade pode ser usada para gerenciar conjuntos de dados abertos no Google Analytics 360.

24/02/2023 As vinculações de acesso estão substituindo os links do usuário para o gerenciamento de permissões do usuário.

O recurso AccessBinding foi adicionado à versão v1alpha da API, com as seguintes operações:

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

Essa funcionalidade permite gerenciar as permissões do usuário em uma conta ou propriedade do GA4 e deve ser usada no lugar dos links do usuário.

A funcionalidade Links do usuário será removida da API Admin v1 Alfa em 01/06/23

24/02/2023 Descontinuação dos métodos de auditoria de permissões do usuário.

Os métodos a seguir foram descontinuados e serão removidos da versão Alfa da API Admin v1 em 01/06/23:

• accounts.userLinks.audit
• properties.userLinks.audit

24/02/2023 Adição de métodos de gerenciamento de públicos-alvo.

O recurso Audience foi adicionado à versão v1alpha da API, junto com as operações properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get.

Com essa funcionalidade, é possível gerenciar públicos-alvo em uma propriedade do GA4.

15/02/2023 Adicionamos métodos automáticos de recusa do processo de configuração do GA4.

As operações properties.setAutomatedGa4ConfigurationOptOut e properties.fetchAutomatedGa4ConfigurationOptOut foram adicionadas à versão v1alpha da API.

Essa funcionalidade permite gerenciar o status de desativação do processo de configuração automatizado do GA4 para uma propriedade do UA.

15/02/2023 Foram adicionados métodos de gerenciamento de vinculações do BigQuery.

O recurso BigQueryLink foi adicionado à versão v1alpha da API, além das operações properties.bigQueryLinks.get properties.bigQueryLinks.list correspondentes.

Essa funcionalidade permite recuperar informações sobre vinculações entre uma propriedade do GA4 e um projeto do BigQuery.

15/02/2023 Adicionamos os métodos de gerenciamento de vinculações do Search Ads 360.

O recurso SearchAds360Link foi adicionado à versão v1alpha da API, junto com as operações properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get.

Com essa funcionalidade, é possível gerenciar vinculações entre uma propriedade do GA4 e uma entidade do Search Ads 360.

15/02/2023 Mudanças interruptivas.

• Valores LESS_THAN_OR_EQUAL e GREATER_THAN_OR_EQUAL removidos do tipo enumerado NumericFilter.Operation.

• Remoção do valor PARTIAL_REGEXP do enum StringFilter.MatchType.

15/02/2023: mudanças diversas.

• Campo tokensPerProjectPerHour adicionado ao tipo AccessQuota.
• Valores EXPANDED_DATA_SET e CHANNEL_GROUP adicionados ao enum ChangeHistoryResourceType.
• Valores searchAds360Link, expandedDataSet, bigqueryLink adicionados a ChangeHistoryResource.

O método runAccessReport 2022-08-11 foi adicionado à API Admin v1alpha.

O método properties.runAccessReport foi adicionado à versão v1alpha da API Admin. Ela retorna um relatório personalizado dos registros de acesso a dados. O relatório fornece registros de cada vez que um usuário lê os dados de relatório do Google Analytics. Os relatórios de acesso a dados estão disponíveis para administradores de propriedades do Google Analytics 360.

11-07-2022: lançamento da versão v1beta da API Admin.

A versão v1beta da API Admin do Google Analytics foi lançada.

Os canais Alfa e Beta da API continuam a ser compatíveis com a API Admin. O canal Beta contém um subconjunto dos recursos disponíveis na versão Alfa, que são considerados estáveis e não vão passar por mudanças significativas no futuro. Novos recursos serão adicionados à versão Beta assim que estiverem consolidados.

12/10/2021 Os métodos EnhancedMeasurementSettings foram removidos da API.

• Os métodos properties.webDataStreams.getEnhancedMeasurementSettings e properties.webDataStreams.updateEnhancedMeasurementSettings foram removidos da API, mas as configurações de medição otimizada poderão ser modificadas novamente pela API em breve.
• O campo directRoles do recurso UserLink não oferece mais suporte ao papel predefinedRoles/manage-users. O novo papel predefinedRoles/admin precisa ser usado, o que é equivalente à combinação dos papéis predefinedRoles/edit e predefinedRoles/manage-users antigos. Essa mudança afeta o comportamento dos métodos accounts.userLinks e properties.userLinks e está de acordo com as mudanças no gerenciamento de restrição de dados e acesso introduzidas no Google Analytics.

05/06/2021 Adicionamos recursos.

Os seguintes recursos foram adicionados à API:

• O método accounts.searchChangeHistoryEvents foi adicionado à API. Esse método pesquisa todas as mudanças em uma conta ou nos filhos dela, considerando o conjunto de filtros especificado. As causas comuns seriam atualizações feitas na IU do Google Analytics, alterações do suporte ao cliente ou alterações automáticas do sistema do Google Analytics.
• Métodos de gerenciamento de secrets do Measurement Protocol foram adicionados em properties.webDataStreams.measurementProtocolSecrets:
  • create Cria uma chave secreta do Measurement Protocol.
  • delete Exclui a chave secreta do Measurement Protocol de destino.
  • get Procure uma única chave secreta do Measurement Protocol.
  • list Retorna chaves secretas do Measurement Protocol filhas na propriedade pai especificada.
  • patch Atualiza uma chave secreta do Measurement Protocol.
• Os métodos de gerenciamento de eventos de conversão foram adicionados em properties.conversionEvents:
  • create Cria um evento de conversão com os atributos especificados.
  • delete Exclui um evento de conversão em uma propriedade.
  • get Recuperar um único evento de conversão.
  • list Retorna uma lista de eventos de conversão na propriedade pai especificada.
• Métodos de gerenciamento de dimensões personalizadas foram adicionados em properties.customDimensions:
  • archive Arquiva uma dimensão personalizada em uma propriedade.
  • create Cria uma dimensão personalizada.
  • get Procure uma única dimensão personalizada.
  • list Lista as dimensões personalizadas em uma propriedade.
  • patch Atualiza uma dimensão personalizada em uma propriedade.
• Métodos de gerenciamento de métricas personalizadas foram adicionados em properties.customMetrics:
  • archive Arquiva uma métrica personalizada em uma propriedade.
  • create relaciona uma métrica personalizada.
  • get Procure uma única métrica personalizada.
  • list Lista métricas personalizadas em uma propriedade.
  • patch Atualiza uma métrica personalizada em uma propriedade.
• Adicionamos os métodos properties.getGoogleSignalsSettings e properties.updateGoogleSignalsSettings, que permitem controlar a configuração dos Indicadores do Google para uma propriedade do Google Analytics 4.
• Campos somente para saída delete_time e expire_time adicionados ao tipo Property.

05/06/2021 Mudanças interruptivas.

Foram introduzidas as seguintes alterações interruptivas:

• Os métodos properties.iosAppDataStreams.create e properties.androidAppDataStreams.create foram removidos da API. Use o Firebase para criar fluxos de aplicativos em uma propriedade do Google Analytics 4.
• O método properties.delete agora retorna os dados da propriedade excluída como do tipo Property em vez de retornar uma resposta vazia.
• O campo time_zone do tipo Property agora é obrigatório.
• Campo deleted removido do tipo Property.
• O campo email_address do tipo UserLink agora é imutável.
• O campo name do tipo UserLink agora é somente saída.

28/01/2021: suporte à paginação adicionado para a operação ListFirebaseLinks.

28/01/2021 Mudanças interruptivas.

Alterações interruptivas: o campo update_mask é obrigatório para todas as operações de atualização.

• Campo country_code renomeado como region_code em Account.

• Campo url_query_parameter renomeado como uri_query_parameter em EnhancedMeasurementSettings.

• Campo de parent removido de GoogleAdsLink.

20/10/2020 Agora é possível usar resumos da conta.

Agora é possível usar o método resumos da conta.

13/10/2020 Propriedades App + Web renomeadas para Google Analytics 4 (GA4).

15/08/2020 A API Management App + Web foi renomeada como API Admin.

A API Google Analytics Management App + Web foi renomeada como API Admin do Google Analytics. Como resultado, o endpoint da API mudou para analyticsadmin.googleapis.com. O código existente gravado na versão anterior do URL do endpoint da API e das bibliotecas de cliente precisa ser atualizado corretamente.