Apresentação da API Reporting v4 do Google Analytics: início rápido de JavaScript para aplicativos da Web

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ê receberá uma solicitação para 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 início rápido do Client-ID e clique em Criar.
  • Defina as origens JavaScript autorizadas como http://localhost:8080.
  • Clique em Criar.

2. Configure a amostra

Você precisa criar um nome de arquivo HelloAnalytics.html, que terá o código HTML e JavaScript do nosso exemplo.

  • Copie ou faça o download do código-fonte a seguir para o HelloAnalytics.html.
  • Substitua <REPLACE_WITH_CLIENT_ID> pelo Client-ID criado acima.
  • Substitua <REPLACE_WITH_VIEW_ID> por um código da vista, que 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.