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 groß sein.
assignedUserRoles[]

object (AssignedUserRole)

Die zugewiesenen Nutzerrollen.

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

string (Timestamp format)

Nur Ausgabe Der Zeitstempel der letzten Anmeldung des Nutzers in der DV360-Benutzeroberfläche.

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

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 Entität zugewiesen werden soll.

Union-Feld entity_id. Erforderlich.

Die ID der Entität, 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 Rolle des blockierten Nutzers 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 oder ändern 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 die Entität verwalten. Sie können andere ADMIN_PARTNER_CLIENT-Nutzer erstellen und ändern sowie Zahlungsinformationen einsehen. Sie können keine Umsatzmodelle, Markups oder andere Felder aufrufen, die für Reseller relevant sind. 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 jedoch keine Nutzer erstellen und ändern oder Zahlungsinformationen aufrufen.
STANDARD_PLANNER Der Nutzer kann alle Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Entität aufrufen, einschließlich aller Kostendaten. Sie können planungsbezogene Funktionen wie Pläne und Inventar erstellen und ändern.
STANDARD_PLANNER_LIMITED Der Nutzer kann alle Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für das Element aufrufen. Sie können planungsbezogene Funktionen wie Pläne und Inventar erstellen und ändern. Er hat keinen Zugriff auf Kostendaten und kann keine Deals starten, annehmen oder verhandeln.
STANDARD_PARTNER_CLIENT Der Nutzer kann Kampagnen, Creatives, Anzeigenaufträge, Werbebuchungen und Berichte für die Entität verwalten. Sie können keine anderen Nutzer erstellen oder ändern und keine Zahlungsinformationen aufrufen. Sie können keine Umsatzmodelle, Markups oder andere Felder aufrufen, die für Reseller relevant sind. Diese Rolle kann nur für eine Werbetreibendenentität zugewiesen werden.
READ_ONLY Der Nutzer kann für die Entität nur Berichte 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 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, aber keine kostenbezogenen Daten oder den Marktplatz aufrufen. Außerdem haben sie die Möglichkeit, der Entität weitere Creative-Administratoren oder Creative-Nutzer hinzuzufü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 Nutzer auf, auf die der aktuelle Nutzer zugreifen kann.

patch

 Aktualisiert einen vorhandenen Nutzer.