REST Resource: users

Recurso: User

Un solo usuario en Display Video en 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. Asignada por el sistema.

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)

Los roles del usuario asignados

Obligatorio en users.create. Solo salida en users.patch. Solo se puede actualizar hasta 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 del 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 del usuario asignado.

userRole

enum (UserRole)

Obligatorio. El rol del 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 del 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 del usuario asignado.

advertiserId

string (int64 format)

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

User role

Roles de usuario posibles.

Enumeraciones
USER_ROLE_UNSPECIFIED 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, pedidos de inserción, informes de la entidad y líneas de pedido. 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 campañas, creatividades, pedidos de inserción, informes de la entidad y líneas de pedido. Puede crear y modificar otros usuarios de ADMIN_PARTNER_CLIENT, así como ver los datos de facturación. No pueden ver los modelos de ingresos, los márgenes de beneficios ni ningún otro campo sensible a los revendedores. Este rol solo se puede asignar a una entidad asociada.
STANDARD El usuario puede administrar campañas, creatividades, pedidos de inserción, informes de la entidad y líneas de pedido. 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, los pedidos 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 tiene acceso a los datos de costos y no puede iniciar, aceptar ni negociar acuerdos.
STANDARD_PARTNER_CLIENT El usuario puede administrar campañas, creatividades, pedidos de inserción, informes de la entidad y líneas de pedido. No pueden crear ni modificar otros usuarios, ni ver los datos de facturación. No pueden ver los modelos de ingresos, los márgenes de beneficios ni ningún otro campo sensible a los revendedores. Este rol solo se puede asignar a una entidad 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: generales, de rendimiento del público, de varios socios, de palabras clave, de ID de pedido, de categoría y de 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, podrán agregar a la entidad a otros administradores o usuarios de creatividades.

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

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

patch

Actualiza un usuario existente.