2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자 액세스는 개인이 Display & Video 360 제품 내에서 할 수 있는 작업을 관리합니다. 사용자는 인증 중에 사용된 Google 계정으로 식별됩니다. 사용자의 액세스 범위는 Display & Video 360 Partner
또는 Advertiser
리소스에 연결된 할당된 사용자 역할에 따라 결정됩니다.
이 가이드에서는 Display & Video 360 API를 통해 사용자를 찾고 생성하고 사용자 역할을 할당하는 방법을 설명합니다.
기본 요건
Display & Video 360 API 사용자 서비스를 사용하기 전에 다음 단계를 완료해야 합니다. 필요한 경우 팀의 기존 관리자 사용자에게 문의하여 필요한 Display & Video 360 사용자 역할을 사용 설정하세요.
시작하기 가이드에 설명된 대로 API 프로젝트를 만들고 승인합니다.
승인 시 서비스 계정 흐름을 따르고 있는지 확인합니다. 서비스 계정만 Display & Video 360 API users
서비스에 액세스할 수 있습니다. 인증 프로세스에서 users
서비스에만 해당하는 OAuth 범위도 사용해야 합니다.
서비스 계정이 Display & Video 360 사용자이고 필요한 리소스에 필요한 사용자 역할이 있는지 확인합니다. 관리자 역할만 사용자와 할당된 사용자 역할을 변경할 수 있습니다. 다른 표준 역할은 사용자 리소스에 대한 읽기 전용 액세스 권한만 부여합니다.
사용자 역할 이해하기
할당된 사용자 역할에 따라 사용자가 다양한 Display & Video 360 광고 게재 리소스에 대한 액세스 수준이 결정됩니다. 사용자 역할에 대해 알아야 할 중요한 사항은 다음과 같습니다.
사용자 역할은 Advertiser
및 Partner
라는 두 가지 리소스 유형에 대해 부여할 수 있습니다.
일부 사용자 역할은 특정 리소스 유형에만 할당할 수 있습니다.
파트너에게 할당된 사용자 역할은 해당 파트너의 모든 광고주에게 해당 수준의 액세스 권한을 자동으로 부여합니다.
사용자 역할에 따라 액세스할 수 있는 다른 사용자와 사용자를 만들거나 다른 사용자의 할당된 역할을 수정할 수 있는지 여부도 제어됩니다. 사용자는 동일한 리소스에 대한 액세스 권한을 공유하는 사용자만 볼 수 있습니다. 예를 들어 파트너 리소스에 대한 표준 액세스 권한이 있는 경우 해당 파트너 또는 그 아래의 광고주에 액세스할 수 있는 모든 사용자가 users.list
메서드 응답에 포함됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eDisplay & Video 360 user access is determined by assigned user roles linked to Partner or Advertiser resources.\u003c/p\u003e\n"],["\u003cp\u003eThis guide explains how to find, create, and assign user roles to users through the Display & Video 360 API using service accounts.\u003c/p\u003e\n"],["\u003cp\u003eOnly Admin user roles can modify users and their roles; other roles only provide read access to user resources.\u003c/p\u003e\n"],["\u003cp\u003eUser access is limited to resources they share with other users, meaning visibility is restricted to users with overlapping resource access.\u003c/p\u003e\n"],["\u003cp\u003eUser roles can be assigned at the Partner or Advertiser level, with some roles specific to a resource type and Partner-level roles granting access to all advertisers under that Partner.\u003c/p\u003e\n"]]],["Users in Display & Video 360 are identified by their Google account, and their actions are dictated by assigned roles linked to Partner or Advertiser resources. To use the API, an API project needs authorization, and only service accounts can access the user service with a specific OAuth scope. Admin users can create and modify users and roles; others can only read. User roles grant access to resources; roles at the partner level automatically apply to all advertisers. Users can only see those with access to the same resources.\n"],null,["# Overview\n\nUser access governs the operations individuals can do within the\nDisplay \\& Video 360 product. [Users](/display-video/api/reference/rest/current/users) are identified by the Google\naccount used during authentication. The extent of a user's access is determined\nby their assigned user roles, which are linked to Display \\& Video 360\n[`Partner`](/display-video/api/reference/rest/current/partners) or [`Advertiser`](/display-video/api/reference/rest/current/advertisers) resources.\n\nThis guide describes how to find and create users, as well as assign them user\nroles through the Display \\& Video 360 API.\n\nPrerequisites\n-------------\n\nBefore you start working with Display \\& Video 360 API User services, you'll need to\ncomplete the following steps. Contact an existing **Admin** user on your team to\nhave the necessary Display \\& Video 360 user roles enabled, if necessary:\n\n1. Create and authorize an API project as outlined in our\n [Get Started](/display-video/api/guides/getting-started) guide.\n\n2. Ensure that you're following the [service account](/display-video/api/guides/how-tos/service-account)\n flow for authorization. Only service accounts can access the Display \\& Video 360 API\n [`users`](/display-video/api/reference/rest/current/users) service. An [OAuth scope specific to the `users`\n service](/display-video/api/reference/rest/current/users/get#authorization-scopes) must also be used in the authentication process.\n\n3. Ensure that the service account is a Display \\& Video 360 user, and has the\n requisite [user roles](//support.google.com/displayvideo/answer/2723011) for the necessary resources. Only the\n [Admin](/display-video/api/reference/rest/current/users#UserRole.ENUM_VALUES.ADMIN) role allows you to make changes to a user and their\n assigned user roles. Any other [standard role](//support.google.com/displayvideo/answer/2723011#user-roles) only gives\n you read access to user resources.\n\nUnderstand user roles\n---------------------\n\nAssigned user roles determine the level of access users have to different\nDisplay \\& Video 360 ad-serving resources. Important things to know about user\nroles include:\n\n- A user role can be given for two different resource types:\n [`Advertiser`](/display-video/api/reference/rest/current/advertisers) and [`Partner`](/display-video/api/reference/rest/current/partners).\n\n- Some user roles can only be assigned for a specific resource type.\n\n- A user role assigned for a partner automatically grants that level of access\n to all advertisers under that partner.\n\nUser roles also control which other users you have access to, and whether you\ncan create users and or modify others' assigned roles. **As a user, you can\nonly see users who share access to the same resource.** For example, if you\nhave standard access to a partner resource, all users who have access to that\npartner or any of the advertisers under it will be included in a\n[`users.list`](/display-video/api/reference/rest/current/users/list) method response."]]