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.

Используется 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" .

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)

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

Конец взаимоисключающих областей.

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

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

Перечисления
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

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