REST Resource: users

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

Один пользователь в Display & Video 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 UI.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

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

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

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

Методы

bulkEditAssignedUserRoles

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

create

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

delete

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

get

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

list

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

patch

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