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)
    }
  ]
}
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 avec une taille maximale de 240 octets.

assignedUserRoles[]

object (AssignedUserRole)

Rôles utilisateur attribués.

Obligatoire dans users.create. Sortie uniquement dans users.patch. Peut uniquement être modifié via users.bulkEditAssignedUserRoles.

AssignedUserRole

Un rôle utilisateur unique qui définit l'interaction autorisée d'un utilisateur avec un partenaire ou un annonceur spécifié.

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

Champ d'union entity_id. Obligatoire.

ID de l'entité à laquelle le rôle utilisateur attribué s'applique. entity_id ne peut être qu'un des éléments suivants :

partnerId

string (int64 format)

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

advertiserId

string (int64 format)

Référence de l'annonceur auquel le rôle utilisateur attribué s'applique.

UserRole

Rôles utilisateur possibles.

Enums
USER_ROLE_UNSPECIFIED Valeur par défaut lorsque le rôle 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 associés à l'entité. Ils peuvent consulter et modifier les informations de facturation, créer ou modifier des utilisateurs, et activer ou désactiver des places de marché. 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 associés à 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 majorations, ni aucun autre champ sensible au revendeur. 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 associés à l'entité. Ils ne peuvent pas créer ni modifier d'utilisateurs, ni afficher les informations de facturation.
STANDARD_PLANNER L'utilisateur peut consulter l'ensemble des campagnes, créations, ordres d'insertion, éléments de campagne et rapports de l'entité, y compris toutes les données de coût. Il peut créer et modifier des fonctionnalités liées à la planification, y compris les plans et l'inventaire.
STANDARD_PLANNER_LIMITED L'utilisateur peut consulter l'ensemble des campagnes, créations, ordres d'insertion, éléments de campagne et rapports associés à l'entité. Il peut créer ou modifier des fonctionnalités liées à la planification, y compris les plans et l'inventaire. Ils n'ont pas accès aux données de coût, et ne peuvent pas démarrer, accepter ou négocier des 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 associés à l'entité. Ils ne peuvent ni créer, ni modifier d'autres utilisateurs, ni afficher les informations de facturation. Ils ne peuvent pas consulter les modèles de revenus, les majorations, ni aucun autre champ sensible au revendeur. Ce rôle ne peut être attribué qu'à une entité d'annonceur.
READ_ONLY L'utilisateur peut uniquement créer des rapports et afficher les données pour l'entité.
REPORTING_ONLY L'utilisateur peut uniquement créer et gérer des rapports.
LIMITED_REPORTING_ONLY L'utilisateur ne peut créer et gérer que les rapports suivants protégeant l'intégrité du client: Général, Performances en termes d'audience, Multipartenaire, Mot clé, ID d'ordre, Catégorie et Fournisseur de données tiers.
CREATIVE L'utilisateur peut afficher les informations sur le plan média dont il a besoin pour collaborer. En revanche, 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 sur le plan média dont il a besoin pour collaborer. En revanche, il n'a pas accès aux données sur les coûts ni à la place de marché. En outre, ils peuvent ajouter à l'entité d'autres administrateurs ou utilisateurs créatifs.

Méthodes

bulkEditAssignedUserRoles

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

create

Crée un utilisateur.

delete

Supprime un utilisateur.

get

Récupère un utilisateur.

list

Liste les utilisateurs auxquels l'utilisateur actuel peut accéder.

patch

Met à jour un utilisateur existant.