Visão geral

Introdução: visão geral | 1. Criar concessão de autorização | 2. Gerar token de acesso | 3. Recupere perfis

Introdução à Amazon Ads API

A Amazon Ads API permite que você gerencie os recursos de publicidade associados a um anunciante da Amazon usando uma API REST. Três credenciais são necessárias para autorizar a maioria das solicitações à API:

• o client ID de um aplicativo do Login with Amazon
• um token de acesso que representa permissão para o aplicativo cliente agir em nome de uma conta de usuário
• o profile ID da conta de publicidade do usuário em um marketplace específico

Este guia explica como recuperar essas credenciais necessárias.

Antes de você começar

Para completar este guia, você precisará de:

• Um aplicativo cliente do Login with Amazon aprovado para usar a Amazon Ads API. Se você ainda não estabeleceu um cliente aprovado, consulte Integração .
• Credenciais de login para uma conta de usuário da Amazon que gerencia contas do Amazon Ads. (Se você não tiver credenciais de login para uma conta do Amazon Ads, saiba mais sobre contas de teste .)

📘

Autorização e identidade na API Amazon Ads

As solicitações para a API do Amazon Ads são feitas por um client application em nome de uma user account com acesso às contas do Amazon Ads. Uma conta de usuário deve conceder autorização explícita a um aplicativo cliente usando o Login with Amazon (LwA) .

Para obter informações conceituais sobre esse relacionamento, leia o seguinte antes de prosseguir:

• Visão geral da autorização da Amazon Ads API
• Conceitos de Login with Amazon (LwA)

Etapas neste processo

A recuperação de credenciais para acessar dados e serviços de um anunciante envolve três etapas:

1. Crie uma concessão de autorização para uma conta de publicidade. Habilite uma conta de usuário de publicidade para conceder acesso ao seu cliente LwA.
2. Gere tokens de acesso e atualização. Resgatar a concessão de autorização para um token de acesso, que é usado para chamar a API, e um token de atualização, que é usado para gerar novos tokens de acesso.
3. Recupere um perfil. Recupere um profile ID que representa a conta do usuário em um marketplace de publicidade específico.

Juntamente com seu client ID LwA, o token de acesso e o profile ID recuperados aqui podem ser usados ​​para autorizar futuras solicitações à API.

📘

Começando com nossa collection Postman

Para alguns clientes, a collection Postman da API do Amazon Ads pode oferecer uma abordagem simplificada para concluir essas etapas por meio da interface de usuário do Postman. Saiba mais sobre como começar a usar a collection Postman da API Amazon Ads .

Iniciar

Se você estiver pronto para começar a chamar a API Amazon Ads, siga um destes dois caminhos:

• Passo a passo "Primeiros passos"
  Nosso passo a passo inclui instruções para criar concessões de autorização, gerar tokens de acesso e recuperar perfis. Para começar, consulte Criar uma concessão de autorização .

  📘

  Nota

  Esse processo requer conhecimento técnico de solicitações HTTP e capacidade de enviar solicitações e ler respostas. Exemplos de uso cURLsão fornecidos para cada etapa.

• Amazon Ads API Postman collection
  Nossa collection para o Postman inclui scripts para ajudar a gerenciar a autenticação, bem como modelos prontos para algumas solicitações comuns à API. Para começar, consulte Guia de início rápido - Postman .