REST Resource: users

Zasób: User

Jeden użytkownik w Display & Video 360.

Zapis JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu użytkownika.
userId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator użytkownika. Przypisana przez system.
email

string

To pole jest wymagane. Stałe. Adres e-mail używany do identyfikacji użytkownika.
displayName

string

To pole jest wymagane. Nazwa wyświetlana użytkownika.

Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów.
assignedUserRoles[]

object (AssignedUserRole)

Przypisane role użytkownika.

Wymagane w języku: users.create. Wyniki tylko w users.patch. Można go aktualizować tylko do users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniego logowania użytkownika w interfejsie DV360.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

AssignedUserRole

Pojedyncza przypisana rola użytkownika, która określa autoryzowaną interakcję użytkownika z określonym partnerem lub reklamodawcą.

Zapis JSON 
{
  "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.
}
Pola
assignedUserRoleId

string

Tylko dane wyjściowe. Identyfikator przypisanej roli użytkownika.
userRole

enum (UserRole)

To pole jest wymagane. Rola użytkownika do przypisania użytkownikowi w przypadku elementu.

Pole sumy entity_id. To pole jest wymagane.

Identyfikator jednostki, do której odnosi się przypisana rola użytkownika. entity_id może być tylko jedną z tych wartości:
partnerId

string (int64 format)

Identyfikator partnera, do którego odnosi się przypisana rola użytkownika.
advertiserId

string (int64 format)

Identyfikator reklamodawcy, do którego odnosi się rola przypisanego użytkownika.

UserRole

Możliwe role użytkownika.

Wartości w polu enum
USER_ROLE_UNSPECIFIED Wartość domyślna, gdy rola użytkownika nie jest określona lub jest nieznana w tej wersji.
ADMIN Użytkownik może zarządzać kampaniami, kreacjami, zamówieniami reklamowymi, elementami zamówienia i raportami związanymi z elementem. Może wyświetlać i edytować informacje rozliczeniowe, tworzyć i modyfikować użytkowników oraz włączać i wyłączać giełdy. Tę rolę można przypisać tylko do podmiotu partnerskiego.
ADMIN_PARTNER_CLIENT Użytkownik może zarządzać kampaniami, kreacjami, zamówieniami reklamowymi, elementami zamówienia i raportami związanymi z elementem. Może tworzyć i modyfikować innych użytkowników ADMIN_PARTNER_CLIENT oraz wyświetlać informacje rozliczeniowe. Nie mogą wyświetlać modeli przychodów, narzutów ani żadnych innych pól istotnych dla sprzedawców. Tę rolę można przypisać tylko do podmiotu partnerskiego.
STANDARD Użytkownik może zarządzać kampaniami, kreacjami, zamówieniami reklamowymi, elementami zamówienia i raportami związanymi z elementem. Nie mogą tworzyć i modyfikować użytkowników ani wyświetlać informacji rozliczeniowych.
STANDARD_PLANNER Użytkownik może wyświetlać wszystkie kampanie, kreacje, zamówienia reklamowe, elementy zamówienia i raporty dotyczące danego elementu, w tym wszystkie dane o kosztach. Mogą tworzyć i modyfikować funkcje związane z planowaniem, w tym plany i zasoby reklamowe.
STANDARD_PLANNER_LIMITED Użytkownik może wyświetlać wszystkie kampanie, kreacje, zamówienia reklamowe, elementy zamówienia i raporty dotyczące elementu. Mogą tworzyć i modyfikować funkcje związane z planowaniem, w tym plany i zasoby reklamowe. Nie mają dostępu do danych o kosztach i nie mogą rozpoczynać, akceptować ani negocjować umów.
STANDARD_PARTNER_CLIENT Użytkownik może zarządzać kampaniami, kreacjami, zamówieniami reklamowymi, elementami zamówienia i raportami związanymi z elementem. Nie mogą tworzyć ani modyfikować innych użytkowników ani wyświetlać informacji rozliczeniowych. Nie mogą wyświetlać modeli przychodów, narzutów ani żadnych innych pól istotnych dla sprzedawców. Tę rolę można przypisać tylko reklamodawcy.
READ_ONLY Użytkownik może tylko tworzyć raporty i wyświetlać dane dotyczące elementu.
REPORTING_ONLY Użytkownik może tylko tworzyć raporty i nimi zarządzać.
LIMITED_REPORTING_ONLY Użytkownik może tworzyć tylko te raporty bezpieczne dla klienta i nimi zarządzać: ogólny, skuteczności w pozyskiwaniu odbiorców, o różnych partnerach, o słowach kluczowych, o identyfikatorach zamówienia, o kategoriach oraz o zewnętrznych dostawcach danych.
CREATIVE Użytkownik może wyświetlać informacje o media planie, których potrzebuje do współpracy, ale nie ma dostępu do danych o kosztach ani do Rynku.
CREATIVE_ADMIN Użytkownik może wyświetlać informacje o media planie, których potrzebuje do współpracy, ale nie ma dostępu do danych o kosztach ani do Rynku. Dodatkowo może on dodawać do elementu innych administratorów kreacji i użytkowników zarządzających kreacjami.

Metody

bulkEditAssignedUserRoles

 Zbiorcze edytowanie ról użytkowników.

create

 Tworzy nowego użytkownika.

delete

 Usuwa użytkownika.

get

 Pobiera użytkownika.

list

 Wyświetla listę użytkowników, którzy są dostępni dla bieżącego użytkownika.

patch

 Aktualizuje istniejącego użytkownika.