REST Resource: users

Ressource : Utilisateur

Un seul utilisateur dans Display & Video 360.

Représentation JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'utilisateur.
userId

string (int64 format)

Uniquement en sortie. Identifiant unique de l'utilisateur. Attribué par le système.
email

string

Obligatoire. Immuable. Adresse e-mail utilisée pour identifier l'utilisateur.
displayName

string

Obligatoire. Nom à afficher de l'utilisateur.

Doit être encodé au format UTF-8 et ne pas dépasser 240 octets.
assignedUserRoles[]

object (AssignedUserRole)

Rôles utilisateur attribués.

Obligatoire dans users.create. Sortie uniquement dans users.patch. Ne peut être mis à jour que via users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière connexion de l'utilisateur à l'UI DV360.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

AssignedUserRole

Un seul rôle utilisateur attribué, qui définit l'interaction autorisée d'un utilisateur avec un partenaire ou un annonceur spécifique.

Représentation 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.
}
Champs
assignedUserRoleId

string

Uniquement en sortie. ID du rôle utilisateur attribué.
userRole

enum (UserRole)

Obligatoire. Rôle utilisateur à attribuer à un utilisateur pour l'entité.

Obligatoire.

ID de l'entité à laquelle s'applique le rôle utilisateur attribué. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
partnerId

string (int64 format)

ID du partenaire auquel le rôle utilisateur attribué s'applique.
advertiserId

string (int64 format)

ID de l'annonceur auquel s'applique le rôle utilisateur attribué.
Fin des champs qui s'excluent mutuellement.

UserRole

Rôles utilisateur possibles.

Enums
USER_ROLE_UNSPECIFIED Valeur par défaut lorsque le rôle de l'utilisateur n'est pas spécifié ou est inconnu dans cette version.
ADMIN L'utilisateur peut gérer les campagnes, les créations, les ordres d'insertion, les éléments de campagne et les rapports pour l'entité. Ils peuvent consulter et modifier les informations de facturation, créer ou modifier des utilisateurs, et activer ou désactiver des plates-formes d'échange. Ce rôle ne peut être attribué qu'à une entité partenaire.
ADMIN_PARTNER_CLIENT L'utilisateur peut gérer les campagnes, les créations, les ordres d'insertion, les éléments de campagne et les rapports pour l'entité. Ils peuvent créer et modifier d'autres utilisateurs ADMIN_PARTNER_CLIENT et consulter les informations de facturation. Ils ne peuvent pas consulter les modèles de revenus, les marges ni aucun autre champ sensible pour les revendeurs. Ce rôle ne peut être attribué qu'à une entité partenaire.
STANDARD L'utilisateur peut gérer les campagnes, les créations, les ordres d'insertion, les éléments de campagne et les rapports pour l'entité. Ils ne peuvent pas créer ni modifier des utilisateurs, ni consulter les informations de facturation.
STANDARD_PLANNER L'utilisateur peut afficher toutes les campagnes, créations, ordres d'insertion, éléments de campagne et rapports de l'entité, y compris toutes les données de coût. Ils peuvent créer et modifier des fonctionnalités liées à la planification (les plans et l'inventaire, par exemple).
STANDARD_PLANNER_LIMITED L'utilisateur peut afficher toutes les campagnes, créations, ordres d'insertion, éléments de campagne et rapports de l'entité. Ils peuvent créer ou modifier des fonctionnalités liées à la planification (les plans et l'inventaire, par exemple). Ils n'ont pas accès aux données de coût et ne peuvent pas lancer, accepter ni négocier d'accords.
STANDARD_PARTNER_CLIENT L'utilisateur peut gérer les campagnes, les créations, les ordres d'insertion, les éléments de campagne et les rapports pour l'entité. Ils ne peuvent pas créer ni modifier d'autres utilisateurs, ni consulter les informations de facturation. Ils ne peuvent pas consulter les modèles de revenus, les marges ni aucun autre champ sensible pour les revendeurs. Ce rôle ne peut être attribué qu'à une entité annonceur.
READ_ONLY L'utilisateur ne peut générer des rapports et consulter les données que pour l'entité.
REPORTING_ONLY L'utilisateur ne peut que créer et gérer des rapports.
LIMITED_REPORTING_ONLY L'utilisateur ne peut créer et gérer que les rapports protégeant l'intégrité du client suivants : Général, Performances en termes d'audience, Multipartenaire, Mot clé, ID de commande (Order ID), Catégorie et Fournisseur de données tiers.
CREATIVE L'utilisateur peut afficher les informations du plan média qui sont nécessaires au travail d'équipe. Par contre, il n'a pas accès aux données sur les coûts ni à la place de marché.
CREATIVE_ADMIN L'utilisateur peut afficher les informations du plan média qui sont nécessaires au travail d'équipe. Par contre, il n'a pas accès aux données sur les coûts ni à la place de marché. Ils peuvent également ajouter d'autres administrateurs ou utilisateurs créatifs à l'entité.

Méthodes

bulkEditAssignedUserRoles

 Modifie les rôles d'un utilisateur de manière groupée.

create

 Crée un nouvel utilisateur.

delete

 Supprime un utilisateur.

get

 Récupère un utilisateur.

list

 Liste les utilisateurs auxquels l'utilisateur actuel a accès.

patch

 Met à jour un utilisateur existant.