REST Resource: users

Risorsa: User

Un singolo utente in Display & Video 360.

Rappresentazione JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Campi
name

string

Solo output. Il nome risorsa dell'utente.
userId

string (int64 format)

Solo output. L'ID univoco dell'utente. Assegnato dal sistema.
email

string

Obbligatorio. Immutabile. L'indirizzo email utilizzato per identificare l'utente.
displayName

string

Obbligatorio. Il nome visualizzato dell'utente.

Deve essere codificato in UTF-8 con una dimensione massima di 240 byte.
assignedUserRoles[]

object (AssignedUserRole)

I ruoli utente assegnati.

Obbligatorio in users.create. Output solo in users.patch. Può essere aggiornato solo tramite users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Solo output. Il timestamp dell'ultimo accesso dell'utente all'interfaccia utente DV360.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AssignedUserRole

Un singolo ruolo utente assegnato, che definisce l'interazione autorizzata di un utente con un partner o un inserzionista specifici.

Rappresentazione 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.
}
Campi
assignedUserRoleId

string

Solo output. L'ID del ruolo utente assegnato.
userRole

enum (UserRole)

Obbligatorio. Il ruolo utente da assegnare a un utente per l'entità.

Obbligatorio.

L'ID dell'entità a cui si applica il ruolo utente assegnato. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
partnerId

string (int64 format)

L'ID del partner a cui si applica il ruolo utente assegnato.
advertiserId

string (int64 format)

L'ID dell'inserzionista a cui si applica il ruolo utente assegnato.
Fine dei campi che si escludono a vicenda.

UserRole

Ruoli utente possibili.

Enum
USER_ROLE_UNSPECIFIED Valore predefinito quando il ruolo utente non è specificato o è sconosciuto in questa versione.
ADMIN L'utente può gestire campagne, creatività, ordini di inserzione, elementi pubblicitari e report per l'entità. Possono visualizzare e modificare i dati di fatturazione, creare o modificare utenti e attivare o disattivare gli scambi. Questo ruolo può essere assegnato solo a un'entità partner.
ADMIN_PARTNER_CLIENT L'utente può gestire campagne, creatività, ordini di inserzione, elementi pubblicitari e report per l'entità. Possono creare e modificare altri utenti ADMIN_PARTNER_CLIENT e visualizzare i dati di fatturazione. Non possono visualizzare modelli di entrate, markup o altri campi sensibili per i rivenditori. Questo ruolo può essere assegnato solo a un'entità partner.
STANDARD L'utente può gestire campagne, creatività, ordini di inserzione, elementi pubblicitari e report per l'entità. Non possono creare e modificare utenti né visualizzare i dati di fatturazione.
STANDARD_PLANNER L'utente può visualizzare tutte le campagne, le creatività, gli ordini di inserzione, gli elementi pubblicitari e i report per l'entità, inclusi tutti i dati di costo. Possono creare e modificare funzionalità relative alla pianificazione, inclusi piani e inventario.
STANDARD_PLANNER_LIMITED L'utente può visualizzare tutte le campagne, le creatività, gli ordini di inserzione, gli elementi pubblicitari e i report per l'entità. Possono creare o modificare funzionalità relative alla pianificazione, inclusi piani e inventario. Non hanno accesso ai dati di costo e non possono avviare, accettare o negoziare accordi.
STANDARD_PARTNER_CLIENT L'utente può gestire campagne, creatività, ordini di inserzione, elementi pubblicitari e report per l'entità. Non possono creare o modificare altri utenti né visualizzare i dati di fatturazione. Non possono visualizzare modelli di entrate, markup o altri campi sensibili per i rivenditori. Questo ruolo può essere assegnato solo per un'entità inserzionista.
READ_ONLY L'utente può solo creare report e visualizzare dati per l'entità.
REPORTING_ONLY L'utente può solo creare e gestire report.
LIMITED_REPORTING_ONLY L'utente può solo creare e gestire i seguenti report a misura di cliente: Generale, Rendimento del pubblico, Partner incrociati, Parola chiave, ID ordine, Categoria e Fornitore di dati di terze parti.
CREATIVE L'utente può visualizzare le informazioni del piano media di cui ha bisogno per collaborare, ma non può visualizzare i dati relativi ai costi o il Marketplace.
CREATIVE_ADMIN L'utente può visualizzare le informazioni del piano media di cui ha bisogno per collaborare, ma non può visualizzare i dati relativi ai costi o il Marketplace. Inoltre, possono aggiungere altri amministratori delle creatività o utenti delle creatività all'entità.

Metodi

bulkEditAssignedUserRoles

 Modifica collettivamente i ruoli utente per un utente.

create

 Crea un nuovo utente.

delete

 Elimina un utente.

get

 Recupera un utente.

list

 Elenca gli utenti accessibili all'utente corrente.

patch

 Aggiorna un utente esistente.