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 Ausgabe in users.patch. Kann nur über users.bulkEditAssignedUserRoles aktualisiert werden.
lastLoginTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

AssignedUserRole

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

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

string

Nur Ausgabe. Die ID der zugewiesenen Nutzerrolle.
userRole

enum (UserRole)

Erforderlich. Die Nutzerrolle, die einem Nutzer für die Entität zugewiesen werden soll.

Erforderlich.

Die ID der Einheit, für die die zugewiesene Nutzerrolle gilt. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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.
Ende der sich gegenseitig ausschließenden Felder.

UserRole

Mögliche Nutzerrollen

Enums
USER_ROLE_UNSPECIFIED Standardwert, wenn die Nutzerrolle in dieser Version nicht angegeben oder unbekannt ist.
ADMIN Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Einheit verwalten. Sie können Zahlungsinformationen aufrufen und bearbeiten, Nutzer erstellen oder ändern und Börsen aktivieren oder deaktivieren. Diese Rolle kann nur für eine Partnerorganisation zugewiesen werden.
ADMIN_PARTNER_CLIENT Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Einheit verwalten. Sie können andere ADMIN_PARTNER_CLIENT-Nutzer erstellen und ändern sowie Zahlungsinformationen aufrufen. Sie können keine Umsatzmodelle, Aufschläge oder andere für Reseller vertrauliche Felder sehen. Diese Rolle kann nur für eine Partnerorganisation zugewiesen werden.
STANDARD Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Einheit verwalten. Sie können keine Nutzer erstellen und ändern und keine Zahlungsinformationen aufrufen.
STANDARD_PLANNER Der Nutzer kann alle Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Einheit aufrufen, einschließlich aller Kostendaten. Außerdem können sie 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 die Einheit 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 aushandeln.
STANDARD_PARTNER_CLIENT Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Einheit verwalten. Sie können keine anderen Nutzer erstellen oder ändern und keine Zahlungsinformationen aufrufen. Sie können keine Umsatzmodelle, Aufschläge oder andere für Reseller vertrauliche Felder sehen. Diese Rolle kann nur für eine Werbetreibenden-Einheit zugewiesen werden.
READ_ONLY Der Nutzer kann nur Berichte erstellen und Daten für die Entität 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“, „Bestell-ID“, „Kategorie“ und „Drittdatenanbieter“.
CREATIVE 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.
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 Einheit andere Creative-Administratoren oder Creative-Nutzer hinzufügen.

Methoden

bulkEditAssignedUserRoles

 Ändert die Nutzerrollen für einen Nutzer im Bulk.

create

 Erstellt einen neuen Nutzer.

delete

 Löscht einen Nutzer.

get

 Ruft einen Nutzer ab.

list

 Listet Nutzer auf, auf die der aktuelle Nutzer Zugriff hat.

patch

 Aktualisiert einen vorhandenen Nutzer.