Authentication

Todas las llamadas a la API de Google Ad Manager deben autorizarse a través de OAuth2, un estándar abierto que permite a los usuarios otorgar permisos a aplicaciones de terceros para que estas puedan interactuar con los servicios web en nombre del usuario. OAuth2 permite que tu aplicación cliente de la API de Ad Manager acceda a la cuenta de Ad Manager de un usuario sin tener que administrar ni almacenar su nombre de usuario o contraseña.

Cómo generar credenciales de OAuth2

Sigue estos pasos para generar las credenciales de OAuth2.

1. Determina tu tipo de autenticación

Consulta la siguiente tabla para ver qué tipo de autenticación es el más adecuado para tu aplicación de la API de Ad Manager:

2. Crea credenciales de OAuth2

Una vez que hayas determinado tu tipo de autenticación, haz clic en la pestaña correspondiente a continuación y sigue las instrucciones para generar las credenciales de OAuth2:

Cuenta de servicio

1. Abre la página Credenciales de la consola de APIs de Google.
2. En el menú desplegable del proyecto, elige Crear un proyecto nuevo, ingresa un nombre para el proyecto y, de manera opcional, edita el ID del proyecto proporcionado. Haz clic en Crear.
3. En la página Credenciales, selecciona Crear credenciales y, luego, selecciona Clave de cuenta de servicio.
4. Selecciona Cuenta de servicio nueva y, luego, selecciona JSON.
5. Haz clic en Crear para descargar un archivo que contenga una clave privada.

Aplicación web

1. Abre la página Credenciales de la consola de APIs de Google.
2. En el menú desplegable del proyecto, elige Crear un proyecto nuevo, ingresa un nombre para el proyecto (y, de manera opcional, edita el ID del proyecto proporcionado) y haz clic en Crear.
3. En la página Credenciales, selecciona Crear credenciales y, luego, selecciona ID de cliente de OAuth.
4. Es posible que se te solicite que establezcas un nombre de producto en la página Pantalla de consentimiento. Si es así, haz clic en Configurar pantalla de consentimiento, proporciona la información solicitada y haz clic en Guardar para volver a la página Credenciales.
5. Selecciona Aplicación web en Tipo de aplicación. Sigue las instrucciones para ingresar los orígenes JavaScript, los URI de redireccionamiento o ambos.
6. Haz clic en Crear.
7. En la página que aparece, copia el ID de cliente y el secreto de cliente en el portapapeles, ya que los necesitarás cuando configures tu biblioteca cliente.

3. Configura tu red de Ad Manager

Si eres un desarrollador externo, es posible que debas pedirle a tu cliente que realice este paso por ti.

4. Configura y usa una biblioteca cliente

Sigue la guía adecuada que se indica a continuación para usar las credenciales en tu biblioteca cliente:

Si decides no usar una de nuestras bibliotecas cliente, deberás implementar tú mismo el flujo de cuenta de servicio o de app web de OAuth2.

Detrás de escena

Nuestras bibliotecas cliente se encargan automáticamente de los detalles que se describen a continuación, así que solo sigue leyendo si te interesa lo que sucede tras bambalinas. Esta sección está destinada a usuarios avanzados que ya están familiarizados con la especificación de OAuth2 y saben cómo usar OAuth2 con las APIs de Google.

Encabezado de la solicitud HTTP

El encabezado HTTP de cada solicitud a la API de Ad Manager debe incluir un token de acceso con este formato:

Authorization: Bearer ACCESS_TOKEN

Por ejemplo:

POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>

Alcance

Un solo token de acceso puede otorgar diferentes grados de acceso a varias APIs. Un parámetro variable llamado scope controla el conjunto de recursos y operaciones que permite un token de acceso. Durante la solicitud de token de acceso, tu aplicación envía uno o más valores en el parámetro scope.

Ad Manager solo tiene un alcance, que se muestra a continuación. La autorización debe realizarse a nivel del usuario dentro del producto.