Cette page a été traduite par l'API Cloud Translation.

Guide de démarrage rapide pour utiliser l'API via la ligne de commande

Cette page vous explique comment utiliser la ligne de commande pour utiliser la version 1 de l'API Data de Google Analytics.

Étape 1. Activer l'API

Cliquez sur ce bouton pour créer un projet Cloud Platform, activer automatiquement l'API Data de Google Analytics v1 et générer les identifiants OAuth2 nécessaires pour ce tutoriel:

Vous serez automatiquement redirigé vers la boîte de dialogue de configuration des identifiants OAuth2. Sélectionnez "Ordinateur" à la question "De quel pays appelez-vous ?".

Dans la boîte de dialogue qui s'affiche, cliquez sur TÉLÉCHARGER LA CONFIGURATION DU CLIENT et enregistrez le fichier credentials.json dans votre répertoire de travail.

Vous pouvez également suivre ces étapes pour créer manuellement des identifiants OAuth2 dans un projet existant.

Étape 2. Installer et initialiser le SDK Cloud

L'outil de ligne de commande gcloud doit être installé sur votre ordinateur de développement.

Étape 3: Effectuez un appel d'API

Vous pouvez maintenant utiliser l'API Google Analytics Data pour interroger une propriété Google Analytics 4.

Sélectionner une entité à l'origine du signalement

Dans ce tutoriel, nous allons utiliser la variable d'environnement GA4_PROPERTY_ID pour stocker l'ID de la propriété à utiliser dans les requêtes API.

Saisissez la commande suivante dans votre ligne de commande pour définir la variable GA4_PROPERTY_ID:

export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]

Remplacez [YOUR-GA4-PROPERTY-ID] par l'identifiant de votre propriété Google Analytics 4. Exemple :

export GA4_PROPERTY_ID=1234567890

Créer la requête JSON

Le fichier request.json suivant montre comment créer un rapport simple.

Créez le fichier de requête JSON avec le texte suivant, puis enregistrez-le en tant que fichier texte brut request.json dans votre répertoire de travail:

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

Authentifier

Pour obtenir les identifiants utilisateur de cet exemple, exécutez la commande suivante en indiquant le chemin d'accès au fichier JSON d'identifiants téléchargé à l'étape 1:

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

Une boîte de dialogue de recueil du consentement de l'utilisateur OAuth s'ouvre dans une nouvelle fenêtre du navigateur.

Envoyer la requête

Utilisez curl et le contenu du corps du fichier request.json pour envoyer la requête à l'API Data de Google Analytics. Saisissez la commande suivante dans la ligne de commande:

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json

La commande curl utilise la commande gcloud auth application-default print-access-token pour obtenir un jeton d'authentification.

Notez que pour indiquer un nom de fichier dans curl, vous devez utiliser l'option -d (pour "data") et faire précéder le nom de fichier du signe @. Ce fichier doit se trouver dans le même répertoire dans lequel vous exécutez la commande curl.

Félicitations ! Vous avez envoyé votre première requête à l'API Google Analytics Data.