Rede de Display e A API Video 360 v2 foi descontinuada. Use o Display & Video 360 API v3. Para ver as instruções de migração da v2 para a v3, consulte nosso guia de migração.

Esta página foi traduzida pela API Cloud Translation.

Autorizar solicitações

Quando seu aplicativo solicita dados particulares, a solicitação precisa ser autorizada por um usuário autenticado com acesso a esses dados.

Todas as solicitações que seu aplicativo envia para a API Display & Video 360 precisam incluir um token de autorização. O token também identifica o aplicativo para o Google.

Sobre os protocolos de autorização

O aplicativo deve obrigatoriamente usar o OAuth 2.0 para autorizar solicitações. Não há outros protocolos de autorização compatíveis. Se o aplicativo usa o Fazer login com o Google, alguns aspectos da autorização são administrados para você.

Autorizar solicitações com OAuth 2.0

Todas as solicitações à API Display & Video 360 precisam ser autorizadas por um usuário autenticado.

Os detalhes do processo de autorização ou “fluxo” para o OAuth 2.0 variam um pouco, dependendo do tipo de aplicativo que você está criando. O processo geral a seguir se aplica a todos os tipos de aplicativo:

Ao criar seu aplicativo, registre-o usando o Console de APIs do Google. Em seguida, o Google fornece informações que serão usadas mais tarde, como um ID e uma chave secreta do cliente.
Ative a API Display & Video 360 no Console de APIs do Google. Se ela não estiver no Console de APIs, pule essa etapa.
Quando seu aplicativo precisar de acesso aos dados do usuário, ele solicitará ao Google um determinado escopo do acesso.
O Google exibe uma tela de consentimento ao usuário, pedindo para que o aplicativo seja autorizado a solicitar alguns dos dados dele.
Se o usuário aprovar, o Google fornecerá ao aplicativo um token de acesso de curta duração.
O aplicativo solicita dados de usuário, anexando o token de acesso à solicitação.
Se o Google determinar que a solicitação e o token são válidos, ele retornará os dados solicitados.

Alguns fluxos incluem etapas adicionais, como atualizar tokens para adquirir novos tokens de acesso. Para mais informações sobre fluxos de vários tipos de aplicativos, acesse a documentação OAuth 2.0 do Google.

Veja as informações de escopo do OAuth 2.0 para a API Display & Video 360:

Escopo	Significado
`https://www.googleapis.com/auth/display-video`	Acesso de leitura e gravação.
`https://www.googleapis.com/auth/display-video-user-management`	Acesso de leitura/gravação ao serviço `users`. Disponível apenas para usuários de contas de serviço.

Para solicitar acesso usando o OAuth 2.0, seu aplicativo precisa de informações do escopo, bem como informações fornecidas pelo Google durante o registro do aplicativo, como o ID e a chave secreta do cliente.

Dica: as bibliotecas cliente de APIs do Google cuidam de parte do processo de autorização para você. Elas estão disponíveis para uma série de linguagens de programação. Acesse a página de bibliotecas e exemplos para mais detalhes.

Permissões do usuário

Para usar a API Display & Video 360, a Conta do Google de autenticação precisa ser um usuário do Display & Video 360 com acesso a parceiros ou anunciantes relevantes.

O usuário do Display & Video 360 precisa ter uma das seguintes funções para que os parceiros ou anunciantes relevantes realizem as seguintes ações:

Somente leitura: recupere recursos usando chamadas get ou list, exceto recursos user.
Padrão: recupera, cria e atualiza recursos. Recuperar recursos user com permissões para os mesmos parceiros ou anunciantes.
Administrador: recupere, crie e atualize recursos. Recupere, crie e conceda acesso aos recursos do user para os parceiros ou anunciantes que você administra.