REST Resource: users

Zasób: User

Pojedynczy 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. Przypisany przez system.
email

string

Wymagane. Niezmienne. Adres e-mail używany do identyfikowania użytkownika.
displayName

string

Wymagane. Wyświetlana nazwa użytkownika.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
assignedUserRoles[]

object (AssignedUserRole)

Przypisane role użytkowników.

Wymagane w: users.create. Odpowiadaj tylko w języku users.patch. Można go zaktualizować tylko za pomocą users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

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

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

AssignedUserRole

Jedna przypisana rola użytkownika, która określa uprawnienia użytkownika do interakcji z określonym partnerem lub reklamodawcą.

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

string

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

enum (UserRole)

Wymagane. Rola użytkownika, którą chcesz przypisać użytkownikowi w przypadku danego elementu.

Wymagane.

Identyfikator podmiotu, do którego odnosi się przypisana rola użytkownika. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
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ę przypisana rola użytkownika.
Koniec pól wykluczających się nawzajem.

UserRole

Możliwe role użytkowników.

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 dotyczącymi tej jednostki. Mogą 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 podmiotowi partnerskiemu.
ADMIN_PARTNER_CLIENT Użytkownik może zarządzać kampaniami, kreacjami, zamówieniami reklamowymi, elementami zamówienia i raportami dotyczącymi tej jednostki. Mogą tworzyć i modyfikować konta innych ADMIN_PARTNER_CLIENT użytkowników oraz wyświetlać informacje rozliczeniowe. Nie mogą oni wyświetlać modeli przychodów, marż ani żadnych innych pól zawierających informacje poufne dla sprzedawcy. Tę rolę można przypisać tylko podmiotowi partnerskiemu.
STANDARD Użytkownik może zarządzać kampaniami, kreacjami, zamówieniami reklamowymi, elementami zamówienia i raportami dotyczącymi tej jednostki. Nie mogą tworzyć ani 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 podmiotu, w tym wszystkie dane o kosztach. Mogą tworzyć i modyfikować funkcje związane z planowaniem, m.in. 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 podmiotu. Mogą też tworzyć i modyfikować funkcje związane z planowaniem, m.in. 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 dotyczącymi tej jednostki. Nie mogą tworzyć ani modyfikować innych użytkowników ani wyświetlać informacji rozliczeniowych. Nie mogą oni wyświetlać modeli przychodów, marż ani żadnych innych pól zawierających informacje poufne dla sprzedawcy. Tę rolę można przypisać tylko do podmiotu reklamodawcy.
READ_ONLY Użytkownik może tylko tworzyć raporty i wyświetlać dane dotyczące tego elementu.
REPORTING_ONLY Użytkownik może tylko tworzyć raporty i nimi zarządzać.
LIMITED_REPORTING_ONLY Użytkownik może tworzyć tylko te bezpieczne dla klienta raporty (i nimi zarządzać): ogólny, skuteczności w pozyskiwaniu odbiorców, o różnych partnerach, o słowach kluczowych, o identyfikatorach zamówień, o kategoriach oraz o zewnętrznych dostawcach danych.
CREATIVE Użytkownik może wyświetlać informacje o media planie, których potrzebuje, 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, ale nie ma dostępu do danych o kosztach ani do Rynku. Mogą też dodawać do jednostki innych administratorów kreacji i użytkowników zarządzających kreacjami.

Metody

bulkEditAssignedUserRoles

 Zbiorcze edytowanie ról użytkownika.

create

 Tworzy nowego użytkownika.

delete

 Usuwa użytkownika.

get

 Pobiera użytkownika.

list

 Wyświetla listę użytkowników, do których ma dostęp bieżący użytkownik.

patch

 Aktualizuje istniejącego użytkownika.