2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
시작하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Display & Video 360 API는 Display & Video 360 플랫폼의 프로그래매틱 인터페이스입니다. Display & Video 360 API를 사용하여 복잡한 Display & Video 360 워크플로를 자동화할 수 있습니다. 다음은 Display & Video 360 API로 할 수 있는 작업의 예입니다.
이 가이드에서는 Display & Video 360 API를 시작하는 방법을 설명합니다.
기본 요건
Display & Video 360 API를 사용하려면 먼저 다음을 실행해야 합니다.
Google 계정이 있어야 합니다. Google API 콘솔에서 프로젝트를 만들려면 Google 계정이 필요합니다. 계정이 있는 경우 별도의 조치를 취할 필요가 없습니다. 테스트 목적으로 별도의 Google 계정이 필요할 수도 있습니다.
Display & Video 360에 대한 액세스 권한이 있어야 합니다. API를 사용하려면 Display & Video 360 제품에 액세스해야 합니다. 조직에 이미 Display & Video 360 계약이 있는 경우 Google 계정에 적절한 권한이 있는 사용자 프로필이 생성되었는지 확인합니다. 그렇지 않은 경우 Google 영업팀에 문의하여 자세한 내용을 알아보세요.
Display & Video 360을 사용해 보세요. 이 API 문서에서는 사용자가 Display & Video 360을 사용해 본 적이 있고 웹 프로그래밍 개념과 웹 데이터 형식을 잘 알고 있다고 가정합니다. Display & Video 360을 사용해 본 적이 없다면 코딩을 시작하기 전에 웹 UI를 사용해 보세요.
프로젝트 선택
Google API 콘솔에서 프로젝트를 만들거나 선택하고 API를 사용 설정해야 합니다.
새 프로젝트를 만들거나 기존 프로젝트를 사용할 수 있습니다.
새 프로젝트 만들기
Google API 콘솔의 단계에 따라 프로젝트를 만들고 Display & Video 360 API를 자동으로 사용 설정합니다.
기존 프로젝트 사용
다음은 기존 프로젝트의 Display & Video 360 API를 수동으로 활성화하는 방법입니다.
프로젝트에 API를 사용 설정하려면 다음 단계를 따르세요.
- Google API 콘솔에서 API 라이브러리를 엽니다. 메시지가 표시되면 프로젝트를 선택하거나 새 프로젝트를 만듭니다. API 라이브러리에는 사용 가능한 모든 API가 제품군 및 인기도별로 분류되어 있습니다.
- 사용 설정하려는 API가 목록에 없는 경우 검색을 사용하여 찾습니다.
- 사용 설정하려는 API를 선택한 다음 사용 설정 버튼을 클릭합니다.
- 메시지가 표시되면 결제를 사용 설정합니다.
- 메시지가 표시되면 API의 서비스 약관에 동의합니다.
사용자 인증 정보 만들기
Display & Video 360 API에 대한 모든 요청은 승인되어야 합니다. 승인에 관한 간단한 개요는 Google에 애플리케이션을 승인 및 식별하는 방법을 참고하세요.
다음 안내는 설치된 애플리케이션 흐름과 함께 사용할 OAuth 2.0 클라이언트 ID를 만드는 프로세스를 안내합니다. 서비스 계정 흐름에서 사용할 사용자 인증 정보를 생성하는 방법은 서비스 계정 가이드를 참고하세요.
단계에 따라 Google API 콘솔 프로젝트를 구성합니다.
- API 콘솔에서 사용자 인증 정보 페이지를 엽니다.
사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
메시지가 표시되면 가장 적합한 애플리케이션 유형을 선택합니다. 이 가이드에 제공된 Java 및 Python 코드 스니펫은 데스크톱 앱을 가정하고 PHP 코드 스니펫은 웹 애플리케이션을 가정합니다.
필요한 추가 정보를 입력합니다.
- 클라이언트 ID를 처음 만드는 경우 애플리케이션 유형을 선택할 수 있을 뿐만 아니라 동의 화면 구성 버튼을 클릭하여 동의 화면을 구성할 수 있습니다. 동의 화면을 처음 구성한 후에는 동의 화면을 다시 구성하라는 메시지가 표시되지 않지만 언제든지 이 정보를 업데이트할 수 있습니다.
만들기를 클릭합니다.
완료되면 OAuth 2.0 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다. 이 정보를 JSON 형식으로 다운로드하여 나중에 사용할 수 있도록 저장할 수 있습니다.
인증에 OAuth 2.0을 사용할 경우 사용자 동의 화면에 표시된 약관에 동의한 사용자가 인증을 받게 됩니다.
프로젝트의 동의 화면을 설정하려면 다음 단계를 따르세요.
- Google API 콘솔에서 동의 화면 페이지를 엽니다.
메시지가 표시되면 프로젝트를 선택하거나 새로운 프로젝트를 만듭니다.
- 양식을 작성하고 저장을 클릭합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(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**."]]
