API Hello Analytics Reporting v4 : guide de démarrage rapide pour JavaScript pour les applications Web

Ce tutoriel vous explique comment accéder à l'API Reporting v4.

1. Activer l'API

Pour commencer à utiliser l'API Reporting v4, vous devez d'abord utiliser l'outil de configuration. Celui-ci vous explique comment créer un projet dans la console Google APIs, activer l'API et créer des 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 de consentement. Si vous ne l'avez pas déjà fait, vous serez invité à Configurer l'écran de consentement.

Créer des identifiants

  • Ouvrez la page Identifiants.
  • Cliquez sur Créer des identifiants, puis sélectionnez ID client OAuth.
  • Dans le champ Type d'application, sélectionnez Application Web.
  • Nommez le client quickstart et cliquez sur Create (Créer).
  • Définissez les origines JavaScript autorisées sur http://localhost:8080.
  • Cliquez sur Créer.

2. Configurer l'exemple

Vous devez créer un fichier nommé HelloAnalytics.html, qui contiendra le code HTML et JavaScript pour 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 comptes.
<!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 Se connecter, 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.