REST Resource: users

Ressource: Nutzer

Ein einzelner Nutzer in Display &Video 360

JSON-Darstellung 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname des Nutzers.
userId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Nutzers. Vom System zugewiesen.
email

string

Erforderlich. Nicht veränderbar. Die E-Mail-Adresse, die zur Identifizierung des Nutzers verwendet wird.
displayName

string

Erforderlich. Der Anzeigename des Nutzers.

Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein.
assignedUserRoles[]

object (AssignedUserRole)

Die zugewiesenen Nutzerrollen.

Erforderlich in users.create. Nur in users.patch ausgeben. Kann nur bis zum users.bulkEditAssignedUserRoles aktualisiert werden.
lastLoginTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, zu dem der Nutzer sich zuletzt in der DV360-Benutzeroberfläche angemeldet hat.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

AssignedUserRole

Eine einzelne zugewiesene Nutzerrolle, mit der die autorisierte Interaktion eines Nutzers mit einem bestimmten Partner oder Werbetreibenden definiert wird.

JSON-Darstellung 
{
  "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.
}
Felder
assignedUserRoleId

string

Nur Ausgabe. Die ID der zugewiesenen Nutzerrolle.
userRole

enum (UserRole)

Erforderlich. Die Nutzerrolle, die einem Nutzer für das Rechtssubjekt zugewiesen werden soll.

Union-Feld entity_id. Erforderlich.

Die ID der Entität, auf die sich die zugewiesene Nutzerrolle bezieht. Für entity_id ist nur einer der folgenden Werte zulässig:
partnerId

string (int64 format)

Die ID des Partners, für den die zugewiesene Nutzerrolle gilt.
advertiserId

string (int64 format)

Die ID des Werbetreibenden, für den die zugewiesene Nutzerrolle gilt.

UserRole

Mögliche Nutzerrollen.

Enums
USER_ROLE_UNSPECIFIED Standardwert, wenn die Nutzerrolle nicht angegeben oder in dieser Version unbekannt ist.
ADMIN Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Entität verwalten. Sie können Zahlungsinformationen aufrufen und bearbeiten, Nutzer erstellen und bearbeiten sowie Anzeigenplattformen aktivieren oder deaktivieren. Diese Rolle kann nur für eine Partnerentität zugewiesen werden.
ADMIN_PARTNER_CLIENT Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für das Rechtssubjekt verwalten. Sie können andere ADMIN_PARTNER_CLIENT-Nutzer erstellen und ändern sowie Zahlungsinformationen einsehen. Sie können keine Umsatzmodelle, Markups oder andere für Reseller vertrauliche Felder sehen. Diese Rolle kann nur für eine Partnerentität zugewiesen werden.
STANDARD Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Entität verwalten. Sie können keine Nutzer erstellen und ändern oder Zahlungsinformationen einsehen.
STANDARD_PLANNER Der Nutzer kann alle Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für das Rechtssubjekt aufrufen, einschließlich aller Kostendaten. Sie können planungsbezogene Funktionen wie Pläne und Inventar erstellen und bearbeiten.
STANDARD_PLANNER_LIMITED Der Nutzer kann alle Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für das Rechtssubjekt aufrufen. Außerdem können sie planungsbezogene Funktionen wie Pläne und Inventar erstellen und bearbeiten. Sie haben keinen Zugriff auf Kostendaten und können keine Deals starten, annehmen oder verhandeln.
STANDARD_PARTNER_CLIENT Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für das Rechtssubjekt verwalten. Sie können keine anderen Nutzer erstellen oder ändern oder Zahlungsinformationen einsehen. Sie können keine Umsatzmodelle, Markups oder andere für Reseller vertrauliche Felder sehen. Diese Rolle kann nur für eine Werbetreibenden-Entität zugewiesen werden.
READ_ONLY Der Nutzer kann nur Berichte für die Entität erstellen und Daten aufrufen.
REPORTING_ONLY Der Nutzer kann nur Berichte erstellen und verwalten.
LIMITED_REPORTING_ONLY Der Nutzer kann nur die folgenden kundensicheren Berichte erstellen und verwalten: „Allgemein“, „Zielgruppenleistung“, „Partnerübergreifend“, „Keyword“, „Auftrags-ID“, „Kategorie“ und „Drittdatenanbieter“.
CREATIVE Der Nutzer kann Informationen zu Mediaplänen aufrufen, die er für die Zusammenarbeit benötigt, aber er kann keine kostenbezogenen Daten oder den Marktplatz aufrufen.
CREATIVE_ADMIN Der Nutzer kann Informationen zu Mediaplänen aufrufen, die er für die Zusammenarbeit benötigt. Er hat jedoch keinen Zugriff auf kostenbezogene Daten oder den Marktplatz. Außerdem können sie der Entität weitere Creative-Administratoren oder Creative-Nutzer hinzufügen.

Methoden

bulkEditAssignedUserRoles

 Bulk-Bearbeitung von Nutzerrollen für einen Nutzer.

create

 Erstellt einen neuen Nutzer.

delete

 Löscht einen Nutzer.

get

 Ruft einen Nutzer ab.

list

 Listet die Nutzer auf, auf die der aktuelle Nutzer zugreifen kann.

patch

 Aktualisiert einen vorhandenen Nutzer.