REST Resource: users

Ресурс: Пользователь

Один пользователь в Display & Video 360.

JSON-представление 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
Поля
name

string

Только вывод. Имя ресурса пользователя.

userId

string ( int64 format)

Только вывод. Уникальный идентификатор пользователя. Назначается системой.

email

string

Необходимый. Неизменяемый. Адрес электронной почты, используемый для идентификации пользователя.

displayName

string

Необходимый. Отображаемое имя пользователя.

Должен быть в кодировке UTF-8 с максимальным размером 240 байт.

assignedUserRoles[]

object ( AssignedUserRole )

Назначенные роли пользователей.

Требуется в users.create . Вывод только в users.patch . Можно обновить только через users.bulkEditAssignedUserRoles .

Назначенная роль пользователя

Одна назначенная роль пользователя, определяющая авторизованное взаимодействие пользователя с указанным партнером или рекламодателем.

JSON-представление 
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // Union field entity_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field entity_id.
}
Поля
assignedUserRoleId

string

Только вывод. Идентификатор назначенной роли пользователя.

userRole

enum ( UserRole )

Необходимый. Роль пользователя, которую нужно назначить пользователю сущности.

Поле entity_id . Необходимый.

Идентификатор сущности, к которой применяется назначенная роль пользователя. entity_id может быть только одним из следующих:

partnerId

string ( int64 format)

Идентификатор партнера, к которому применяется назначенная роль пользователя.

advertiserId

string ( int64 format)

Идентификатор рекламодателя, к которому применяется назначенная роль пользователя.

Роль пользователя

Возможные роли пользователей.

Перечисления
USER_ROLE_UNSPECIFIED Значение по умолчанию, если роль пользователя не указана или неизвестна в этой версии.
ADMIN Пользователь может управлять кампаниями, креативами, заказами на размещение, позициями и отчетами для объекта. Они могут просматривать и редактировать платежную информацию, создавать или изменять пользователей, а также включать или отключать обмены. Эту роль можно назначить только партнерской сущности.
ADMIN_PARTNER_CLIENT Пользователь может управлять кампаниями, креативами, заказами на размещение, позициями и отчетами для объекта. Они могут создавать и изменять других пользователей ADMIN_PARTNER_CLIENT и просматривать платежную информацию. Они не могут просматривать модели дохода, наценки или любые другие поля, чувствительные к реселлерам. Эту роль можно назначить только партнерской сущности.
STANDARD Пользователь может управлять кампаниями, креативами, заказами на размещение, позициями и отчетами для объекта. Они не могут создавать и изменять пользователей или просматривать платежную информацию.
STANDARD_PLANNER Пользователь может просматривать все кампании, креативы, заказы на размещение, позиции и отчеты для объекта, включая все данные о расходах. Они могут создавать и изменять функции, связанные с планированием, включая планы и инвентарь.
STANDARD_PLANNER_LIMITED Пользователь может просматривать все кампании, креативы, заказы на размещение, позиции и отчеты для объекта. Они могут создавать или изменять функции, связанные с планированием, включая планы и инвентарь. У них нет доступа к данным о затратах, и они не могут заключать, принимать или вести переговоры по сделкам.
STANDARD_PARTNER_CLIENT Пользователь может управлять кампаниями, креативами, заказами на размещение, позициями и отчетами для объекта. Они не могут создавать или изменять других пользователей или просматривать платежную информацию. Они не могут просматривать модели дохода, наценки или любые другие поля, чувствительные к реселлерам. Эту роль можно назначить только субъекту-рекламодателю.
READ_ONLY Пользователь может только строить отчеты и просматривать данные по сущности.
REPORTING_ONLY Пользователь может только создавать отчеты и управлять ими.
LIMITED_REPORTING_ONLY Пользователь может создавать и управлять только следующими безопасными для клиента отчетами: «Общий», «Эффективность аудитории», «Кросс-партнер», «Ключевое слово», «Идентификатор заказа», «Категория» и «Сторонний поставщик данных».
CREATIVE Пользователь может просматривать информацию о медиаплане, необходимую для совместной работы, но не может просматривать данные о затратах или торговую площадку.
CREATIVE_ADMIN Пользователь может просматривать информацию о медиаплане, необходимую для совместной работы, но не может просматривать данные о затратах или торговую площадку. Кроме того, они могут добавлять в объект других творческих администраторов или творческих пользователей.

Методы

bulkEditAssignedUserRoles

 Массовое редактирование ролей для пользователя.

create

 Создает нового пользователя.

delete

 Удаляет пользователя.

get

 Получает пользователя.

list

 Перечисляет пользователей, которые доступны текущему пользователю.

patch

 Обновляет существующего пользователя.