Registro de alterações

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

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

18/06/2026 Adição do campo can_edit a PropertySummary

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

14/04/2026 Adição do método GetUserProvidedDataSettings

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

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

20/08/2025 Remoção de 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 Adição de métodos de gerenciamento de configuração de sincronização de subpropriedades

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

16/04/2025 Adição de métodos de gerenciamento de anotações de dados de relatórios

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. Ficou 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 getDataSharingSettings método foi descontinuado e sempre retornará false. O campo será removido da API Admin do Google Analytics v1beta em junho de 2025.

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

Adicionamos o userDataRetention campo 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 de pesquisa de relatórios de acesso

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

Adicionamos CreateBigQueryLink, UpdateBigQueryLink e DeleteBigQueryLink métodos para gerenciar BigQueryLink recursos 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 BIGQUERY_LINK valor em ChangeHistoryResourceType.

01/08/2024 Mudança importante no método createSubproperty

Renomeamos o método personalizado createSubproperty para provisionSubproperty na API Admin v1alpha para estar em conformidade com as diretrizes de métodos personalizados.

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.

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

01/08/2024 Mudanças diversas

Adicionamos create_time ao Audience recurso.

Adicionamos primary ao ChannelGroup recurso para indicar se o grupo de canais é o padrão para relatórios. Somente um grupo de canais pode ter primary definido como true a qualquer momento. 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 Adição de métodos de gerenciamento de eventos principais

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. ConversionEvent foi descontinuado.

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

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

A dimensão accessDateHour foi 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 linear, baseado na posição, de primeiro clique e de iminência da conversão são definidas como DDA cross-channel por padrão.

A partir de meados de outubro de 2023, os modelos de atribuição primeiro clique, linear, iminência da conversão e baseado na posição não estarão mais 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 a atribuição baseada em dados cross-channel. 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 Adição de 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.

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

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

UpdateConversionEvent método 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 importantes nos métodos properties.updateAttributionSettings e properties.getAttributionSettings.

A partir de 24 de julho de 2023, mudanças importantes serão feitas na API Admin v1 alpha, que afetarão a funcionalidade dos properties.getAttributionSettings, properties.updateAttributionSettings.

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

Nome antigo Novo nome
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10/07/2023 Adição do campo ads_web_conversion_data_export_scope ao tipo AttributionSettings

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

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, de iminência da conversão e baseado na posição. A partir de setembro de 2023, esses modelos não estarão mais disponíveis para todas as propriedades.

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

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

Essa funcionalidade permite gerenciar links do AdSense para o Analytics em uma propriedade do GA4.

31/05/2023 Adição de um método para pesquisar uma propriedade do GA4 conectada.

Adicionamos o FetchConnectedGa4Property método à API Admin v1alpha.

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

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

Adicionamos os métodos CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule à API Admin v1alpha.

Essa funcionalidade permite 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 Adição de métodos para gerenciar grupos de canais personalizados.

Adicionamos os métodos GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup à API Admin v1alpha.

Essa funcionalidade permite 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 de dados do Google Analytics v1.

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

Adicionamos os métodos properties.dataStreams.updateEnhancedMeasurementSettings e properties.dataStreams.getEnhancedMeasurementSettings à API Admin v1alpha.

Essa funcionalidade permite gerenciar as configurações de medição otimizada para um fluxo de dados da Web de uma propriedade do GA4.

31/03/2023 Adição de métodos de gerenciamento de tags do site conectadas.

Adicionamos os métodos properties.createConnectedSiteTag, properties.deleteConnectedSiteTag e properties.listConnectedSiteTags à API Admin v1alpha.

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

31/03/2023 Adição de métodos runAccessReport no nível da conta e da propriedade à API Admin v1beta.

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

24/02/2023 Adição de métodos de gerenciamento de conjuntos de dados expandidos.

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

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

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

A funcionalidade de vinculações de usuário será removida da API Admin v1 alpha em 01/06/2023

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 alpha em 01/06/2023:

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

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

Essa funcionalidade permite gerenciar públicos-alvo para uma propriedade do GA4.

15/02/2023 Adição de 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.

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

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

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

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

Essa funcionalidade permite gerenciar links 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 Adição do método runAccessReport à API Admin v1alpha.

Adicionamos o properties.runAccessReport método à versão v1alpha da API Admin. Ele retorna um relatório personalizado de registros de acesso aos dados. O relatório fornece registros de cada vez que um usuário lê os 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 no Alfa, que são considerados estáveis e não devem passar por mudanças significativas no futuro. Novos recursos serão adicionados ao Beta quando estiverem prontos.

12/10/2021 Métodos EnhancedMeasurementSettings removidos da API.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings métodos 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. Em vez disso, use o novo papel predefinedRoles/admin, que é equivalente à combinação dos papéis antigos predefinedRoles/edit e predefinedRoles/manage-users. Essa mudança afeta o comportamento dos accounts.userLinks, properties.userLinks métodos e está de acordo com as mudanças de gerenciamento de acesso e restrição de dados introduzidas no Google Analytics.

05/06/2021 Recursos adicionados.

Os seguintes recursos foram adicionados à API:

  • accounts.searchChangeHistoryEvents método 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 são atualizações feitas na interface do usuário do Google Analytics, mudanças do suporte ao cliente ou mudanças 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 a chave secreta do Measurement Protocol de destino.
    • get : pesquisa uma única chave secreta do Measurement Protocol.
    • list : retorna chaves secretas do Measurement Protocol filho na propriedade pai 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 pai 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 uma única dimensão personalizada.
    • list : lista 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 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, properties.updateGoogleSignalsSettings , que permitem controlar a configuração dos Indicadores do Google para uma propriedade do Google Analytics 4.
  • delete_time, expire_time campos somente de saída adicionados ao tipo Property.

05/06/2021 Mudanças importantes.

As seguintes mudanças importantes 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.
  • properties.delete método agora retorna os dados da propriedade excluída como Property tipo, em vez de retornar uma resposta vazia.
  • time_zone campo do tipo Property agora é obrigatório.
  • O campo deleted foi removido do Property tipo.
  • email_address campo do tipo UserLink agora é imutável.
  • name campo do tipo UserLink agora é somente saída.

28/01/2021 Mudanças importantes.

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

  • O campo country_code foi renomeado para region_code em Account.

  • O campo url_query_parameter foi renomeado para uri_query_parameter em EnhancedMeasurementSettings.

  • O campo parent foi removido de GoogleAdsLink.

20/10/2020 Adição de suporte a resumos de contas.

Adicionamos suporte ao método de resumos de contas.

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

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

A API Management App + Web do Google Analytics foi renomeada para 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.