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. ID único del usuario. El sistema lo asigna.
email

string

Obligatorio. Inmutable. Es la 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.

Se requiere 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 estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. 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),

  // 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.
}
Campos
assignedUserRoleId

string

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

enum (UserRole)

Obligatorio. Es el rol de usuario que se asignará a un usuario para la entidad.

Campo de unión entity_id. Obligatorio.

Es el ID de la entidad a la que se aplica el rol de usuario asignado. entity_id puede ser una de las siguientes opciones:
partnerId

string (int64 format)

Es el 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.

User role

Roles de usuario posibles.

Enumeraciones
USER_ROLE_UNSPECIFIED Es el valor predeterminado cuando el rol del usuario no se especifica o se desconoce en esta versión.
ADMIN El usuario puede administrar campañas, creatividades, órdenes de inserción, líneas de pedido e informes de la entidad. Pueden ver y editar la información 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, órdenes de inserción, líneas de pedido e informes de la entidad. Pueden crear y modificar otros usuarios ADMIN_PARTNER_CLIENT, y ver la información 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, órdenes de inserción, líneas de pedido e informes de la entidad. No pueden crear ni modificar usuarios, ni ver la información 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, las órdenes 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, órdenes de inserción, líneas de pedido e informes de la entidad. No pueden crear ni modificar otros usuarios, ni ver la información 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 externos.
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.