Method: users.insert

사용자를 만듭니다.

사용자 생성 직후의 변이 호출은 백엔드의 전파 지연으로 인해 사용자가 완전히 생성되지 않아 실패할 수 있습니다. '사용자 생성이 완료되지 않음' 메시지의 오류 세부정보를 확인하여 이 경우인지 확인하세요. 이 경우 잠시 후 통화를 다시 시도하면 도움이 될 수 있습니다.

resolveConflictAccounttrue로 설정된 경우 비관리 사용자 찾기 및 추가하기에 선택된 옵션이 중복 계정을 해결하는 데 적용됩니다.

  • 200 응답 코드는 사용자가 생성되었거나 기존 비관리 개인 계정을 대체했음을 나타냅니다.
  • 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

자세한 내용은 승인 가이드를 참고하세요.