Présentation de l'API Reporting v4 ; guide de démarrage rapide JavaScript pour les applications Web

Ce tutoriel décrit les étapes à suivre pour accéder à l'API Reporting version 4 d'Analytics.

1. Activer l'API

Pour commencer à utiliser l'API Analytics Reporting v4, vous devez d'abord utiliser l'outil de configuration, qui vous guide tout au long de la création d'un projet dans la console Google APIs, de l'activation de l'API et de la création d'identifiants.

Remarque: Pour créer un ID client Web ou un client d'application installée, vous devez définir un nom de produit sur l'écran d'autorisation. Si vous ne l'avez pas déjà fait, vous serez invité à Configurer l'écran d'autorisation.

Créer des identifiants

Ouvrez la page Identifiants.
Cliquez sur Créer des identifiants, puis sélectionnez ID client OAuth.
Pour le type d'application, sélectionnez Application Web.
Nommez l'ID client quickstart et cliquez sur Créer.
Définissez le champ Origines JavaScript autorisées sur http://localhost:8080.
Cliquez sur Créer.

2. Configurer l'exemple

Vous devez créer le nom de fichier HelloAnalytics.html, qui contiendra le code HTML et JavaScript de notre exemple.

Copiez ou téléchargez le code source suivant dans HelloAnalytics.html.
Remplacez <REPLACE_WITH_CLIENT_ID> par l'ID client créé ci-dessus.
Remplacez <REPLACE_WITH_VIEW_ID> par un ID de vue. Vous pouvez récupérer un ID de vue à partir de l'explorateur de compte.

<!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: Exécuter l'exemple

Publiez HelloAnalytics.html sur votre serveur Web et chargez la page dans votre navigateur.
Cliquez sur le bouton Connexion, puis autorisez l'accès à Google Analytics.

Une fois ces étapes terminées, l'échantillon génère le nombre de sessions des sept derniers jours pour la vue donnée.