A partir de 8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
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:
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.
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.
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.
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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThe Display & Video 360 API allows programmatic access to automate complex workflows within the Display & Video 360 platform, including tasks like creative management, line item targeting, and structured data file generation.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, ensure you have a Google Account, access to Display & Video 360, and familiarize yourself with the platform's web UI.\u003c/p\u003e\n"],["\u003cp\u003eYou need to create or select a Google API Console project and enable the Display & Video 360 API to start using it.\u003c/p\u003e\n"],["\u003cp\u003eGenerate OAuth 2.0 credentials for authorization, following the guide for either installed application or service account flow depending on your needs.\u003c/p\u003e\n"],["\u003cp\u003eConfigure a user consent screen for your project within the Google API Console to handle user authentication when using OAuth 2.0.\u003c/p\u003e\n"]]],["The Display & Video 360 API automates tasks like uploading creatives, managing line items and targeting, and generating Structured Data Files. To begin, users need a Google Account and Display & Video 360 access, alongside experience with the platform. They must create or select a project in the Google API Console and enable the API. Credentials, specifically an OAuth 2.0 client ID, must be generated, and the user consent screen must be configured to enable application authorization.\n"],null,["The Display \\& Video 360 API is the programmatic interface for the Display \\& Video 360\nplatform. You can use the Display \\& Video 360 API to automate complex\nDisplay \\& Video 360 workflows. Here are some examples of tasks you can do with the\nDisplay \\& Video 360 API:\n\n- [Upload and build\n creatives.](/display-video/api/guides/creating-creatives/overview)\n- [Manage line items and their\n targeting.](/display-video/api/guides/managing-line-items/overview)\n- [Generate and download Structured Data\n Files.](/display-video/api/guides/downloading-sdfs/create)\n\nThis guide describes how to get started with the Display \\& Video 360 API.\n\nPrerequisites\n\nBefore using the Display \\& Video 360 API, you must do the following:\n\n1. **You must have a Google Account.** You need a\n [Google Account](//www.google.com/accounts/NewAccount) in order to [create a project](#create_project)\n in the Google API Console. If you already have an\n account, then you're all set. You may also want a separate Google Account for\n testing purposes.\n\n2. **You must have access to Display \\& Video 360.** You need access to the\n Display \\& Video 360 product in order to work with the API. If your\n organization already has a Display \\& Video 360 contract, ensure a\n [user profile](//support.google.com/displayvideo/answer/2723011) with appropriate permissions has been\n created for your Google Account(s). If not,\n [contact our sales team](//marketingplatform.google.com/about/display-video-360/) for more information.\n\n3. **You should try out Display \\& Video 360.** This API documentation assumes\n that you've used Display \\& Video 360, and that you're familiar with web\n programming concepts and web data formats. If you haven't used\n Display \\& Video 360, then try out the [web UI](https://displayvideo.google.com/) before\n starting to code.\n\nChoose a project\n\nYou need to [create\nor select a project in the Google API Console and enable the API](https://console.cloud.google.com/start/api?id=displayvideo.googleapis.com&credential=client_key).\n\nYou can create a new project, or use an existing one.\n\nCreate a new project\n\nFollow the steps in the [Google API Console](https://console.cloud.google.com/start/api?id=displayvideo.googleapis.com&credential=client_key)\nto create a project and enable the Display \\& Video 360 API automatically.\n\nUse an existing project\n\nHere's how to manually activate the Display \\& Video 360 API for an existing project.\n\nTo enable an API for your project, do the following:\n\n1. [Open the API Library](https://console.cloud.google.com/apis/library) in the Google API Console. If prompted, select a project or create a new one. The API Library lists all available APIs, grouped by product family and popularity.\n2. If the API you want to enable isn't visible in the list, use search to find it.\n3. Select the API you want to enable, then click the **Enable** button.\n4. If prompted, enable billing.\n5. If prompted, accept the API's Terms of Service.\n\nGenerate credentials\n\nAll requests you make to the Display \\& Video 360 API must be authorized. For a brief\noverview of authorization, read about how to [authorize and identify your\napplication to Google](/display-video/api/guides/how-tos/authorizing).\n\nThe following instructions guide you through the process of creating an OAuth\n2.0 client ID to use with the [installed application\nflow](/identity/protocols/OAuth2InstalledApp). For instructions on generating credentials for use\nwith the service account flow, refer to the [Service Accounts](/display-video/api/guides/how-tos/service-account)\nguide.\n\n1. Follow the steps to [configure a Google API Console project](#create_project).\n\n\n2. Open the [Credentials page](https://console.cloud.google.com/apis/credentials) in the API Console.\n3. Click **Create credentials** \\\u003e **OAuth client ID**.\n\n4. Select the most applicable application type when prompted. The Java and\n Python code snippets offered in these guides assume a **Desktop app** , while\n the PHP code snippets assume a **Web application**.\n\n5. Enter any additional required information.\n\n - If this is your first time creating a client ID, besides being able to select your application type, you can configure your consent screen by clicking the **Configure consent screen** button. You won't get a prompt to configure your consent screen again after you do it the first time, although this information can be updated at any time.\n6. Click **Create**.\n\nWhen done, you'll be presented with an OAuth 2.0 client ID and client\nsecret, which you can download in JSON format and save for later use.\n\nConfigure the user consent screen\n\nWhen you use OAuth 2.0 for authentication, your users are authenticated after\nthey agree to terms presented to them on a user consent screen.\n\n\nTo set up your project's consent screen, do the following:\n\n1. Open the [Consent Screen page](https://console.cloud.google.com/apis/credentials/consent) in the Google API Console. If prompted, select a project or create a new one.\n2. Fill out the form and click **Save**."]]
