REST Resource: users

Ressource: Nutzer

Ein einzelner Nutzer im Displaynetzwerk und Video 360

JSON-Darstellung
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
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.

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 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 User-Rolle 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 oder ändern und 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. Er kann keine Umsatzmodelle, Aufschläge oder andere sensible Felder für Reseller aufrufen. 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 Element 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 oder ändern. 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 die Entität verwalten. Sie können keine anderen Nutzer erstellen oder bearbeiten oder Zahlungsinformationen einsehen. Er kann keine Umsatzmodelle, Aufschläge oder andere sensible Felder für Reseller aufrufen. Diese Rolle kann nur für eine Werbetreibendenentitä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, aber er kann keine kostenbezogenen Daten oder den Marktplatz aufrufen. 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.