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 la línea de comandos.

Paso 1: Habilita la API

Haz clic en este botón para crear un proyecto nuevo de Cloud Platform, habilitar automáticamente la versión 1 de la API de datos de Google Analytics y crear las credenciales de OAuth2 necesarias para este instructivo:

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

Se te redireccionará automáticamente al diálogo de configuración de credenciales de OAuth2. Elige "Computadora de escritorio" cuando se te pregunte "¿Desde dónde llamas?".

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

También puedes seguir estos pasos para crear credenciales de OAuth2 en un proyecto existente de forma manual.

Paso 2: Instala e inicializa el SDK de Cloud

Debes tener instalada la herramienta de 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 consultar una propiedad Google Analytics 4.

Selecciona una entidad denunciante

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

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

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

Reemplaza [YOUR-GA4-PROPERTY-ID] por tu identificador de la propiedad Google Analytics 4. Por ejemplo:

export GA4_PROPERTY_ID=1234567890

Cómo crear el JSON de la solicitud

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

Crea el archivo de solicitud JSON con el siguiente texto y guárdalo como un archivo de texto sin formato 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 las credenciales de usuario en este ejemplo, ejecuta el siguiente comando y usa la ruta al archivo JSON de credenciales descargado 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 cuadro de 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 a la 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/$GA4_PROPERTY_ID:runReport -d @request.json

El comando curl usa el comando 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 (para “datos”) y se antepone un signo @ al nombre. El archivo debería estar en el mismo directorio en el que ejecutas el comando curl.

¡Felicitaciones! Enviaste tu primera solicitud a la API de datos de Google Analytics.