Primeros pasos con la Amazon Ads API

La Amazon Ads API le permite administrar los recursos publicitarios asociados con un anunciante de Amazon mediante una API REST. Se requieren tres credenciales para autorizar la mayoría de las solicitudes a la API:

• el client ID de una aplicación Login with Amazon
• un token de acceso que representa el permiso para que la aplicación cliente actúe en nombre de una cuenta de usuario
• el profile ID de la cuenta de publicidad del usuario en un marketplace específico

Esta guía explica cómo recuperar estas credenciales requeridas.

Antes de empezar

Para completar esta guía, necesitará:

• Una aplicación de cliente Login with Amazon aprobada para usar la API de Amazon Ads. Si aún no ha establecido un cliente aprobado, consulte Inducción .
• Credenciales de inicio de sesión para una cuenta de usuario de Amazon que administra cuentas de Amazon Ads. (Si no tiene credenciales de inicio de sesión para una cuenta de Amazon Ads, obtenga información sobre las cuentas de prueba ).

📘

Autorización e identidad en la API de Amazon Ads

Las solicitudes a la API de Amazon Ads las realiza una client application en nombre de una user account con acceso a las cuentas de Amazon Ads. Una cuenta de usuario debe otorgar autorización explícita a una aplicación cliente mediante Login with Amazon (LwA) .

Para obtener información conceptual sobre esta relación, es posible que desee leer lo siguiente antes de continuar:

• Descripción general de la autorización de la API de Amazon Ads
• Conceptos de inicio de sesión con Amazon (LwA)

Pasos en este proceso

La recuperación de credenciales para acceder a datos y servicios para un anunciante implica tres pasos:

1. Cree una concesión de autorización para una cuenta publicitaria. Habilite una cuenta de usuario de publicidad para otorgar acceso a su cliente LwA.
2. Genere tokens de acceso y actualización. Canjee la concesión de autorización por un token de acceso, que se usa para llamar a la API, y un token de actualización, que se usa para generar nuevos tokens de acceso.
3. Recuperar un perfil. Recupere un profile ID que represente la cuenta de usuario en un marketplace publicitario específico.

Junto con su client ID de LwA, el token de acceso y el profile ID recuperados aquí se pueden usar para autorizar futuras solicitudes a la API.

📘

Primeros pasos con nuestra collection Postman

Para algunos clientes, la collection Postman de Amazon Ads API puede ofrecer un enfoque simplificado para completar estos pasos a través de la interfaz de usuario de Postman. Obtenga más información sobre cómo comenzar con la collection Postman de la API de Amazon Ads .

Empezar

Si está listo para comenzar a llamar a la API de Amazon Ads, siga uno de estos dos caminos:

• Tutorial "Primeros pasos"
  Nuestro tutorial paso a paso incluye instrucciones para crear concesiones de autorización, generar tokens de acceso y recuperar perfiles. Para comenzar, consulte Crear una concesión de autorización .

  📘

  Nota

  Este proceso requiere conocimientos técnicos de las solicitudes HTTP y la capacidad de enviar solicitudes y leer respuestas. cURLSe proporcionan ejemplos de uso para cada paso.

• collection Postman de la Amazon Ads API
  Nuestra collection para Postman incluye scripts para ayudar a administrar la autenticación, así como plantillas listas para usar para algunas solicitudes comunes a la API. Para comenzar, consulte Uso de la collection Postman de Amazon Ads API .