2. Recupere tokens de acesso e atualização

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

Etapa 2: gerar tokens de acesso e atualização

Conforme descrito na visão geral "Primeiros passos" , um aplicativo cliente aprovado pode fazer chamadas para a Amazon Ads API em nome de uma conta de usuário da Amazon com acesso a contas da Amazon Ads.

Na etapa 1 do passo a passo "Primeiros passos" , você criou uma concessão de autorização que representa o contrato de uma conta de usuário para habilitar o acesso para seu aplicativo cliente. Para representar esse contrato, o Login with Amazon criou um código de autorização , que você usará para recuperar um token de acesso para chamar a API.

• Para obter uma visão geral conceitual dos tokens de acesso e atualização na API do Amazon Ads, consulte Tokens de acesso .

Para criar tokens de acesso e atualização, siga estas etapas:

Recupere seu client ID e client secret

Faça login no Amazon Developer com a conta Amazon que você usou para criar seu login com o cliente Amazon . Navegue até o console Login with Amazon e localize o client ID e o client secret para o perfil de segurança ao qual você atribuiu acesso à API em uma etapa anterior .

• Para obter informações sobre como localizar o ID e o client secret, consulte Criar um login com o aplicativo Amazon .

Chame a URL de autorização para solicitar tokens de acesso e atualização

Para recuperar tokens de acesso e atualização, selecione a URL de autorização para sua região:

Região	URL de autorização
América do Norte (NA)	https://api.amazon.com/auth/o2/token
Europa (EU)	https://api.amazon.co.uk/auth/o2/token
Extremo Oriente (FE)	https://api.amazon.co.jp/auth/o2/token

Em seguida, construa uma solicitação POST para recuperar os tokens de acesso e atualização. Esta solicitação tem os seguintes parâmetros de consulta:

Parâmetro	Descrição
grant_type / Deve ser authorization_code.
code	O código de autorização recuperado na etapa 1 . Observe que este código expira após 5 minutos. Um novo código pode ser gerado repetindo os mesmos passos.
redirect_uri	Um dos valores no campo Allowed Return URLs em sua conta Login with Amazon.
client_id	O ID do cliente do seu login com a conta da Amazon.
client_secret	O segredo do cliente do seu login com a conta da Amazon.

Por exemplo, para recuperar tokens de acesso e atualização usando cURL, substitua seus valores na seguinte solicitação:

curl  \
    -X POST \
    --data "grant_type=authorization_code&code=AUTH_CODE&redirect_uri=YOUR_RETURN_URL&client_id=YOUR_CLIENT_ID&client_secret=YOUR_SECRET_KEY" \
    https://api.amazon.com/auth/o2/token

Resposta do token de acesso

A resposta a uma solicitação de token bem-sucedida é um objeto JSON com o seguinte schema:

Campo	Descrição
access_token	O token de acesso.
refresh_token	O token de atualização.
token_type	O tipo de token OAuth 2.0. Sempre definido como bearer.
expires_in	O período de tempo até que o token de acesso expira, em segundos.

Por exemplo:

{
    "access_token": "Atza|XXXXXXXXXXXX",
    "refresh_token": "Atzr|XXXXXXXXXXXX",
    "token_type": "bearer",
    "expires_in": 3600
}

Observe que os tokens de acesso são válidos por 60 minutos. Um novo token de acesso pode ser gerado a qualquer momento usando o token de atualização. Os tokens de atualização não expiram.

📘

Nota

Uma solicitação malsucedida pode retornar uma resposta 400 com o seguinte error_description: "The request has an invalid parameter : code"

Isso pode indicar que o código de autorização expirou, pois os códigos expiram após 5 minutos. Um novo código pode ser gerado repetindo a etapa 1 deste passo a passo .

Para obter mais informações sobre respostas de erro LwA, consulte Erros de token de acesso.

 

Usando tokens de atualização

Depois que os tokens forem recuperados usando o código de autorização, um novo token de acesso pode ser recuperado a qualquer momento usando o token de atualização. Uma chamada usando o token de atualização pode ser feita para a mesma URL determinada acima, mas incluirá parâmetros diferentes.

• Para obter mais informações, consulte Gerando um token de acesso usando um token de atualização .

Próximos passos

Agora você tem as duas credenciais essenciais para uma solicitação bem-sucedida à API de anúncios da Amazon:

• O ID do cliente do seu aplicativo cliente do Login with Amazon
• O token de acesso que permite que seu cliente acesse dados e serviços de publicidade para uma conta de usuário específica

No entanto, conforme descrito na visão geral "Primeiros passos" , a maioria das solicitações à API requer o uso de profiles para acessar dados e serviços em um marketplace específico.

Para recuperar uma lista de perfis de uma conta, continue na próxima etapa do processo de integração: Recupere um profile ID .

📘

Suporte técnico

Se você tiver dificuldade para se conectar à Amazon Ads API, visite nossa página de suporte técnico para obter ajuda.