Este tutorial apresenta as etapas necessárias para acessar a API Reporting API v4 do Google Analytics.
1. Ative a API
Para começar a usar a API Reporting v4 do Google Analytics, primeiro é necessário usar a ferramenta de configuração, que orienta você na criação de um projeto no Console de APIs do Google, na ativação da API e na criação de credenciais.
Observação: para criar um Client-ID da Web ou um cliente de aplicativo instalado, é necessário definir um nome de produto na tela de consentimento. Você vai precisar configurar a tela de consentimento, se ainda não tiver feito isso.Criar credenciais
- Abra a página Credenciais.
- Clique em Criar credenciais e selecione OAuth Client-ID
- Em Tipo de aplicativo, selecione Aplicativo da Web.
- Atribua um nome ao quickstart do Client-ID e clique em quickstart.
- Defina as Origens JavaScript autorizadas como
http://localhost:8080
- Clique em Criar.
2. Configure a amostra
Você precisará criar um nome de arquivo HelloAnalytics.html
, que conterá o código HTML e JavaScript do nosso exemplo.
- Copie ou faça o download do código-fonte a seguir para
HelloAnalytics.html
. - Substitua
<REPLACE_WITH_CLIENT_ID>
pelo ID do cliente criado acima. - Substitua
<REPLACE_WITH_VIEW_ID>
por um ID da vista. O ID da vista pode ser recuperado no Explorador da conta.
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Hello Analytics Reporting API V4</title> <meta name="google-signin-client_id" content="<REPLACE_WITH_CLIENT_ID>"> <meta name="google-signin-scope" content="https://www.googleapis.com/auth/analytics.readonly"> </head> <body> <h1>Hello Analytics Reporting API V4</h1> <!-- The Sign-in button. This will run `queryReports()` on success. --> <p class="g-signin2" data-onsuccess="queryReports"></p> <!-- The API response will be printed here. --> <textarea cols="80" rows="20" id="query-output"></textarea> <script> // Replace with your view ID. var VIEW_ID = '<REPLACE_WITH_VIEW_ID>'; // Query the API and print the results to the page. function queryReports() { gapi.client.request({ path: '/v4/reports:batchGet', root: 'https://analyticsreporting.googleapis.com/', method: 'POST', body: { reportRequests: [ { viewId: VIEW_ID, dateRanges: [ { startDate: '7daysAgo', endDate: 'today' } ], metrics: [ { expression: 'ga:sessions' } ] } ] } }).then(displayResults, console.error.bind(console)); } function displayResults(response) { var formattedJson = JSON.stringify(response.result, null, 2); document.getElementById('query-output').value = formattedJson; } </script> <!-- Load the JavaScript API client and Sign-in library. --> <script src="https://apis.google.com/js/client:platform.js"></script> </body> </html>
3. Execute a amostra
- Publique
HelloAnalytics.html
no seu servidor da Web e carregue a página no navegador. - Clique no botão Fazer login e autorize o acesso ao Google Analytics.
Quando você concluir essas etapas, a amostra gerará o número de sessões dos últimos sete dias para a vista específica.