Users

Untuk daftar metode untuk resource ini, lihat bagian akhir halaman ini.

Representasi resource

Resource Pengguna mewakili akun yang terkait dengan perusahaan. Akun mungkin spesifik untuk satu perangkat atau pengguna individu (yang kemudian dapat menggunakan akun di beberapa perangkat). Akun tersebut dapat memberikan akses hanya ke Google Play terkelola, atau ke layanan Google lainnya, bergantung pada model identitas:

  • Model identitas domain yang dikelola Google memerlukan sinkronisasi ke sumber Akun Google (melalui primaryEmail).
  • Model identitas Akun Google Play terkelola memberikan cara yang dinamis bagi perusahaan untuk membuat akun pengguna atau perangkat sesuai kebutuhan. Akun ini memberikan akses ke Google Play terkelola.

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
Nama properti Nilai Deskripsi Catatan
accountIdentifier string ID unik yang Anda buat untuk pengguna ini, seperti "user342" atau "asset#44418". Jangan gunakan informasi identitas pribadi (PII) untuk properti ini. Harus selalu ditetapkan untuk pengguna yang dikelola EMM. Tidak ditetapkan untuk pengguna yang dikelola Google.
accountType string Jenis akun yang diwakili pengguna ini. userAccount dapat diinstal di beberapa perangkat, tetapi deviceAccount dikhususkan untuk satu perangkat. Pengguna yang dikelola EMM (emmManaged) dapat berupa salah satu jenis (userAccount, deviceAccount), tetapi pengguna yang dikelola Google (googleManaged) selalu userAccount.

Nilai yang dapat diterima:
  • "deviceAccount"
  • "userAccount"
displayName string Nama yang akan muncul di antarmuka pengguna. Menyetel properti ini bersifat opsional saat membuat pengguna yang dikelola EMM. Jika Anda menetapkan properti ini, gunakan nama yang umum tentang organisasi (seperti "Example, Inc.") atau nama Anda (sebagai EMM). Tidak digunakan untuk akun pengguna yang dikelola Google. dapat ditulis
id string ID unik untuk pengguna.

kind string
managementType string Entitas yang mengelola pengguna. Dengan pengguna googleManaged, sumber tepercaya adalah Google sehingga EMM harus memastikan Akun Google ada untuk pengguna. Dengan emmManaged pengguna, EMM yang memegang kendali.

Nilai yang dapat diterima:
  • "emmManaged"
  • "googleManaged"
primaryEmail string Alamat email utama pengguna, misalnya, "jsurya@example.com". Akan selalu ditetapkan untuk pengguna yang dikelola Google dan tidak ditetapkan untuk pengguna terkelola EMM.

Metode

hapus
Menghapus pengguna yang dikelola EMM.
generateAuthenticationToken
Membuat token autentikasi yang dapat digunakan klien kebijakan perangkat untuk menyediakan akun pengguna yang dikelola EMM tertentu di perangkat. Token yang dihasilkan sekali pakai dan akan habis masa berlakunya setelah beberapa menit.

Anda dapat menyediakan maksimum 10 perangkat per pengguna.

Panggilan ini hanya berfungsi dengan akun yang dikelola EMM.
dapatkan
Mengambil detail pengguna.
getAvailableProductSet
Mengambil kumpulan produk yang berhak diakses pengguna.
sisipkan
Membuat pengguna baru yang dikelola EMM.

Resource Users yang diteruskan dalam isi permintaan harus menyertakan accountIdentifier dan accountType.

Jika sudah ada pengguna yang sesuai dengan ID akun yang sama, pengguna tersebut akan diberi tahu tentang resource tersebut. Dalam kasus ini, hanya kolom displayName yang dapat diubah.

list
Mencari pengguna berdasarkan alamat email utama. Fitur ini hanya didukung untuk pengguna yang dikelola Google. Pencarian ID tidak diperlukan untuk pengguna yang dikelola EMM karena ID sudah ditampilkan dalam hasil panggilan Users.insert.
revokeDeviceAccess
Mencabut akses ke semua perangkat yang saat ini disediakan untuk pengguna. Pengguna tidak akan dapat lagi menggunakan Play Store terkelola di perangkat yang dikelolanya.

Panggilan ini hanya berfungsi dengan akun yang dikelola EMM.
setAvailableProductSet
Memodifikasi kumpulan produk yang dapat diakses oleh pengguna (disebut sebagai produk yang whitelisted). Hanya produk yang disetujui atau produk yang sebelumnya disetujui (produk dengan persetujuan yang dicabut) yang dapat diizinkan.
info terbaru
Memperbarui detail pengguna terkelola EMM.

Hanya dapat digunakan dengan pengguna yang dikelola EMM (bukan pengguna yang dikelola Google). Teruskan detail baru di resource Users dalam isi permintaan. Hanya kolom displayName yang dapat diubah. Kolom lain harus tidak disetel atau memiliki nilai yang saat ini aktif.