REST Resource: users

Recurso: Usuario

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

email

string

Obligatorio. Inmutable. 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)

Los roles de usuario asignados

Obligatorio en users.create. Solo se muestra 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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

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

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)

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

advertiserId

string (int64 format)

El ID del anunciante al que se aplica el rol de usuario asignado.

User role

Posibles roles de usuario.

Enumeraciones
USER_ROLE_UNSPECIFIED Es el valor predeterminado cuando no se especifica el rol del usuario o es desconocido en esta versión.
ADMIN El usuario puede administrar las campañas, las creatividades, los pedidos de inserción, las líneas de pedido y los 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 asociada.
ADMIN_PARTNER_CLIENT El usuario puede administrar las campañas, las creatividades, los pedidos de inserción, las líneas de pedido y los informes de la entidad. Pueden crear y modificar otros usuarios de ADMIN_PARTNER_CLIENT, así como 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 asociada.
STANDARD El usuario puede administrar las campañas, las creatividades, los pedidos de inserción, las líneas de pedido y los informes de la entidad. No pueden crear ni modificar usuarios ni ver información de facturación.
STANDARD_PLANNER El usuario puede ver todas las campañas, creatividades, pedidos de inserción, 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, creatividades, pedidos de inserción, 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 las campañas, las creatividades, los pedidos de inserción, las líneas de pedido y los 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 del anunciante.
READ_ONLY El usuario solo puede crear informes y ver los 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, Múltiples socios, Palabra 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 el mercado.
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 el mercado. Además, pueden agregar otros administradores 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

Obtén un usuario.

list

Muestra una lista de los usuarios a los que el usuario actual puede acceder.

patch

Actualiza un usuario existente.