С
8 сентября 2025 года в каждой новой позиции необходимо будет указывать, будет ли она показывать политическую рекламу Европейского союза (ЕС). Загрузки через Display & Video 360 API и SDF без таких указаний будут отклонены. Подробнее о том, как обновить интеграцию и указать это указание, см.
на странице «Устаревшие функции».
Обзор
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Доступ пользователей определяет операции, которые люди могут выполнять в продукте Display & Video 360. Пользователи идентифицируются по учетной записи Google, используемой при аутентификации. Степень доступа пользователя определяется назначенными ему ролями пользователя, которые связаны с ресурсами Partner или Advertiser Display & Video 360.
В этом руководстве описывается, как находить и создавать пользователей, а также назначать им роли пользователей с помощью API Display & Video 360.
Предварительные условия
Прежде чем начать работу с пользовательскими сервисами Display & Video 360 API, вам необходимо выполнить следующие шаги. При необходимости свяжитесь с существующим администратором в вашей команде, чтобы включить необходимые роли пользователя Display & Video 360:
Создайте и авторизуйте проект API, как описано в нашем руководстве по началу работы .
Убедитесь, что вы следуете потоку авторизации учетной записи службы . Только сервисные учетные записи могут получить доступ к службе users Display & Video 360 API. В процессе аутентификации также необходимо использовать область OAuth, специфичную для службы users .
Убедитесь, что сервисный аккаунт является пользователем Display & Video 360 и имеет необходимые роли пользователя для необходимых ресурсов. Только роль администратора позволяет вам вносить изменения в пользователя и назначенные ему роли пользователя. Любая другая стандартная роль предоставляет вам доступ только для чтения к пользовательским ресурсам.
Понимание ролей пользователей
Назначенные роли пользователей определяют уровень доступа пользователей к различным ресурсам показа рекламы Display & Video 360. Важная информация о ролях пользователей:
Роль пользователя может быть назначена для двух разных типов ресурсов: Advertiser и Partner .
Некоторые роли пользователей можно назначить только для определенного типа ресурса.
Роль пользователя, назначенная партнеру, автоматически предоставляет этот уровень доступа всем рекламодателям этого партнера.
Роли пользователей также определяют, к каким другим пользователям у вас есть доступ, а также можете ли вы создавать пользователей и изменять назначенные другим пользователям роли. Как пользователь вы можете видеть только тех пользователей, которые имеют общий доступ к одному и тому же ресурсу. Например, если у вас есть стандартный доступ к партнерскому ресурсу, все пользователи, имеющие доступ к этому партнеру или любому из рекламодателей под ним, будут включены в ответ users.list .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 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."]]
