Atualizamos a API de gerenciamento do Google Analytics periodicamente para oferecer novos recursos e corrigir falhas descobertas nas versões anteriores. Na maioria dos casos, essas alterações ficam evidentes para os desenvolvedores de API. No entanto, às vezes, precisamos fazer alterações que exigem que os desenvolvedores modifiquem os aplicativos existentes.
Esta página documenta todas as alterações feitas na API de gerenciamento do Google Analytics que podem afetar seu aplicativo. Recomendamos que os desenvolvedores de API consultem regularmente esta lista para se manterem informados sobre novos comunicados. Você também pode se inscrever para receber as alterações por meio dos feeds listados na seção Inscrever-se abaixo.
Inscrever-se nos registros de alterações relacionados
Inclui todas as APIs de coleta, configuração e relatórios.
Inclui a API de gerenciamento e a API de aprovisionamento.
Versão de 17/07/2018 (17 de julho de 2018)
Adição do método hashClientId à API Management
O método hashClientId fornece o hash do ID do cliente informado, que está disponível em alguns formatos de dados exportados, como nas informações do Google Analytics transferidas para o BigQuery.
Versão de 11/05/2018 (11 de maio de 2018)
Configurações de retenção de dados do usuário na API Management
Agora é possível definir programaticamente as configurações de retenção de dados do usuário usando os novos campos "dataRetentionTtl" e "dataRetentionResetOnNewActivity" no recurso WebProperty.
Versão de 22 de fevereiro de 2018
Operações de gravação na API Management
As operações de gravação na API Management (por exemplo, "create", "update", "delete", "patch") para os recursos de propriedade da Web, vista (perfil) e meta não exigem mais autorização. O limite diário padrão para todas as operações desse tipo na API Management é de 50 gravações. Consulte a página Limites e cotas para mais informações.
Versão de 19/04/2017 (19 de abril de 2017)
Público-alvo de remarketing – Suporte do Optimize
Nesta versão, adicionamos suporte ao Google Optimize, OPTIMIZE
como um tipo de conta de publicidade vinculada. Consulte a documentação Referência de públicos-alvo de remarketing e o guia para desenvolvedores relacionado e veja mais detalhes.
Versão de 23/03/2017 (23 de março de 2017)
Público-alvo de remarketing
Nesta versão, adicionamos o verbo DELETE
aos públicos-alvo de remarketing. Consulte o guia para desenvolvedores sobre públicos-alvo de remarketing se quiser mais detalhes.
- Público-alvo de remarketing: delete – exclui um público-alvo de remarketing.
Versão de 09/02/2017 (9 de fevereiro de 2017)
Métricas personalizadas
Nesta versão, corrigimos o bug que causava uma falha na criação de métricas personalizadas do tipo TIME
quando min_value
não era definido. As solicitações sem min_value
agora geram uma métrica personalizada com um min_value
padrão igual a 0.
Versão de 09/08/2016 (9 de agosto de 2016)
Moedas
Nesta versão, corrigimos um bug em que um subconjunto de moedas era aceito na interface da Web do Google Analytics, mas não na API. Adicionamos suporte às seguintes moedas:
- UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL
Para mais informações, consulte a referência de vistas (perfis) ou o artigo Referência de moeda da Central de Ajuda.
Versão de 08/08/2016 (8 de agosto de 2016)
Nesta versão, adicionamos os públicos-alvo de remarketing à API Management.
Públicos-alvo de remarketing
A API Management permite realizar as ações create
, get
, list
, update
e patch
em públicos-alvo de remarketing de uma propriedade do Google Analytics. Consulte o artigo Sobre os públicos-alvo de remarketing no Google Analytics da Central de Ajuda para entender como eles funcionam.
Versão de 11/03/2016 (11 de março de 2016)
Marcação com estrela
Nesta versão, adicionamos a propriedade starred
a resumos da conta, propriedades da Web, contas e vistas (perfis).
Versão de 25/02/2016 (25 de fevereiro de 2016)
Limitação da taxa de erros
Nossa política sempre permitiu que os desenvolvedores implementassem uma espera exponencial ao lidar com respostas 500 ou 503. Hoje, lançamos um limite de taxa nos erros 500 e 503 para aplicar essa política.
- 50 solicitações de gravação com falha por hora.
Versão de 1o de fevereiro de 2016
Relatórios sem dados de amostra
A API Unsampled Reports não tem mais um limite de 100 relatórios por dia. A API usa o mesmo sistema de token por propriedade e por dia que a interface da Web utiliza para criar um relatório sem dados de amostra.
Versão de 26 de janeiro de 2016
Relatórios sem dados de amostra
Os relatórios sem dados de amostra que não são acessíveis ao usuário atual não terão mais um link de download na mensagem de resposta da API Management. Isso é condizente com o painel de IU, em que apenas os proprietários dos relatórios podem conferir o link de download do documento gerado.
Versão de 17/12/2015 (17 de dezembro de 2015)
Vistas (perfis)
Nesta versão, adicionamos a propriedade botFilteringEnabled
às vistas (perfis). Essa propriedade indica se a filtragem de bots está ativada para uma vista (perfil). Consulte a documentação Referência das vistas (perfis) para mais detalhes.
Relatórios sem dados de amostra
Nesta versão, adicionamos o método delete
aos relatórios sem dados de amostra. Consulte a documentação de referência sobre como excluir esses relatórios para mais detalhes.
Versão de 17/11/2015 (17 de novembro de 2015)
Segmentos
Nesta versão, corrigimos um bug em que os segmentos com valores de moeda na definição apareciam incorretamente ao chamar o método da lista de segmentos.
Versão de 06/10/2015 (6 de outubro de 2015)
Segmentos
Nesta versão, corrigimos um bug em que os usuários com segmentos privados fixados em várias vistas (perfis) recebiam uma resposta de erro 500
ao chamar o método da lista de segmentos.
Versão de 3 de setembro de 2015
Agrupar chamadas
Nesta versão, além do suporte geral a lotes, adicionamos compatibilidade especial à API User Permissions. As solicitações de permissões de usuário em lote terão melhorias significativas de performance e redução no uso de cota.
Versão de 6 de agosto de 2015
Vistas (perfis)
Com essa versão, a propriedade currency
da vista (perfil) vai passar a usar USD se esse valor não for definido durante uma operação insert. Além disso, as operações get
e list
retornarão USD em vistas (perfis) que foram criadas anteriormente sem uma propriedade currency
.
-
Consulte o guia para desenvolvedores sobre vistas (perfis) se quiser mais detalhes sobre como usar esse recurso na API Management.
-
Consulte a referência de vistas (perfis) para conferir todos os parâmetros desse recurso.
Versão de 28/05/2015 (28 de maio de 2015)
Filtros
Nesta versão, removemos os campos de filtro descontinuados IS_MOBILE
e IS_TABLET
, que serão substituídos por DEVICE_CATEGORY=mobile
e DEVICE_CATEGORY=tablet
. Solicitações de inserção, atualização e correção que usarem IS_MOBILE
e IS_TABLET
nos campos de filtro vão retornar um erro.
-
Consulte o guia do desenvolvedor sobre filtros para ver como usar esse recurso na API Management.
-
Consulte a Referência de filtros para ver todos os parâmetros desse recurso.
Versão de 05/05/2015 (5 de maio de 2015)
Filtros
Nesta versão, adicionamos suporte para uso de uma dimensão personalizada em um campo de filtro ao incluir uma propriedade fieldIndex
em todas as seções de detalhes dele. Por exemplo, agora é possível definir a expressão com "field": "CUSTOM_DIMENSION"
e "fieldIndex": "1"
para que o filtro funcione na primeira dimensão personalizada.
-
Consulte o guia do desenvolvedor sobre filtros para ver como usar esse recurso na API Management.
-
Consulte a Referência de filtros para ver todos os parâmetros desse recurso.
Metas
Nesta versão, também corrigimos uma falha que aparecia ao criar uma meta com "comparisonValue": "0"
.
-
Consulte o guia do desenvolvedor sobre metas para ver como usar esse recurso na API Management.
-
Consulte a referência de metas para ver todos os parâmetros desse recurso.
Versão de 13/03/2015 (13 de março de 2015)
Nesta versão, removemos o recurso dailyUpload
. O dailyUpload
foi oficialmente descontinuado em 20 de junho de 2014. Agora a importação de dados de custo deve ser feita com o recurso de uploads.
- Consulte a política de descontinuação de dados para ver detalhes sobre esse processo na API Google Analytics.
- Consulte o guia do desenvolvedor sobre importação de dados para saber como usar esse recurso no Google Analytics.
Versão de 23 de janeiro de 2015
Nesta versão, adicionamos dois novos conjuntos à API Management: dimensões personalizadas e métricas personalizadas.
Dimensões e métricas personalizadas
Agora é possível criar, listar, receber, corrigir e atualizar dimensões e métricas personalizadas com a API Management.
Versão de 08/01/2015 (8 de janeiro de 2015)
A resposta do método list
para todas as coletas agora inclui uma lista vazia para a propriedade items
quando a coleta não contém recursos. Anteriormente, a propriedade items
seria omitida. Consulte a Referência da API para ver detalhes sobre consultas e respostas dos dados de configuração do Google Analytics.
Versão de 16/12/2014 (16 de dezembro de 2014)
Correções de bugs
- Corrigimos o Issue 467 (em inglês). Agora, a coleta de segmentos retorna segmentos que usam a sintaxe
dateOfSession
.
Versão de 20/11/2014 (20 de novembro de 2014)
Nesta versão, adicionamos um novo escopo à API Google Analytics Management. analytics.manage.users.readonly
– confira as permissões de usuários do Google Analytics.
Versão de 05/11/2014 (5 de novembro de 2014)
Adicionamos um novo campo de filtros DEVICE_CATEGORY
, e IS_MOBILE
e IS_TABLET
foram descontinuados. Use DEVICE_CATEGORY=mobile
e DEVICE_CATEGORY=tablet
.
Versão de 29/10/2014 (29 de outubro de 2014)
As vistas (perfis) agora incluem uma propriedade enhancedECommerceTracking
que indica se o e-commerce avançado está ativado (true
) ou desativado (false
).
Versão de 20 de junho de 2014
Nesta versão, incluímos novos tipos de importação de dados e removemos o recurso dailyUpload
.
Importação de dados
Consulte o guia para desenvolvedores sobre a importação de dados e saiba como usar a API Management se quiser importar dados para sua conta do Google Analytics.
Envios
- O recurso
upload
agora aceita os seguintes tipos de upload:- Dados da campanha
- Dados de conteúdo
- Dados de custo
- Dados do produto
- Dados de reembolso
- Dados do usuário
- O recurso
upload
tem um novo métodomigrateDataImport
para migrar ascustomDataSources
dos dados de custo.
Descontinuação dos uploads diários
- O recurso
dailyUpload
foi descontinuado. Consulte o guia de migração para detalhes sobre como usar a importação de dados. - O recurso
dailyUpload
vai continuar funcionando por mais seis meses. Depois disso, ascustomDataSources
que ainda tiverem a propriedadeuploadType
definida comoanalytics#dailyUploads
serão migradas automaticamente e só vão funcionar com o recursoupload
. - Os usuários de
dailyUpload
têm que atualizar o código e migrar para o recurso de upload o quanto antes.
Versão de 28 de maio de 2014
Nesta versão, adicionamos duas novas APIs de configuração.
Links do Google AdWords
-
Essas vinculações na API Management permitem criar, listar, receber, atualizar, corrigir e excluir vínculos entre contas do Google AdWords e propriedades do Analytics e gerenciar quais vistas (perfis) estão associadas aos dados do AdWords.
Filtros
-
Os filtros na API Management permitem criar, listar, receber, atualizar, corrigir e excluir filtros na sua conta do Google Analytics. Com as vinculações de filtros do perfil, você pode criar, listar, receber, atualizar, corrigir e excluir vínculos entre filtros e vistas (perfis).
Versão de 27/05/2014 (27 de maio de 2014)
Relatórios sem dados de amostra: API Management
Adicionamos um novo recurso à API Management, chamado relatórios sem dados de amostra. Eles são relatórios do Google Analytics (GA) que foram gerados sem dados de amostra e,no momento, estão disponíveis apenas para usuários do GA Premium.
- Consulte o guia do desenvolvedor.
Versão de 11 de abril de 2014
Segmentos: API Management v2.4 e v3.0
As seguintes mudanças foram feitas no conjunto de segmentos:
- Os segmentos de usuário e de sequência agora são compatíveis com a API.
- O conjunto de segmentos agora retorna todos os segmentos no nível da sessão e do usuário integrados e personalizados.
- Agora a propriedade
definition
dos segmentos usará a sintaxe dos novos segmentos. Isso inclui as definições dos segmentos no nível da sessão, que vão mudar dedefinition: "
para" definition: "sessions::condition::
." - Uma nova propriedade
type
foi adicionada ao segmento para indicar se ele éCUSTOM
(criado por um usuário na interface da Web) ouBUILT_IN
(fornecido pelo Google Analytics).
Experimentos
As seguintes métricas do Google AdSense agora podem ser usadas como objetivos de otimização:
ga:adsenseAdsClicks
– Número de cliques nos anúncios do Google AdSense no seu site.ga:adsenseAdsViewed
– Número de anúncios do Google AdSense visualizados. Vários anúncios podem ser exibidos em um bloco.ga:adsenseRevenue
– receita total dos anúncios do Google AdSense.
Versão de 25/03/2014 (25 de março de 2014)
Novo conjunto de resumos de contas
- O conjunto AccountSummaries foi adicionado à API Management. Ele mostra um resumo das informações de cada conta, propriedade e vista (perfil) a que um usuário autorizado tem acesso em uma solicitação única e rápida. Consulte o guia para desenvolvedores sobre resumos da conta se quiser mais detalhes.
Versão de 12/12/2013 (12 de dezembro de 2013)
As seguintes mudanças foram feitas nos segmentos padrão por conta da descontinuação das dimensões ga:isMobile
e ga:isTablet
:
- O segmento
gaid::-11
foi renomeado de Tráfego proveniente de dispositivos móveis para Tráfego de tablet e de dispositivos móveis. A definição dele foi alterada dega:isMobile==Yes
paraga:deviceCategory==mobile,ga:deviceCategory==tablet
.ga:isMobile
incluía o tráfego de tablets, e isso é refletido na nova definição. Se você quiser apenas o tráfego de smartphones, e não de tablets, mude para o novo segmento Tráfego proveniente de dispositivos móveis (gaid::-14
). - A definição do segmento
gaid::-13
foi alterada dega:isTablet==Yes
paraga:deviceCategory==tablet
. Ela continua a representar o tráfego de tablets. - Adicionamos o segmento
gaid::-14
. O nome do segmento é Tráfego proveniente de dispositivos móveis, e a definição éga:deviceCategory==mobile
.
Versão de 28/10/2013 (28 de outubro de 2013)
Correções de bugs:
- Corrigimos as informações sobre fuso horário das vistas (perfis). Detalhes: antes dessa correção, em determinados casos, informações de fuso horário incorretas eram retornadas ao listar a vista (perfil) na API Management. Agora esses dados são consistentes com as definições na interface de administração do Google Analytics.
Versão de 04/10/2013 (4 de outubro de 2013)
Uploads (ampliação das dimensões)
- O novo recurso de uploads permite o envio de dados de ampliação das dimensões. Consulte o guia para desenvolvedores sobre importação de dados (uploads) se quiser mais detalhes.
Versão de 03/10/2013 (3 de outubro de 2013)
Nesta versão, adicionamos operações de gravação aos recursos de propriedade da Web, vista (perfil) e meta, além de um conjunto de três novos recursos que permitem o gerenciamento de permissões do usuário.
Configuração da conta e APIs relacionadas
- Agora é possível criar, atualizar, corrigir e excluir vistas (perfis). Consulte a referência das vistas (perfis) para mais detalhes sobre os novos métodos.
- Agora é possível criar, atualizar e corrigir propriedades da Web e metas. Leia a referência das propriedades da Web e a referência das metas para mais detalhes sobre os novos métodos.
- Agora é possível solicitar uma única propriedade da Web, vista (perfil) ou meta com o método
get
. - No momento, esses recursos estão disponíveis como Visualização do desenvolvedor na versão Beta limitada. Se você quiser usá-los, solicite acesso.
Permissões de usuário na API Management
- O novo recurso accountUserLinks permite que os usuários gerenciem as permissões da conta.
- Com o novo recurso webpropertyUserLinks, os usuários podem gerenciar as permissões da propriedade.
- O novo recurso profileUserLinks permite que os usuários gerenciem as permissões da vista (perfil).
- Agora as permissões para um usuário autorizado estão disponíveis como parte dos recursos de conta, propriedade da Web e vista (perfil).
- Adicionamos um novo escopo necessário para gerenciar as permissões de usuário.
https://www.googleapis.com/auth/analytics.manage.users
. - Consulte o guia para desenvolvedores sobre o assunto se quiser mais detalhes.
Versão de 16/07/2013 (16 de julho de 2013)
Além dos novos segmentos, lançaremos estas mudanças no conjunto de segmentos:
- Todos os códigos de segmento serão alterados de strings inteiras positivas para strings alfanuméricas. Se você salvou os IDs de segmento do usuário, recomendamos atualizar para os novos códigos.
- O conjunto de segmentos só vai retornar os segmentos no nível da visita. No momento, os novos segmentos de visitante, coorte e sequência não são compatíveis com a API.
- O conjunto vai continuar retornando os segmentos padrão atuais com os mesmos IDs numéricos negativos, mas os novos segmentos padrão ainda não são aceitos.
Versão de 05/06/2013 (5 de junho de 2013)
Nesta versão, adicionamos duas novas propriedades ao recurso de propriedade da Web:
profileCount
– Retorna a contagem do perfil de uma propriedade. Isso permite que você filtre propriedades sem perfil (ou seja, profileCount = 0).industryVertical
– retorna a categoria/segmento do setor selecionado para uma propriedade.
Correções de bugs:
- A propriedade
eCommerceTracking
do recurso de perfil agora condiz com as configurações de e-commerce na seção "Administrador" da interface da Web. Retornatrue
quando o acompanhamento de e-commerce está ativado efalse
quando não está.
Versão de 08/05/2013 (8 de maio de 2013)
- O recurso de propriedade da Web agora inclui
level
para indicar se a propriedade da Web éPREMIUM
ouSTANDARD
.
Versão de 04/04/2013 (4 de abril de 2013)
- Adicionamos um novo endpoint à API Management v3 para acessar e modificar os experimentos.
Versão de 14 de janeiro de 2013
- O recurso de perfil agora inclui uma propriedade
type
que identifica se um perfil está configurado para um site ou app. Os valores possíveis sãoWEB
ouAPP
.
Versão de 26 de janeiro de 2012
Nesta versão, adicionamos respostas de erros úteis à API Management.
Versão de 5 de dezembro de 2011
Nesta versão, adicionamos dados, alteramos a funcionalidade existente e corrigimos um bug.
Novos dados
- O conjunto de segmentos avançados agora contém um campo
segmentId
que pode ser usado no parâmetro segment da API Data Export.
Mudou
-
O tipo de dados de
max-results
mudou parainteger
. -
O valor padrão máximo de
max-results
foi alterado para 1.000.
Correções de bugs
- Removemos as contas, as propriedades da Web e os perfis dos experimentos do Otimizador de site do Google dos conjuntos correspondentes.
Versão de 29 de agosto de 2011
Nesta versão, adicionamos duas novas versões da API com muitos recursos novos e removemos a antiga. As alterações afetam o modo de solicitar e manipular os dados da API.
Versão 3.0
-
Essa é a versão principal mais recente da nossa API, que não é compatível com as anteriores. Será preciso usar esta versão para todo o desenvolvimento futuro da API.
-
Novos dados
- Representação completa das metas de eventos
- ID da propriedade da Web interno que pode ser usado para criar links diretos para a interface do usuário do Google Analytics
- Configurações de perfil para a página padrão e parâmetros de consulta de pesquisa no site
-
Mudanças
- Adicionamos uma nova política de cota.
- Incluímos a integração com o Console de APIs do Google para gerenciar o acesso à API e solicitar mais cotas.
- Adicionamos suporte para autorização de usuários com OAuth 2.0.
- Incluímos um novo URL para fazer solicitações:
https://www.googleapis.com/analytics/v3/management/…
. - Adicionamos uma resposta de API mais compacta usando JSON.
- Lançamos novas bibliotecas de cliente das APIs do Google compatíveis com várias outras linguagens.
- Adicionamos suporte à API Google Discovery.
Versão 2.4
-
Este é um upgrade de versão secundária que é, na maioria das vezes, compatível com versões anteriores à 2.3.
-
Mudou
- Adicionamos uma nova política de cota.
- Incluímos a integração com o Console de APIs do Google para gerenciar o acesso à API e solicitar mais cotas.
- Adicionamos suporte contínuo para os mecanismos de autorização existentes e o OAuth 2.0.
- Incluímos um novo URL para fazer solicitações:
https://www.googleapis.com/analytics/v2.4/management/…
. - Adicionamos o recurso de respostas somente em XML.
- Removemos o suporte para a biblioteca de cliente JavaScript dos dados do Google.
- A saída XML agora é consistente com a versão 2.3, então, as outras bibliotecas de cliente de dados do Google continuarão funcionando.
Suspensão de uso
- Estamos anunciando a descontinuação da versão 2.3 legada da API Management. Ela vai continuar funcionando por dois meses. Depois disso, todas as solicitações feitas na v2.3 vão retornar uma resposta para a v2.4.
Versão de 18 de agosto de 2010
Esta é a versão Beta da API Google Analytics Management.
Novos feeds
-
Criamos cinco novos feeds para simplificar o acesso aos dados de configuração da conta do Google Analytics:
Bibliotecas de cliente atualizadas
- A API Management está sendo lançada na mesma biblioteca que a API Data Export do Google Analytics. As bibliotecas Java e JavaScript de dados do Google foram atualizadas. Cada feed pode ser acessado especificando o URI de feed apropriado para o método
getManagementFeed()
das bibliotecas.
Nova documentação
- Criamos uma seção de documentação para desenvolvedores do Google Analytics que descreve como a nova API Management funciona.