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, mit der der Nutzer identifiziert wird.
displayName

string

Erforderlich. Der Anzeigename des Nutzers.

Muss UTF-8-codiert sein und darf maximal 240 Byte lang 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),

  // 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 die Einheit zugewiesen werden soll.

Union-Feld entity_id. Erforderlich.

Die ID der Einheit, für die die zugewiesene Nutzerrolle gilt. 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 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 sowie Anzeigenplattformen 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 bearbeiten 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 bearbeiten 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. 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 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 Deals weder starten noch annehmen oder verhandeln.
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 bearbeiten 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“, „Auftrags-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-Verfahren.

create

 Erstellt einen neuen Nutzer.

delete

 Löscht einen Nutzer.

get

 Ruft einen Nutzer ab.

list

 Hier werden alle Nutzer angezeigt, auf die der aktuelle Nutzer zugreifen kann.

patch

 Aktualisiert einen vorhandenen Nutzer.