REST Resource: users

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

Один пользователь в Дисплее и Видео 360.

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

string

Только для вывода. Название ресурса пользователя.
userId

string (int64 format)

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

string

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

string

Обязательно. Отображаемое имя пользователя.

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

object (AssignedUserRole)

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

Обязательно в users.create. Отвечай только на языке users.patch. Обновить можно только через users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Только для вывода. Временная метка последнего входа пользователя в интерфейс DV360.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

AssignedUserRole

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
Поля
assignedUserRoleId

string

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

enum (UserRole)

Обязательно. Роль, которую нужно назначить пользователю для объекта.

Обязательно.

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

string (int64 format)

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

string (int64 format)

Идентификатор рекламодателя, к которому относится назначенная роль пользователя.
Конец взаимоисключающих полей.

UserRole

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

Перечисления
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 Пользователь может просматривать информацию по медиапланам, над которыми ему нужно работать совместно, но у него нет доступа к данным о стоимости или Marketplace.
CREATIVE_ADMIN Пользователь может просматривать информацию по медиапланам, над которыми ему нужно работать совместно, но у него нет доступа к данным о стоимости или Marketplace. Кроме того, он может добавлять других администраторов и пользователей с доступом к креативам.

Методы

bulkEditAssignedUserRoles

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

create

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

delete

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

get

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

list

 Выводит список пользователей, доступных текущему пользователю.

patch

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