Guía de inicio rápido de la API con la línea de comandos

En esta página, se muestra cómo comenzar a usar la versión 1 de la API de datos de Google Analytics con el comando línea.

Paso 1: Habilita la API

Haz clic en el siguiente botón para crear automáticamente un nuevo proyecto de Google Cloud Habilita la versión 1 de la API de datos de Google Analytics y crea las credenciales de OAuth2 necesarias para esto. instructivo:

Habilitar la versión 1 de la API de datos de Google Analytics

Se te redireccionará automáticamente a la configuración de credenciales de OAuth2. . Cuando aparezca el cuadro de diálogo ¿Desde dónde llamas?, elige Computadoras de escritorio.

En el cuadro de diálogo que aparece, haz clic en DESCARGAR CONFIGURACIÓN DEL CLIENTE y guarda el archivo. credentials.json a tu directorio de trabajo.

También puedes seguir estos pasos para crear una cuenta de OAuth2 Credentials en un archivo proyecto de forma manual.

Paso 2: Instala e inicializa el SDK de Cloud

Necesitas la línea de comandos de gcloud en tu máquina de desarrollo.

Paso 3: Realiza una llamada a la API

Ahora puedes usar la API de datos de Google Analytics para realizar consultas propiedad.

Selecciona una entidad denunciante

En este instructivo, usaremos la variable de entorno GA_PROPERTY_ID para almacenar el ID de propiedad que se usará en las solicitudes a la API.

Ingresa lo siguiente en tu línea de comandos para configurar la variable GA_PROPERTY_ID:

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

Reemplace [YOUR_GA_PROPERTY_ID] por su propiedad de Google Analytics. identificador. Por ejemplo:

export GA_PROPERTY_ID=1234567890

Crea el JSON de la solicitud

En el siguiente archivo request.json, se muestra cómo compilar un informe simple.

Crea el archivo de solicitud JSON con el siguiente texto y guárdalo como un request.json en tu directorio de trabajo:

request.json

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

Autenticar

Para obtener credenciales de usuario en este ejemplo, ejecuta el siguiente comando y usa la ruta de acceso al archivo JSON de credenciales que descargaste en el paso 1:

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

Se abrirá un diálogo de consentimiento del usuario de OAuth en una nueva ventana del navegador.

Envía la solicitud

Usa curl y el contenido del cuerpo de request.json para enviar la solicitud al API de datos de Google Analytics. Ingresa lo siguiente en la línea de comandos:

  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/$GA_PROPERTY_ID:runReport -d @request.json

El comando curl usa gcloud auth application-default print-access-token. para obtener un token de autenticación.

Ten en cuenta que para pasar un nombre de archivo a curl se usa la opción -d (de “datos”) y El nombre del archivo debe ir precedido por un signo @. Este archivo debería estar en el mismo directorio en el que se ejecuta el comando curl.