Method: users.insert
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir kullanıcı oluşturur.
Arka uçlarımızdaki dağıtım gecikmesi nedeniyle kullanıcı tam olarak oluşturulmadığından, kullanıcı oluşturma işleminden hemen sonra yapılan mutasyon çağrıları bazen başarısız olabilir. Bunun olup olmadığını görmek için "Kullanıcı oluşturma işlemi tamamlanmadı" mesajının hata ayrıntılarını kontrol edin. Bu durumda, aramaları bir süre sonra tekrar denemek faydalı olabilir.
resolveConflictAccount
true
olarak ayarlanmışsa 202
yanıt kodu, çakışan bir yönetilmeyen hesabın mevcut olduğu ve kuruluşa katılmaya davet edildiği anlamına gelir. 409
yanıt kodu, çakışan bir hesap bulunduğundan kullanıcının, seçilen yönetilmeyen kullanıcı hesaplarını yönetme seçeneğine göre oluşturulmadığı anlamına gelir.
HTTP isteği
POST https://admin.googleapis.com/admin/directory/v1/users
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler |
resolveConflictAccount |
boolean
İsteğe bağlı. true olarak ayarlanırsa yönetilmeyen kullanıcı hesaplarını işleme için seçilen seçenek geçerli olur. Varsayılan: false
|
İstek içeriği
İstek metni, User
öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt metni, yeni oluşturulmuş bir User
örneği içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/admin.directory.user
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Method: users.insert\n\nCreates a user.\n\nMutate calls immediately following user creation might sometimes fail as the user isn't fully created due to propagation delay in our backends. Check the error details for the \"User creation is not complete\" message to see if this is the case. Retrying the calls after some time can help in this case.\n\nIf `resolveConflictAccount` is set to `true`, a `202` response code means that a conflicting unmanaged account exists and was invited to join the organization. A `409` response code means that a conflicting account exists so the user wasn't created based on the [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) option selected.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/users`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resolveConflictAccount` | `boolean` Optional. If set to `true`, the option selected for [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) will apply. Default: `false` |\n\n### Request body\n\nThe request body contains an instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.user`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]