Registro de alterações

Para receber anúncios oficiais sobre as APIs do Google Analytics, inscreva-se no grupo de notificações das APIs do Google Analytics.

18/06/2026: adição do método UpdateReportingIdentitySettings

18/06/2026: adicionado o campo can_edit a PropertySummary

  • Adicionamos o campo can_edit ao recurso PropertySummary nas APIs Admin v1alpha e v1beta. Esse campo indica se o usuário tem uma função do Google Analytics que permite mudar as configurações da propriedade.

2026-04-14: adição do método GetUserProvidedDataSettings

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

Adição do 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: adicionados métodos de gerenciamento de configuração de sincronização de subpropriedades

Adição dos métodos GetSubpropertySyncConfig, ListSubpropertySyncConfig e UpdateSubpropertySyncConfig para gerenciar recursos SubpropertySyncConfig com a API Admin v1alpha.

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

Adicionamos os 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 Admin do Google Analytics v1beta em junho de 2025.

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

Adição do campo userDataRetention a DataRetentionSettings nas APIs Admin v1alpha e v1beta. Use esse 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 mudanças de vinculação do BigQuery ao histórico de alterações no novo valor BIGQUERY_LINK em ChangeHistoryResourceType.

01/08/2024: alteração 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étodo personalizado.

01/08/2024: adição do 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á disponível.

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. Ela contém a data e a hora do usuário do GA que acessou os dados do relatório do GA.

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 cross-channel baseada em dados. Você ainda terá as opções de usar a atribuição de último clique cross-channel ou a atribuição de ú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.

01/09/2023: adicionamos o método UpdateConversionEvent.

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

01/09/2023: o campo BigQueryLink.enterprise_export_enabled 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: alterações interruptivas nos métodos properties.updateAttributionSettings e properties.getAttributionSettings.

A partir de 24 de julho de 2023, alterações interruptivas serão feitas na versão Alfa da API Admin v1, 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, baseada 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 vão ficar indisponí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 foram 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.

Adicionamos os 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 das configurações de medição otimizada.

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

Com essa funcionalidade, é possível gerenciar as Configurações da 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 do site conectadas e encaminhar o tráfego de uma propriedade do Universal Analytics para uma propriedade 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 expandidos no Google Analytics 360.

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

Essa funcionalidade permite gerenciar as permissões de usuário de uma conta ou propriedade do GA4 e deve ser usada em vez de Links de usuários.

A funcionalidade de links de usuários será removida da API Admin v1 alfa 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/23:

24/02/2023: adicionamos métodos de gerenciamento de público-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 e properties.fetchAutomatedGa4ConfigurationOptOut foram adicionadas à versão v1alpha da API.

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

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

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: alterações interruptivas.

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 Admin do Google Analytics 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 na versão Alfa que são considerados estáveis e não devem passar por uma mudança significativa 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 Medição 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 são 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 de filtros especificado. 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.dataStreams.measurementProtocolSecrets:
    • create Cria uma chave secreta do Measurement Protocol.
    • delete Exclui o segredo do Measurement Protocol de destino.
    • get Pesquisa por uma única chave secreta do Measurement Protocol.
    • list Retorna chaves secretas do Measurement Protocol secundárias na propriedade principal 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 de 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: alterações interruptivas.

As seguintes alterações interruptivas 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 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 é apenas para saída.

28/01/2021: alterações interruptivas.

Alterações interruptivas: - 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: foi adicionado suporte para resumos de contas.

Adicionamos suporte ao método resumos da conta.

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 App + Web de gerenciamento do Google Analytics mudou de nome e agora se chama API Admin do Google Analytics. Como resultado, o endpoint de API mudou para analyticsadmin.googleapis.com. O código atual escrito na versão anterior do URL do endpoint de API e das bibliotecas de cliente precisa ser atualizado de acordo.