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 Analytics Management permite acesso programático aos dados de configuração do Google Analytics (apenas no Universal 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 oferece ferramentas para navegar na sua conta.
Você pode usar a API de gerenciamento do Google Analytics para:
- Liste todas as informações de conta, propriedade (somente Universal Analytics) e vista da propriedade (perfil) de um usuário.
- Gerencie propriedades (somente Universal Analytics), 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 (apenas no Universal 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 que você está criando: um aplicativo da Web, um aplicativo de serviço ou um aplicativo instalado. O console do desenvolvedor guia você pelas etapas para criar as chaves de autorização adequadas, já que as APIs do Google Analytics usam o protocolo OAuth 2.0 para autenticação e autorização. Existem bibliotecas de cliente disponíveis em vários idiomas. Com as bibliotecas de cliente, você pode criar o fluxo adequado para que o usuário autorize seu aplicativo a acessar os dados dele do Google Analytics com os escopos adequados.
Uso destes documentos
Este documento e os guias subsequentes ajudarão você a executar um aplicativo inicialmente e, em seguida, a documentação se aprofundará nos vários tópicos que devem ajudar você a interagir com a API para realizar tarefas como gerenciamento de conta, usuário e dados. Também temos um conjunto completo de documentos de referência com detalhes sobre cada parâmetro de cada endpoint da API e exemplos de código.
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 |