REST Resource: users

Resource: Pengguna

Satu pengguna di kampanye 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 diisi. Tidak dapat diubah. Alamat email yang digunakan untuk mengidentifikasi pengguna.

displayName

string

Wajib diisi. 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.

AssignedUserRole

Peran pengguna yang ditetapkan tunggal, yang menentukan interaksi yang diizinkan seorang 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 diisi. Peran pengguna yang akan ditetapkan kepada pengguna untuk entitas.

Kolom union entity_id. Wajib diisi.

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

partnerId

string (int64 format)

ID partner tempat peran pengguna yang ditetapkan diterapkan.

advertiserId

string (int64 format)

ID pengiklan yang dikenai penerapan peran pengguna assigend.

UserRole

Peran pengguna yang mungkin.

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 iklan, 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 iklan, 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 iklan, 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 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 kesepakatan.
STANDARD_PARTNER_CLIENT Pengguna dapat mengelola kampanye, materi iklan, pesanan pemasangan iklan, item baris, dan laporan untuk entitas tersebut. Pengguna 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 entity.
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 media plan yang diperlukan untuk berkolaborasi, tetapi tidak dapat melihat Marketplace atau data terkait biaya.
CREATIVE_ADMIN Pengguna dapat melihat informasi media plan yang diperlukan untuk berkolaborasi, tetapi tidak dapat melihat Marketplace atau data terkait biaya. Selain itu, mereka dapat menambahkan admin materi iklan atau pengguna materi iklan lainnya 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 ada.