REST Resource: users

Risorsa: utente

Un singolo utente in Display & Video a 360°.

Rappresentazione JSON
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
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 codificata 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.

AssignedUserRole

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

Rappresentazione 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.
}
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à.

Campo unione entity_id. Obbligatorio.

L'ID dell'entità a cui si applica il ruolo utente assegnato. entity_id può essere solo uno dei seguenti:

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.

UserRole

Possibili ruoli utente.

Enum
USER_ROLE_UNSPECIFIED Valore predefinito quando il ruolo utente non è specificato o non è noto in questa versione.
ADMIN L'utente può gestire le campagne, le creatività, gli ordini di inserzione, gli elementi pubblicitari e i report per l'entità. Possono visualizzare e modificare i dati di fatturazione, creare o modificare utenti e attivare o disattivare le piattaforme di scambio. Questo ruolo può essere assegnato solo a un'entità partner.
ADMIN_PARTNER_CLIENT L'utente può gestire le campagne, le creatività, gli ordini di inserzione, gli elementi pubblicitari e i report per l'entità. Può creare e modificare altri utenti di ADMIN_PARTNER_CLIENT e visualizzare i dati di fatturazione. Non possono visualizzare modelli di entrate, markup o altri campi sensibili al rivenditore. Questo ruolo può essere assegnato solo a un'entità partner.
STANDARD L'utente può gestire le campagne, le creatività, gli ordini di inserzione, gli elementi pubblicitari e i 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 relativi all'entità, inclusi tutti i dati di costo. Possono creare e modificare le 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 relativi all'entità. Possono creare o modificare le funzionalità relative alla pianificazione, inclusi piani e inventario. Non hanno accesso ai dati di costo e non possono avviare, accettare o negoziare deal.
STANDARD_PARTNER_CLIENT L'utente può gestire le campagne, le creatività, gli ordini di inserzione, gli elementi pubblicitari e i 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 al rivenditore. Questo ruolo può essere assegnato solo a un'entità inserzionista.
READ_ONLY L'utente può solo creare report e visualizzare i dati per l'entità.
REPORTING_ONLY L'utente può solo creare e gestire i report.
LIMITED_REPORTING_ONLY L'utente può creare e gestire solo 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, all'entità possono aggiungere altri amministratori o utenti delle creatività.

Metodi

bulkEditAssignedUserRoles

Modifiche collettive ai ruoli utente di 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.