Method: users.insert

Membuat pengguna.

Panggilan mutasi yang segera mengikuti pembuatan pengguna terkadang dapat gagal karena pengguna belum sepenuhnya dibuat akibat penundaan propagasi di backend kami. Periksa detail error untuk pesan "Pembuatan pengguna belum selesai" untuk melihat apakah ini penyebabnya. Mencoba ulang panggilan setelah beberapa saat dapat membantu dalam kasus ini.

Jika resolveConflictAccount disetel ke true, opsi yang dipilih untuk Menemukan dan menambahkan pengguna yang tidak dikelola akan diterapkan untuk mengatasi akun bentrok:

  • Kode respons 200 menunjukkan bahwa pengguna telah dibuat (atau menggantikan akun pribadi yang tidak dikelola yang sudah ada).
  • Kode respons 202 berarti ada akun pribadi yang tidak dikelola dan bertentangan, serta diundang untuk bergabung ke organisasi.
  • Kode respons 409 berarti ada akun yang bentrok sehingga pengguna tidak dibuat (misalnya, berdasarkan opsi yang dipilih untuk mempertahankan akun, atau jika email bentrok dengan akun kerja yang tidak dikelola atau pengguna terkelola yang ada).

Untuk mengetahui detail tentang cara mengatasi error akun duplikat, lihat Mengatasi error akun duplikat dan Mentransfer akun kerja yang tidak dikelola.

Permintaan HTTP

POST https://admin.googleapis.com/admin/directory/v1/users

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
resolveConflictAccount

boolean

Opsional. Menerapkan opsi yang dipilih untuk Menemukan dan menambahkan pengguna yang tidak dikelola untuk menyelesaikan masalah akun bentrok jika disetel ke true. Default: false

Isi permintaan

Isi permintaan memuat instance User.

Isi respons

Jika berhasil, isi respons akan memuat instance User yang baru dibuat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/admin.directory.user

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.