Users

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

Representasi resource

Resource Pengguna mewakili akun yang terkait dengan perusahaan. Akun mungkin ditujukan khusus untuk perangkat atau untuk pengguna individu (yang kemudian dapat menggunakan akun di beberapa perangkat). Akun tersebut dapat memberikan akses ke Google Play terkelola saja, 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 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 jenis (userAccount, deviceAccount), tetapi pengguna yang dikelola Google (googleManaged) selalu berupa userAccount.

Nilai yang dapat diterima adalah:
  • "deviceAccount"
  • "userAccount"
displayName string Nama yang akan muncul di antarmuka pengguna. Penetapan properti ini bersifat opsional saat membuat pengguna yang dikelola EMM. Jika Anda menetapkan properti ini, gunakan nama yang bersifat umum tentang organisasi (seperti "Contoh, 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 googleManaged pengguna, sumber tepercayanya adalah Google, sehingga EMM harus memastikan Akun Google ada untuk pengguna tersebut. Dengan emmManaged pengguna, EMM memegang kendali.

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

Metode

hapus
Menghapus pengguna terkelola EMM.
generateAuthenticationToken
Membuat token autentikasi yang dapat digunakan klien kebijakan perangkat untuk menyediakan akun pengguna yang dikelola EMM pada perangkat. Token yang dibuat hanya dapat digunakan sekali dan masa berlakunya akan habis setelah beberapa menit.

Anda dapat menyediakan maksimum 10 perangkat per pengguna.

Panggilan telepon ini hanya berfungsi dengan akun yang dikelola EMM.
dapatkan
Mengambil detail pengguna.
getAvailableProductSet
Mengambil kumpulan produk yang berhak diakses oleh pengguna. Catatan: Item ini sudah tidak digunakan lagi. Integrasi baru tidak dapat menggunakan metode ini dan dapat membaca rekomendasi baru.
masukkan
Membuat pengguna baru yang dikelola EMM.

Resource Pengguna yang diteruskan di bagian isi permintaan harus menyertakan accountIdentifier dan accountType.

Jika pengguna yang sesuai sudah ada dengan ID akun yang sama, pengguna akan diperbarui dengan resource. Dalam hal ini, hanya kolom displayName yang dapat diubah.

list
Mencari pengguna berdasarkan alamat email utama. Tindakan 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 terkelola mereka.

Panggilan telepon ini hanya berfungsi dengan akun yang dikelola EMM.
setAvailableProductSet
Memodifikasi kumpulan produk yang dapat diakses pengguna (disebut sebagai produk yang diizinkan). Hanya produk yang disetujui atau produk yang sebelumnya disetujui (produk dengan persetujuan yang dicabut) yang dapat diizinkan. Catatan: Item ini sudah tidak digunakan lagi. Integrasi baru tidak dapat menggunakan metode ini dan dapat membaca rekomendasi baru.
perbarui
Memperbarui detail pengguna yang dikelola EMM.

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