Method: users.insert
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает пользователя.
Вызовы Mutate сразу после создания пользователя могут иногда завершаться неудачно, поскольку пользователь не создается полностью из-за задержки распространения в наших серверных модулях. Проверьте сведения об ошибке для сообщения «Создание пользователя не завершено», чтобы убедиться, что это так. В этом случае может помочь повторная попытка вызова через некоторое время.
Если для resolveConflictAccount
установлено значение true
, код ответа 202
означает, что существует конфликтующая неуправляемая учетная запись, и ей было предложено присоединиться к организации. Код ответа 409
означает, что существует конфликтующая учетная запись, поэтому пользователь не был создан на основе выбранного параметра обработки неуправляемых учетных записей пользователей .
HTTP-запрос
POST https://admin.googleapis.com/admin/directory/v1/users
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры |
---|
resolveConflictAccount | boolean Необязательный. Если установлено значение true , будет применен параметр, выбранный для обработки неуправляемых учетных записей пользователей . По умолчанию: false |
Тело запроса
Тело запроса содержит экземпляр User
.
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр User
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/admin.directory.user
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 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)."]]