Registro de alterações

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

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

O campo userDataRetention foi adicionado a DataRetentionSettings na API Admin v1alpha e v1beta. Use este campo para recuperar ou modificar as configurações de retenção dos dados do usuário.

2024-09-09 Formulário da pesquisa sobre relatórios de acesso

A documentação do método runAccessReport foi atualizada para incluir um link ao formulário de feedback sobre os relatórios de acesso do Google Analytics. Seu feedback é muito importante para nós. Compartilhe suas ideias sobre essa API para nos ajudar a melhorá-la.

Foram adicionados os métodos CreateBigQueryLink, UpdateBigQueryLink e DeleteBigQueryLink para gerenciar recursos BigQueryLink com a API Admin v1alpha.

Adicionamos o campo dataset_location ao recurso BigQueryLink.

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

2024-08-01 Mudança interruptiva no método createSubproperty

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

2024-08-01 Gerenciamento de regras de edição de eventos adicionado

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 de correspondência de um evento de origem. Além disso, um EventEditRule pode definir modificações dos parâmetros do evento de origem.

2024-08-01 Mudanças diversas

create_time foi adicionado ao recurso Audience.

primary foi adicionado 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 a qualquer momento. A definição de primary como true para um grupo de canais define automaticamente primary como false para o grupo de canais principal anterior.

Adição de 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.

2024-05-06 Foram adicionados métodos de gerenciamento de eventos principais.

Os recursos e métodos para eventos chave 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 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 para clientes do padrão quanto do Google Analytics 360.

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

2023-12-15 A dimensão accessDateHour foi adicionada ao esquema do 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 de relatórios da plataforma.

2023-10-05 As propriedades com modelos de atribuição de primeiro clique, linear, iminência da conversão e baseado na posição têm como padrão a DDA em vários canais.

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

2023-09-01 Foram adicionados 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 da conversão da SKAdNetwork para um stream do iOS.

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

Método UpdateConversionEvent adicionado à API Admin v1beta.

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

O campo enterprise_export_enabled do recurso BigQueryLink foi renomeado para fresh_daily_export_enabled.

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

A partir de 24 de julho de 2023, mudanças importantes 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 do tipo enumerado ReportingAttributionModel serão renomeados da seguinte maneira:

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 do tipo enumerado AdsWebConversionDataExportScope serão renomeados da seguinte maneira:

Nome antigo Novo nome
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

2023-07-10 Foi adicionado 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.

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

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 do Google Analytics para mais informações.

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

Essa funcionalidade permite gerenciar as vinculações do AdSense ao Google Analytics para uma propriedade do GA4.

31/05/2023 Foi adicionado um método para procurar uma propriedade conectada do GA4.

O método FetchConnectedGa4Property foi adicionado à 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.

2023-05-31 Adição de 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 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 Foram adicionados métodos para gerenciar grupos de canais personalizados.

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

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

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

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

31/03/2023 Foram adicionados métodos de gerenciamento da tag do site conectada.

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.

2023-03-31 Foram adicionados 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.

2023-02-24 Foram adicionados 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:

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

A funcionalidade Vinculação 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 Alpha em 1/6/23:

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

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

2023-02-15 Foram adicionados métodos de desativação da 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 recurso BigQueryLink foi adicionado à versão v1alpha da API, junto com as operações correspondentes de properties.bigQueryLinks.get e properties.bigQueryLinks.list.

Essa funcionalidade permite recuperar informações sobre as vinculações 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.

Essa funcionalidade permite gerenciar vinculações entre uma propriedade do GA4 e uma entidade do Search Ads 360.

2023-02-15 Mudanças interruptivas.

2023-02-15 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 mostra registros de cada vez que um usuário lê dados de relatórios 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 Versão v1beta da API Admin lançada.

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

Os canais Alfa e Beta da API continuam com suporte para 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 mudanças significativas no futuro. Os novos recursos serão adicionados à versão Beta quando estiverem prontos.

2021-10-12 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 Avançada vão poder ser modificadas 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 predefinedRoles/edit e predefinedRoles/manage-users antigos. Essa mudança afeta o comportamento dos métodos accounts.userLinks e properties.userLinks e está alinhada às mudanças no gerenciamento de restrição de dados e acesso introduzidas no Google Analytics.

2021-06-05 Recursos adicionados.

Os recursos a seguir foram adicionados à API:

  • O método accounts.searchChangeHistoryEvents foi adicionado à API. Esse método pesquisa todas as mudanças em uma conta ou nas crianças dela com base no conjunto especificado de filtros. As causas comuns são atualizações feitas na interface do Google Analytics, mudanças feitas pelo suporte ao cliente ou mudanças automáticas no sistema do Google Analytics.
  • Os métodos de gerenciamento de chaves secretas do Measurement Protocol foram adicionados em properties.webDataStreams.measurementProtocolSecrets:
    • create Cria um secret do Measurement Protocol.
    • delete Exclui o secret do Measurement Protocol de destino.
    • get Procure uma única chave secreta do Measurement Protocol.
    • list Retorna segredos de protocolo de medição filho na propriedade mãe especificada.
    • patch Atualiza um secret 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 Recupere 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 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 adicionados em properties.customMetrics:
    • archive Arquiva uma métrica personalizada em uma propriedade.
    • create cria uma métrica personalizada.
    • get Procure uma única métrica personalizada.
    • list Lista as métricas personalizadas em uma propriedade.
    • patch Atualiza uma métrica personalizada em uma propriedade.
  • Foram adicionados 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 retorna apenas campos adicionados ao tipo Property.

2021-06-05 Mudanças interruptivas.

As seguintes mudanças incompatíveis foram introduzidas:

  • Os métodos properties.iosAppDataStreams.create e properties.androidAppDataStreams.create foram removidos da API. Use o Firebase para criar fluxos de aplicativo em uma propriedade do Google Analytics 4.
  • O método properties.delete agora retorna os dados da propriedade excluída como o 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.

2021-01-28 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 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.

2020-10-20 Adição de suporte para resumos de contas.

Adição de suporte ao método summaries of accounts.

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

15/08/2020 A API Management e a API Web foram renomeadas para API Admin.

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