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)
    }
  ]
}
Campos
name

string

Solo salida. Es el nombre del recurso del usuario.

userId

string (int64 format)

Solo salida. El ID único del usuario. Lo asigna el sistema.

email

string

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

displayName

string

Obligatorio. 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. Resultado solo en users.patch. Solo se puede actualizar a través de users.bulkEditAssignedUserRoles.

AssignedUserRole

Un rol del usuario único asignado, que define la interacción autorizada de un usuario con un socio o anunciante específico.

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.

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)

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

advertiserId

string (int64 format)

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

UserRole

Posibles roles del usuario

Enumeradores
USER_ROLE_UNSPECIFIED 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, informes y líneas de pedido 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 campañas, creatividades, pedidos de inserción, informes y líneas de pedido de la entidad. Pueden crear y modificar otros usuarios de ADMIN_PARTNER_CLIENT, y ver los datos de facturación. No pueden ver modelos de ingresos, lenguajes de marcado ni ningún otro campo sensible para distribuidores. Este rol solo se puede asignar a una entidad asociada.
STANDARD El usuario puede administrar campañas, creatividades, pedidos de inserción, informes y líneas de pedido de la entidad. No pueden crear ni modificar usuarios, ni ver datos de facturación.
STANDARD_PLANNER El usuario puede ver todas las campañas, creatividades, pedidos de inserción, informes y líneas de pedido de la entidad, incluidos todos los datos de costos. Pueden crear y modificar las 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, informes y líneas de pedido 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, informes y líneas de pedido de la entidad. No pueden crear ni modificar otros usuarios, ni ver datos de facturación. No pueden ver modelos de ingresos, lenguajes de marcado ni ningún otro campo sensible para distribuidores. Esta función 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: General, Rendimiento del público, Varios socios, Palabra clave, ID de pedido, Categoría y Proveedor de datos de terceros.
CREATIVE El usuario puede ver la información que necesita para colaborar con el plan de medios, pero no puede ver los datos relacionados con los costos ni Marketplace.
CREATIVE_ADMIN El usuario puede ver la información que necesita para colaborar con el plan de medios, pero no puede ver los datos relacionados con los costos ni Marketplace. Además, pueden agregar a 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

Obtiene un usuario.

list

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

patch

Actualiza un usuario existente.