REST Resource: users

Recurso: User

Es un solo usuario en Display & Video 360.

Representación JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Campos
name

string

Solo salida. Es el nombre del recurso del usuario.
userId

string (int64 format)

Solo salida. Es el ID único del usuario. El sistema lo asigna.
email

string

Obligatorio. Inmutable. Dirección de correo electrónico que se usa para identificar al usuario.
displayName

string

Obligatorio. Es el nombre visible del usuario.

Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
assignedUserRoles[]

object (AssignedUserRole)

Son los roles de usuario asignados.

Obligatorio en users.create. Solo salida en users.patch. Solo se puede actualizar a través de users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última vez que el usuario accedió a la IU de DV360.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AssignedUserRole

Un solo rol de usuario asignado, que define la interacción autorizada de un usuario con un socio o anunciante especificado.

Representación 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.
}
Campos
assignedUserRoleId

string

Solo salida. Es el ID del rol de usuario asignado.
userRole

enum (UserRole)

Obligatorio. Rol de usuario que se asignará a un usuario para la entidad.

Obligatorio.

Es el ID de la entidad a la que se aplica el rol de usuario asignado. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
partnerId

string (int64 format)

ID del socio al que se aplica el rol de usuario asignado.
advertiserId

string (int64 format)

Es el ID del anunciante al que se aplica el rol de usuario asignado.
Fin de los campos mutuamente excluyentes.

User role

Roles de usuario posibles.

Enums
USER_ROLE_UNSPECIFIED Es el valor predeterminado cuando no se especifica el rol del usuario o se desconoce en esta versión.
ADMIN El usuario puede administrar campañas, creatividades, pedidos de inserción, líneas de pedido e informes de la entidad. Pueden ver y editar los datos de facturación, crear o modificar usuarios, y habilitar o inhabilitar intercambios. Este rol solo se puede asignar a una entidad socia.
ADMIN_PARTNER_CLIENT El usuario puede administrar campañas, creatividades, pedidos de inserción, líneas de pedido e informes de la entidad. Pueden crear y modificar otros usuarios ADMIN_PARTNER_CLIENT, y ver los datos de facturación. No pueden ver los modelos de ingresos, los márgenes ni ningún otro campo sensible para los revendedores. Este rol solo se puede asignar a una entidad socia.
STANDARD El usuario puede administrar campañas, creatividades, pedidos de inserción, líneas de pedido e informes de la entidad. No pueden crear ni modificar usuarios, ni ver los datos de facturación.
STANDARD_PLANNER El usuario puede ver todas las campañas, las creatividades, las órdenes de inserción, las líneas de pedido y los informes de la entidad, incluidos todos los datos de costos. Pueden crear y modificar funciones relacionadas con la planificación, incluidos los planes y el inventario.
STANDARD_PLANNER_LIMITED El usuario puede ver todas las campañas, las creatividades, los pedidos de inserción, las líneas de pedido y los informes de la entidad. Pueden crear o modificar funciones relacionadas con la planificación, incluidos los planes y el inventario. No tienen acceso a los datos de costos y no pueden iniciar, aceptar ni negociar acuerdos.
STANDARD_PARTNER_CLIENT El usuario puede administrar campañas, creatividades, pedidos de inserción, líneas de pedido e informes de la entidad. No pueden crear ni modificar otros usuarios, ni ver los datos de facturación. No pueden ver los modelos de ingresos, los márgenes ni ningún otro campo sensible para los revendedores. Este rol solo se puede asignar a una entidad de anunciante.
READ_ONLY El usuario solo puede generar informes y ver datos de la entidad.
REPORTING_ONLY El usuario solo puede crear y administrar informes.
LIMITED_REPORTING_ONLY El usuario solo puede crear y administrar los siguientes informes seguros para el cliente: General, Rendimiento del público, Entre socios, Palabras clave, ID de pedido, Categoría y Proveedor de datos de terceros.
CREATIVE El usuario puede ver la información del plan de medios que necesita para colaborar, pero no puede ver los datos relacionados con los costos ni Marketplace.
CREATIVE_ADMIN El usuario puede ver la información del plan de medios que necesita para colaborar, pero no puede ver los datos relacionados con los costos ni Marketplace. Además, pueden agregar otros administradores de creatividades o usuarios de creatividades a la entidad.

Métodos

bulkEditAssignedUserRoles

 Edita de forma masiva los roles de un usuario.

create

 Crea un usuario nuevo.

delete

 Borra un usuario.

get

 Obtiene un usuario.

list

 Enumera los usuarios a los que puede acceder el usuario actual.

patch

 Actualiza un usuario existente.