Configura el acceso a la API

A continuación, se explica cómo configurar el acceso a la API de Data Manager con un SDK o REST.

Elige el tipo de proceso de configuración que deseas seguir:

Requisitos previos

Antes de usar la API de Data, asegúrate de tener lo siguiente:

  1. Un proyecto de Google Cloud
  2. Una Cuenta de Google que tenga el permiso serviceusage.services.enable en tu proyecto de Google Cloud o que tenga un rol que incluya ese permiso Por ejemplo, roles/owner y roles/serviceusage.serviceUsageAdmin incluyen el permiso serviceusage.services.enable. Para verificar tus permisos, consulta Cómo ver el acceso actual.
  3. La interfaz de línea de comandos de Google Cloud instalada

Habilita la API

Si aún no lo hiciste, haz clic en Habilita la API de Data Manager o sigue las instrucciones para realizar este paso de forma manual.

Habilita la API de Data Manager

Si no encuentras la API de Data Manager o si falla la opción Habilitar la API de Data Manager, verifica que tu Cuenta de Google cumpla con los requisitos previos.

Configura la autenticación

Puedes usar cualquiera de los métodos de autenticación de Google, además de las claves de API. Te recomendamos que revises cómo elegir el método de autenticación correcto para tu caso de uso y decidas qué enfoque es adecuado para tu caso de uso.

Dos métodos de autenticación comunes son las cuentas de usuario y las cuentas de servicio:

  • Cuentas de usuario: Representan a las personas que interactúan directamente con los servicios y las APIs de Google.
  • Cuentas de servicio: Representan a las apps, no a las personas, como usuarios. Permiten que tus apps administren la autenticación y la autorización. Por ejemplo, si una app necesita acceder a recursos de Google Cloud.

Tu integración puede usar las credenciales predeterminadas de la aplicación (ADC) para encontrar automáticamente las credenciales del entorno, de modo que no tengas que cambiar el código del cliente para autenticarte.

Elige Cuenta de usuario o Suplantación de identidad de cuenta de servicio para configurar ADC:

Estos son los pasos para autenticarte con credenciales de cuenta de usuario:

  1. Configura los parámetros de Google Auth Platform para tu proyecto.

    1. Abre la página de la marca en la consola de Google Cloud.

    2. Elige tu proyecto.

    3. Completa el formulario y haz clic en Crear.

  2. Dado que el alcance de la API de Data Manager es un alcance sensible, se requieren los siguientes pasos:

    1. Ve a la configuración de Acceso a los datos de tu proyecto.

    2. Haz clic en Agregar o quitar permisos.

    3. Marca la casilla junto a Data Manager API en la lista de permisos y haz clic en Actualizar.

    4. Haz clic en Guardar.

    5. Ve a Público en la consola de Google Cloud y actualiza el Estado de publicación y el Tipo de usuario. Obtén más información sobre estos parámetros de configuración en Administrar público de la aplicación.

  3. Haz clic en Crear cliente de OAuth2 para crear un cliente de OAuth2 en el proyecto o sigue las instrucciones para crear un cliente de OAuth2 de escritorio. Puedes omitir este paso si ya tienes un cliente de OAuth2 de escritorio que quieras usar para la API de Data Manager.

    Si haces clic en Crear cliente de OAuth2, selecciona App para computadoras cuando se te solicite Configurar tu cliente de OAuth para que puedas usar el cliente en los pasos restantes.

    Crea un cliente de OAuth2

    En el último paso, haz clic en DESCARGAR CONFIGURACIÓN DEL CLIENTE y anota la ubicación de descarga que elijas.

  4. Ejecuta el siguiente comando para generar un archivo ADC local. Este comando inicia un flujo web en el que se te solicita que accedas a la Cuenta de Google que usas con la API.

    Reemplaza PATH_TO_CLIENT_JSON por el nombre del archivo JSON que descargaste.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Si deseas usar las mismas credenciales para la API de Data Manager y la API de Google Ads, incluye el alcance de la API de Google Ads en la lista de --scopes:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Si deseas usar las mismas credenciales para la API de Data Manager y la API de Display & Video 360, incluye el alcance de la API de Display & Video 360 en la lista de --scopes:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. Confirma que las credenciales estén configuradas correctamente con el siguiente comando. Si se ejecuta correctamente, el comando imprimirá un token de acceso en la consola.

    gcloud auth application-default print-access-token

Para obtener más información sobre la autenticación y las credenciales de tu app, consulta Métodos de autenticación en Google y Cómo funcionan las credenciales predeterminadas de la aplicación.

Configura el acceso a la cuenta

Otorga a la dirección de correo electrónico asociada a tu cuenta de usuario acceso a Destination.

  • Si usas una cuenta de Google Ads, sigue las instrucciones para agregar el correo electrónico del usuario a la cuenta de Google Ads o a una cuenta de administrador principal de Google Ads.
  • Si usas una cuenta de Display & Video 360, sigue las instrucciones para agregar el correo electrónico del usuario a la cuenta.
  • Si usas una propiedad de Google Analytics, sigue las instrucciones para agregar el correo electrónico del usuario a la cuenta.

Próximos pasos

Instala una biblioteca cliente y ejecuta muestras de código para probar tu primera solicitud a la API de Data Manager.

Siguiente
Instalar una biblioteca cliente