Visão geral da API de gerenciamento

Este documento fornece uma visão geral de alto nível da API de gerenciamento do Google Analytics versão 3.0.

Introdução

A API de gerenciamento do Google Analytics permite acesso programático aos dados de configuração do Google Analytics. É possível criar aplicativos para gerenciar de forma mais eficiente contas grandes ou complexas do Google Analytics. Empresas grandes com muitas propriedades podem automatizar a configuração da conta. Mesmo que você esteja criando um aplicativo de relatórios, a API de gerenciamento fornece ferramentas para navegar na sua conta.

Você pode usar a API de gerenciamento do Google Analytics para:

  • Listar todas as informações de conta, propriedade e vista da propriedade (perfil) de um usuário.
  • Gerenciar propriedades, vistas da propriedade (perfis) e metas.
  • Gerenciar permissões de usuário para uma hierarquia de contas.
  • Recuperar o ID de uma vista da propriedade (perfil) a ser usado com a API de relatórios principais.
  • Determinar quais metas estão ativas e acessar os nomes configurados delas.
  • Gerenciar vinculações entre propriedades do Google Analytics e contas do Google Ads.
  • Gerenciar públicos de remarketing.

Antes de usar a API de gerenciamento do Google Analytics, é importante entender a estrutura da conta do Google Analytics. Uma conta do Google Analytics é organizada em vários níveis, e a API de gerenciamento fornece uma forma programática de interagir com as entidades em cada nível.

Uso da API de gerenciamento

Para usar a Google Analytics API, primeiro você precisa criar um projeto no Developer Console. Durante esse processo, é necessário indicar o tipo de aplicativo a ser criado: um aplicativo da Web, um aplicativo de serviço ou um aplicativo instalado. No Developer Console, você encontra as etapas para criar as chaves de autorização adequadas, pois as Google Analytics APIs usam o protocolo OAuth 2.0 para autenticação e autorização. Existem bibliotecas clientes disponíveis em vários idiomas. Com as bibliotecas cliente, você pode construir o fluxo correto para que o usuário autorize seu aplicativo a acessar os dados dele do Google Analytics nos escopos adequados.

Uso destes documentos

Com este documento e os guias subsequentes, é possível definir inicialmente um aplicativo. Em seguida, consulte a documentação para ler sobre vários tópicos que ajudam você a interagir com a API e fazer ações relacionadas ao gerenciamento de contas, usuários e dados. Também já um conjunto completo de documentos de referência com detalhes sobre cada parâmetro de cada extremidade da API, incluindo exemplos de código da API.

Próximas etapas

Sempre é um desafio fazer um aplicativo em funcionamento usar uma nova API. A seção a seguir contém um conjunto de guias de início rápido para ajudar você a dar os primeiros passos em pouco tempo. Você precisa escolher um idioma e um tipo de aplicativo:

Aplicativo de serviço Aplicativo instalado Aplicativo da Web
Java Java --
Python Python --
PHP -- PHP
-- -- JavaScript