Registro de alterações

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

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

A documentação da função runAccessReport foi atualizado para incluir um link para o Feedback sobre os relatórios de acesso do Google Analytics forma Valorizamos seu feedback e incentivamos você a compartilhar sua opinião sobre o para nos ajudar a melhorar ainda mais.

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

Adicionamos o campo dataset_location ao recurso BigQueryLink.

Adição de mudanças no link do BigQuery ao histórico de alterações no novo BIGQUERY_LINK valor 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 alinhamento com o método personalizado diretrizes.

01/08/2024 Adição do gerenciamento de regras de edição de eventos

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

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

01/08/2024 Mudanças diversas

create_time foi adicionado ao Audience.

primary foi adicionado ao ChannelGroup para indicar se o grupo de canais é o grupo padrão para relatórios. Só um O grupo de canais pode ter primary definido como true a qualquer momento. Ambiente primary como true em um grupo de canais define automaticamente primary como false para o grupo de canais principal anterior.

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

06/05/2024 Adição de métodos de gerenciamento de eventos principais

Recursos e métodos para chaves eventos já estão disponíveis.

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

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

Determinados campos do recurso Relatórios de acesso a dados estão disponíveis para todas as propriedades do Google Analytics, e 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 de relatório de acesso aos dados. Ela contém a data/hora do usuário do GA que acessou dados de relatórios 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 padronizadas para a DDA de vários canais.

A partir de meados de outubro de 2023, os modelos de primeiro clique, linear, iminência da conversão e com base na posição os modelos de atribuição não estarão disponíveis para uso com UpdateAttributionSettings para todas as propriedades.

Se a propriedade estiver configurada para usar um desses modelos, ele será alterado para atribuição cross-channel baseada em dados. Você ainda terá opções para usar o último clique em vários canais ou com preferência pelo Google Ads clicar no lugar dele.

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 foram adicionados à API Admin v1alpha.

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

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

UpdateConversionEvent foi adicionado à API Admin v1beta.

01/09/2023: 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 Mudanças interruptivas nos métodos properties.updateAttributionSettings e properties.getAttributionSettings.

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

Participantes de ReportingAttributionModel enum será renomeado 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

Participantes de AdsWebConversionDataExportScope enum será renomeado 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.

Adicionamos o campo ads_web_conversion_data_export_scope ao AttributionSettings, que pode ser modificado usando o 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, UpdateAttributionSettings método não pode ser usado para configurar propriedades do GA4 com primeiro clique; linear, iminência da conversão e com base na posição modelos de atribuição. A partir de setembro de 2023, esses modelos vão se tornar indisponível para todas as propriedades.

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

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

Com essa funcionalidade, é possível gerenciar vinculações do AdSense para o Analytics para uma propriedade do GA4.

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

O FetchConnectedGa4Property adicionado à API Admin v1alpha

Essa funcionalidade permite obter informações sobre um A propriedade do GA4 vinculou sua propriedade do Universal Analytics durante o processo de migração para o GA4.

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

Os métodos CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, 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 em e os critérios de um evento de origem.

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

GetChannelGroup adicionado, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup métodos para a 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 o API Google Analytics Data v1.

31/03/2023 Adição de 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 otimizadas de medição para um fluxo de dados da Web de uma propriedade do GA4.

31/03/2023 Adição de 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 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 métodos runAccessReport no nível da conta e da propriedade à API Admin v1beta.

O properties.runAccessReport e accounts.runAccessReport métodos 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 Adição de métodos de gerenciamento de conjuntos de dados expandidos.

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

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

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

A funcionalidade de 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 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úblicos-alvo.

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

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

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

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

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

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

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

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

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

15/02/2023 Mudanças interruptivas.

15/02/2023: diversas mudanças.

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

O properties.runAccessReport foi adicionado à versão v1alpha da API Admin. Ela retorna uma um relatório personalizado de registros de acesso a dados. O relatório fornece registros vez que um usuário lê os dados de relatórios do Google Analytics. Os Relatórios de acesso aos dados sã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 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 na futuro. Novos recursos serão adicionados à versão Beta quando estiverem consolidados.

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

  • properties.webDataStreams.getEnhancedMeasurementSettings, Os métodos properties.webDataStreams.updateEnhancedMeasurementSettings são removido da API, mas a medição otimizada as configurações poderão ser modificadas novamente pela API em breve.
  • O campo directRoles do UserLink recurso não oferece mais suporte ao papel predefinedRoles/manage-users. Em vez disso, use o novo papel predefinedRoles/admin, que é equivalente à combinação das antigas predefinedRoles/edit e predefinedRoles/manage-users. Essa mudança afeta o comportamento accounts.userLinks, properties.userLinks e está de acordo com o Gerenciamento de restrições de dados e acesso alterações 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 alterações feitas em uma conta ou suas filhas de acordo com o conjunto especificado de filtros. Causas comuns seriam atualizações feitas na interface do Google Analytics, alterações de clientes ou alterações automáticas no sistema do Google Analytics.
  • Os métodos de gerenciamento de secrets do Measurement Protocol foram adicionados properties.webDataStreams.measurementProtocolSecrets:
    • create Cria uma chave secreta do Measurement Protocol.
    • delete Exclui a chave secreta do Measurement Protocol de destino.
    • get Pesquisar uma única chave secreta do Measurement Protocol.
    • list Retorna segredos 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 a 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 pai especificada.
  • Os 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 Pesquisar uma única dimensão personalizada.
    • list Lista as dimensões personalizadas em uma propriedade.
    • patch Atualiza uma dimensão personalizada em uma propriedade.
  • Os métodos de gerenciamento de métricas personalizadas foram adicionados properties.customMetrics:
    • archive Arquiva uma métrica personalizada em uma propriedade.
    • create cria uma métrica personalizada.
    • get Pesquisar uma única métrica personalizada.
    • list Lista métricas personalizadas em uma propriedade.
    • patch Atualiza uma métrica personalizada em uma propriedade.
  • properties.getGoogleSignalsSettings adicionado, properties.updateGoogleSignalsSettings métodos que permitem controlar os indicadores do Google para uma propriedade do Google Analytics 4.
  • delete_time, expire_time campos somente de saída adicionados ao Property não é válido.

05/06/2021 Alterações interruptivas.

As seguintes alterações interruptivas foram introduzidas:

  • properties.iosAppDataStreams.create, properties.androidAppDataStreams.create métodos foram removidos da API. Use o Firebase para criar o aplicativo 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 do elemento Property o tipo agora é obrigatório.
  • Campo deleted removido de Property não é válido.
  • email_address do elemento UserLink o tipo agora é imutável.
  • name do elemento UserLink O tipo agora é somente saída.

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.

  • O campo url_query_parameter foi 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 como Google Analytics 4 (GA4).

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

A API Google Analytics Management App + Web foi renomeada como a API Admin do Google Analytics. Como resultado, o endpoint da API mudou para analyticsadmin.googleapis.com. Código existente escrito na versão anterior do URL do endpoint da API e das bibliotecas de cliente precisam ser atualizadas.