A API Display & Video 360 é a interface programática da plataforma Display & Video 360. É possível usar a API Display & Video 360 para automatizar fluxos de trabalho complexos do Display & Video 360. Confira alguns exemplos de tarefas que podem ser realizadas com a API Display & Video 360:
- Faça upload e crie criativos.
- Gerenciar itens de linha e a segmentação deles.
- Gerar e fazer o download de arquivos de dados estruturados.
Este guia descreve como começar a usar a API Display & Video 360.
Pré-requisitos
Antes de usar a API Display & Video 360, faça o seguinte:
É necessário ter uma Conta do Google. Você precisa de uma Conta do Google para criar um projeto no Console de APIs do Google. Se você já tem uma conta, está tudo pronto. Para fins de teste, utilize uma Conta do Google separada.
Você precisa ter acesso ao Display & Video 360. Você precisa ter acesso ao produto do Display & Video 360 para trabalhar com a API. Se a sua organização já tiver um contrato do Display & Video 360, verifique se um perfil de usuário com as permissões adequadas foi criado para suas Contas do Google. Caso contrário, entre em contato com nossa equipe de vendas para mais informações.
Teste o Display & Video 360. Esta documentação da API pressupõe que você já usou o Display & Video 360 e conhece os conceitos de programação e formatos de dados da Web. Se você ainda não usou o Display & Video 360, teste a interface da Web antes de começar a programar.
Escolher um projeto
É necessário criar ou selecionar um projeto no Console de APIs do Google e ativar a API.
Você pode criar um novo projeto ou usar um existente.
Criar um novo projeto
Siga as etapas no Console de APIs do Google para criar um projeto e ativar a API Display & Video 360 automaticamente.
Usar um projeto atual
Saiba como ativar manualmente a API Display & Video 360 para um projeto existente.
Para ativar uma API no seu projeto, siga estas etapas:
- Abra a biblioteca de APIs no Console de APIs do Google. Se necessário, selecione um projeto ou crie um novo. A biblioteca de APIs lista todas as APIs disponíveis, agrupadas por família de produtos e popularidade.
- Se a API que você quer ativar não estiver visível na lista, use a pesquisa para encontrá-la.
- Selecione a API que você quer ativar e clique no botão Ativar.
- Se necessário, ative o faturamento.
- Se necessário, aceite os Termos de Serviço da API.
Gerar credenciais
Todas as solicitações para a API Display & Video 360 precisam ser autorizadas. Para uma breve visão geral da autorização, leia como autorizar e identificar seu aplicativo no Google.
As instruções a seguir indicam o processo de criação de um ID do cliente OAuth 2.0 para usar com o fluxo de aplicativos instalados. Para instruções sobre como gerar credenciais para uso com o fluxo da conta de serviço, consulte o guia Contas de serviço.
Siga as etapas para configurar um projeto do Console de APIs do Google.
- Abra a página Credenciais no Console da API.
Clique em Criar credenciais > ID do cliente OAuth.
Selecione o tipo de aplicativo mais adequado quando solicitado. Os snippets de código Java e Python oferecidos nestes guias assumem um app para computador, enquanto os snippets de código PHP assumem um aplicativo da Web.
Insira as informações obrigatórias adicionais.
- Se essa for a primeira vez que você cria um ID do cliente, além de selecionar o tipo de aplicativo, será possível configurar sua tela de consentimento clicando no botão Configurar tela de consentimento. Você não vai receber uma solicitação para configurar a tela de consentimento novamente depois de fazer isso pela primeira vez, mas essas informações poderão ser atualizadas a qualquer momento.
Clique em Criar.
Quando terminar, você vai receber um ID do cliente OAuth 2.0 e uma chave secreta do cliente. É possível fazer o download dessa chave no formato JSON e salvar para uso posterior.
Configurar a tela de consentimento do usuário
Quando você usa o OAuth 2.0 para autenticação, seus usuários são autenticados depois de concordar com os termos apresentados a eles em uma tela de consentimento do usuário.
Para configurar a tela de consentimento do projeto, faça o seguinte:
- Abra a página da tela de consentimento no Console de APIs do Google. Se necessário, selecione um projeto ou crie um novo.
- Preencha o formulário e clique em Salvar.