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. Ditetapkan 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. Output hanya dalam 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 maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

AssignedUserRole

Satu peran pengguna yang ditetapkan, yang menentukan interaksi yang sah yang dilakukan pengguna 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 yang berikut:
partnerId

string (int64 format)

ID partner yang menerapkan peran pengguna yang ditetapkan.
advertiserId

string (int64 format)

ID pengiklan yang dikenai peran pengguna assigend.

UserRole

Kemungkinan peran pengguna.

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

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.