REST Resource: users

Referensi: Pengguna

Satu pengguna di Display & Video 360.

Representasi JSON
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
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 dienkode UTF-8 dengan ukuran maksimum 240 byte.

assignedUserRoles[]

object (AssignedUserRole)

Peran pengguna yang ditetapkan.

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

AssignedUserRole

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

partnerId

string (int64 format)

ID partner tempat peran pengguna yang ditetapkan diterapkan.

advertiserId

string (int64 format)

ID pengiklan tempat peran pengguna ditugaskan.

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, perjanjian 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, perjanjian 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 untuk reseller. Peran ini hanya dapat ditetapkan untuk entitas partner.
STANDARD Pengguna dapat mengelola kampanye, materi iklan, perjanjian 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, perjanjian 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, perjanjian 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, perjanjian 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 untuk reseller. 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 berikut yang aman untuk klien: 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 seorang 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 ada.