Registro de alterações

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

20/08/2025: adição do método GetReportingIdentitySettings

Adicionamos o método GetReportingIdentitySettings à API Admin v1alpha, que permite recuperar o ReportingIdentitySettings de uma propriedade.

20/08/2025: remoção dos métodos legados do Universal Analytics

Os seguintes métodos legados do Universal Analytics (UA) foram removidos da API Admin v1alpha: SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags e FetchConnectedGa4Property.

12/06/2025: adicionamos métodos de gerenciamento de configuração de sincronização de subpropriedades.

Adicionamos os métodos GetSubpropertySyncConfig, ListSubpropertySyncConfig e UpdateSubpropertySyncConfig para gerenciar recursos SubpropertySyncConfig com a API Admin v1alpha.

16/04/2025: métodos de gerenciamento de anotações de dados de relatórios adicionados

Adição dos métodos CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation e DeleteReportingDataAnnotation para gerenciar recursos ReportingDataAnnotation com a API Admin v1alpha.

Com as anotações, os usuários podem adicionar notas diretamente aos relatórios do Google Analytics. Assim, fica mais fácil registrar eventos, explicar mudanças nos dados ou destacar observações importantes para você e sua equipe.

07/03/2025: descontinuação do parâmetro sharingWithGoogleAnySalesEnabled

O parâmetro sharingWithGoogleAnySalesEnabled do método getDataSharingSettings foi descontinuado e sempre vai retornar false. O campo será removido da API Google Analytics Admin v1beta em junho de 2025.

20/01/2025: adicionamos a retenção de dados do usuário a DataRetentionSettings

Adicionamos o campo userDataRetention a DataRetentionSettings nas APIs Admin v1alpha e v1beta. Use este campo para recuperar ou modificar as configurações de retenção de dados do usuário.

09/09/2024: formulário da pesquisa sobre relatórios de acesso

A documentação do método runAccessReport foi atualizada para incluir um link para o formulário Feedback sobre relatórios de acesso do Google Analytics. Sua opinião é muito importante. Compartilhe suas ideias sobre essa API para nos ajudar a melhorar ainda mais.

Adição dos métodos CreateBigQueryLink, UpdateBigQueryLink e DeleteBigQueryLink para gerenciar recursos BigQueryLink com a API Admin v1alpha.

Adicionamos o campo dataset_location ao recurso BigQueryLink.

Adicionamos as mudanças de vinculação do BigQuery ao histórico de alterações no novo valor BIGQUERY_LINK em ChangeHistoryResourceType.

01/08/2024: mudança interruptiva no método createSubproperty

O método personalizado createSubproperty foi renomeado como provisionSubproperty na API Admin v1alpha para se alinhar às diretrizes de métodos personalizados.

01/08/2024: adicionado gerenciamento de regras de edição de eventos

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, métodos adicionados à API Admin v1alpha.

Um EventEditRule define condições que vão acionar a criação de um evento totalmente novo com base nos critérios correspondentes de um evento de origem. Além disso, um EventEditRule pode definir modificações nos parâmetros do evento de origem.

01/08/2024: mudanças diversas

Adição de create_time ao recurso Audience.

Adicionamos primary ao recurso ChannelGroup para indicar se o grupo de canais é o padrão para relatórios. Apenas um grupo de canais pode ter primary definido como true por vez. Definir primary como true para um grupo de canais define automaticamente primary como false para o grupo de canais principal anterior.

Adicionamos gmp_organization ao recurso Account, que contém o URI de um recurso de organização do Google Marketing Platform se a conta estiver conectada a uma organização do GMP.

06/05/2024: métodos de gerenciamento de eventos principais adicionados

Os recursos e métodos para eventos principais já estão disponíveis.

Modifique a integração da API para usar KeyEvent em vez de ConversionEvent. O uso de ConversionEvent foi descontinuado.

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

Alguns campos do recurso Relatórios de acesso aos dados agora estão disponíveis para todas as propriedades do Google Analytics, tanto para clientes do Standard quanto do 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 aos dados.

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

05/10/2023: as propriedades com modelos de atribuição de primeiro clique, linear, de iminência da conversão e baseado na posição usam a DDA cross-channel por padrão.

A partir de meados de outubro de 2023, os modelos de atribuição de primeiro clique, linear, iminência da conversão e baseado na posição não poderão ser usados com o método UpdateAttributionSettings em todas as propriedades.

Se a sua propriedade estiver configurada para usar um desses modelos, ela será alterada para a atribuição baseada em dados de vários canais. Você ainda terá as opções de usar o último clique cross-channel 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.

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

Com essa funcionalidade, é possível gerenciar a configuração do esquema de valor da conversão da SKAdNetwork para um fluxo do iOS.

2023-09-01: o método UpdateConversionEvent foi adicionado.

Método UpdateConversionEvent adicionado à API Admin v1beta.

01/09/2023: o campo BigQueryLink.enterprise_export_enabled foi renomeado para fresh_daily_export_enabled.

O campo enterprise_export_enabled do recurso BigQueryLink foi renomeado para 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, serão feitas mudanças significativas na versão alfa v1 da API Admin, o que vai afetar a funcionalidade dos métodos properties.getAttributionSettings e properties.updateAttributionSettings.

Os membros da enumeração ReportingAttributionModel serão renomeados da seguinte 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 da seguinte 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.

Adição do campo ads_web_conversion_data_export_scope ao tipo AttributionSettings, que pode ser modificado usando o método UpdateAttributionSettings.

05/06/2023: descontinuação 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 poderá ser usado para configurar propriedades do GA4 com modelos de atribuição de primeiro clique, linear, iminência da conversão e baseado na posição. A partir de setembro de 2023, esses modelos não vão estar mais disponíveis para todas as propriedades.

Consulte o anúncio do produto Google Analytics para mais informações.

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

Com essa funcionalidade, é possível gerenciar vínculos do AdSense com o Analytics de uma propriedade do GA4.

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

O método FetchConnectedGa4Property adicionado à API Admin v1alpha

Com essa funcionalidade, é possível obter informações sobre uma propriedade do GA4 vinculada à sua propriedade do Universal Analytics durante o processo de migração para o GA4.

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

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

Com essa funcionalidade, é possível gerenciar 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.

Adição dos métodos GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup à 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 Google Analytics Data v1.

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

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

Com essa funcionalidade, é possível gerenciar as configurações de medição otimizada de um fluxo de dados da Web de 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 adicionados à API Admin v1alpha.

Com essa funcionalidade, é possível gerenciar as tags de site conectadas e encaminhar o tráfego de uma propriedade do Universal Analytics para uma do Google Analytics 4.

31/03/2023: adicionamos 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 correspondentes properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list e properties.expandedDataSets.get. Essa funcionalidade pode ser usada para gerenciar conjuntos de dados abertos no Google Analytics 360.

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

Com essa funcionalidade, é possível gerenciar as permissões de usuário de uma conta ou propriedade do GA4. Ela deve ser usada em vez de Vinculações de usuário.

A funcionalidade User Links será removida da API Admin v1 Alpha em 1º/6/23

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

Os seguintes métodos foram descontinuados e serão removidos da API Admin v1 alfa em 1º/6/2023:

24/02/2023: adicionamos métodos de gerenciamento de públicos-alvo.

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

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

15/02/2023: adicionamos métodos de desativação do processo de configuração automatizada do GA4.

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

Com essa funcionalidade, é possível gerenciar o status de desativação do processo automatizado de configuração do GA4 para uma propriedade do UA.

O recurso BigQueryLink foi adicionado à versão v1alpha da API, junto com as operações properties.bigQueryLinks.get e properties.bigQueryLinks.list correspondentes.

Com essa funcionalidade, é possível recuperar informações sobre vínculos entre uma propriedade do GA4 e um projeto do BigQuery.

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

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

15/02/2023: mudanças importantes.

15/02/2023: mudanças diversas.

11/08/2022: o método runAccessReport foi adicionado à API Admin v1alpha.

O método properties.runAccessReport foi adicionado à versão v1alpha da API Admin. Ele retorna um relatório personalizado de registros de acesso a dados. O relatório fornece registros de cada vez que um usuário lê dados de relatórios do Google Analytics. Os relatórios de acesso aos 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 Google Analytics Admin foi lançada.

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

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 da Métrica otimizada poderão ser modificadas novamente via API em breve.
  • O campo directRoles do recurso UserLink não é mais compatível com a função predefinedRoles/manage-users. Em vez disso, use a nova função predefinedRoles/admin, que é equivalente à combinação das funções antigas predefinedRoles/edit e predefinedRoles/manage-users. Essa mudança afeta o comportamento dos métodos accounts.userLinks, properties.userLinks e está de acordo com as mudanças no gerenciamento de acesso e restrição de dados introduzidas no Google Analytics.

05/06/2021: recursos adicionados.

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 com base no conjunto especificado de filtros. As causas comuns são atualizações feitas na interface do usuário do Google Analytics, mudanças do suporte ao cliente ou alterações automáticas do sistema do Google Analytics.
  • Métodos de gerenciamento de chaves secretas do Measurement Protocol adicionados em properties.webDataStreams.measurementProtocolSecrets:
    • create Cria um secret do Measurement Protocol.
    • delete Exclui o secret do Measurement Protocol de destino.
    • get Pesquisa por uma única chave secreta do Measurement Protocol.
    • list Retorna as chaves secretas do Measurement Protocol filho na propriedade mãe especificada.
    • patch Atualiza uma chave secreta do Measurement Protocol.
  • Métodos de gerenciamento de eventos de conversão 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 Recupera um único evento de conversão.
    • list Retorna uma lista de eventos de conversão na propriedade mãe especificada.
  • Métodos de gerenciamento de dimensões personalizadas adicionados em properties.customDimensions:
    • archive Arquiva uma dimensão personalizada em uma propriedade.
    • create Cria uma dimensão personalizada.
    • get Pesquisa por 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 adicionados em properties.customMetrics:
    • archive Arquiva uma métrica personalizada em uma propriedade.
    • create Cria uma métrica personalizada.
    • get Pesquisa por uma única métrica personalizada.
    • list Lista as 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 em uma propriedade do Google Analytics 4.
  • delete_time, expire_time campos somente de saída adicionados ao tipo Property.

05/06/2021: mudanças interruptivas.

As seguintes mudanças incompatíveis com versões anteriores foram introduzidas:

  • 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 um tipo Property em vez de uma resposta vazia.
  • O campo time_zone do tipo Property agora é obrigatório.
  • O campo deleted foi 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: mudanças importantes.

Mudanças significativas: - O campo update_mask é obrigatório para todas as operações de atualização.

  • O campo country_code foi renomeado como region_code em Account.

  • O campo url_query_parameter foi renomeado como uri_query_parameter em EnhancedMeasurementSettings.

  • O campo parent foi removido de GoogleAdsLink.

20/10/2020: adicionamos suporte para resumos de contas.

Adição de suporte ao método accountSummaries.

13/10/2020: as propriedades App + Web foram renomeadas para Google Analytics 4 (GA4).

15/08/2020: o app Management e a API Web foram renomeados como API Admin.

A API Management App + Web do Google Analytics mudou de nome e agora é a API Admin do Google Analytics. Como resultado, o endpoint da API mudou para analyticsadmin.googleapis.com. O código escrito na versão anterior do URL do endpoint da API e das bibliotecas de cliente precisa ser atualizado de acordo.