REST Resource: users

Resource: Pengguna

Satu pengguna di Display & Video 360.

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

string

Hanya output. Nama resource pengguna.
userId

string (int64 format)

Hanya output. ID unik pengguna. Ditugaskan oleh sistem.
email

string

Wajib. Tidak dapat diubah. Alamat email yang digunakan untuk mengidentifikasi pengguna.
displayName

string

Wajib. Nama tampilan pengguna.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.
assignedUserRoles[]

object (AssignedUserRole)

Peran pengguna yang ditetapkan.

Wajib di users.create. Hanya output di users.patch. Hanya dapat diperbarui melalui users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Hanya output. Stempel waktu saat pengguna terakhir kali login ke UI DV360.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

AssignedUserRole

Satu peran pengguna yang ditetapkan, yang menentukan interaksi pengguna yang diotorisasi dengan partner atau pengiklan tertentu.

Representasi 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.
}
Kolom
assignedUserRoleId

string

Hanya output. ID peran pengguna yang ditetapkan.
userRole

enum (UserRole)

Wajib. Peran pengguna yang akan ditetapkan kepada pengguna untuk entitas.

Kolom union entity_id. Wajib.

ID entitas tempat peran pengguna yang ditetapkan berlaku. entity_id hanya dapat berupa salah satu dari hal berikut:
partnerId

string (int64 format)

ID partner tempat peran pengguna yang ditetapkan berlaku.
advertiserId

string (int64 format)

ID pengiklan yang menjadi tujuan peran pengguna yang ditetapkan.

UserRole

Kemungkinan peran pengguna.

Enum
USER_ROLE_UNSPECIFIED Nilai default saat peran pengguna tidak ditentukan atau tidak diketahui dalam versi ini.
ADMIN Pengguna dapat mengelola kampanye, materi iklan, pesanan pemasangan, item baris, dan laporan untuk entitas tersebut. Mereka dapat melihat dan mengedit informasi penagihan, membuat atau mengubah pengguna, serta mengaktifkan atau menonaktifkan bursa. Peran ini hanya dapat ditetapkan untuk entitas partner.
ADMIN_PARTNER_CLIENT Pengguna dapat mengelola kampanye, materi iklan, pesanan pemasangan, item baris, dan laporan untuk entitas tersebut. Mereka dapat membuat dan mengubah pengguna ADMIN_PARTNER_CLIENT lainnya serta melihat informasi penagihan. Mereka tidak dapat melihat model pendapatan, markup, atau kolom sensitif reseller lainnya. Peran ini hanya dapat ditetapkan untuk entitas partner.
STANDARD Pengguna dapat mengelola kampanye, materi iklan, pesanan pemasangan, item baris, dan laporan untuk entitas tersebut. Mereka tidak dapat membuat dan mengubah pengguna atau melihat informasi penagihan.
STANDARD_PLANNER Pengguna dapat melihat semua kampanye, materi iklan, pesanan pemasangan, item baris, dan laporan untuk entitas, termasuk semua data biaya. Mereka dapat membuat dan mengubah fitur terkait perencanaan, termasuk rencana dan inventaris.
STANDARD_PLANNER_LIMITED Pengguna dapat melihat semua kampanye, materi iklan, pesanan pemasangan, item baris, dan laporan untuk entitas tersebut. Mereka dapat membuat atau mengubah fitur terkait perencanaan, termasuk rencana dan inventaris. Mereka tidak memiliki akses ke data biaya dan tidak dapat memulai, menerima, atau menegosiasikan kesepakatan.
STANDARD_PARTNER_CLIENT Pengguna dapat mengelola kampanye, materi iklan, pesanan pemasangan, item baris, dan laporan untuk entitas tersebut. Mereka tidak dapat membuat atau mengubah pengguna lain atau melihat informasi penagihan. Mereka tidak dapat melihat model pendapatan, markup, atau kolom sensitif reseller lainnya. Peran ini hanya dapat ditetapkan untuk entitas pengiklan.
READ_ONLY Pengguna hanya dapat membuat laporan dan melihat data untuk entitas.
REPORTING_ONLY Pengguna hanya dapat membuat dan mengelola laporan.
LIMITED_REPORTING_ONLY Pengguna hanya dapat membuat dan mengelola laporan aman klien berikut: Umum, Performa Audiens, Lintas Partner, Kata Kunci, ID Pesanan, Kategori, dan Penyedia Data Pihak Ketiga.
CREATIVE Pengguna dapat melihat informasi rencana media yang diperlukan untuk berkolaborasi, tetapi tidak dapat melihat data terkait biaya atau Marketplace.
CREATIVE_ADMIN Pengguna dapat melihat informasi rencana media yang diperlukan untuk berkolaborasi, tetapi tidak dapat melihat data terkait biaya atau Marketplace. Selain itu, mereka dapat menambahkan admin materi iklan atau pengguna materi iklan lain ke entitas.

Metode

bulkEditAssignedUserRoles

 Mengedit peran pengguna secara massal untuk pengguna.

create

 Membuat pengguna baru.

delete

 Menghapus pengguna.

get

 Mendapatkan pengguna.

list

 Mencantumkan pengguna yang dapat diakses oleh pengguna saat ini.

patch

 Memperbarui pengguna yang sudah ada.