Users: insert
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
새 EMM 관리 사용자를 만듭니다.
Users 리소스
호출 본문에는
accountIdentifier 및 accountType
동일한 계정 식별자를 가진 해당 사용자가 이미 있는 경우
사용자는 리소스로 업데이트됩니다. 이 경우에는
displayName 필드는 변경할 수 있습니다.
요청
HTTP 요청
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
매개변수
| 매개변수 이름 |
값 |
설명 |
| 경로 매개변수 |
enterpriseId |
string |
기업의 ID입니다.
|
승인
다음 범위를 사용하여 이 요청을 인증받아야 합니다.
| 범위 |
|---|
https://www.googleapis.com/auth/androidenterprise |
자세한 내용은 인증 및 승인 페이지를 참조하세요.
요청 본문
요청 본문에서 다음의 속성과 함께 Users 리소스를 제공합니다.
| 속성 이름 |
값 |
설명 |
참고 |
| 필수 속성 |
accountIdentifier |
string |
이 사용자에 대해 생성한 고유 식별자(예: 'user342') 'asset#44418'과 같이 입력하세요. 이 속성에 개인 식별 정보 (PII)를 사용하지 마세요. EMM 관리 사용자의 경우 항상 설정해야 합니다. Google 관리 사용자에게는 설정되지 않습니다. |
|
accountType |
string |
이 사용자가 나타내는 계정의 유형입니다. userAccount는 여러 기기에 설치할 수 있지만 deviceAccount는 단일 기기에만 적용됩니다. EMM 관리 사용자 (emmManaged)는 다음 유형 (userAccount, deviceAccount) 중 하나일 수 있지만, Google 관리 사용자 (googleManaged)는 항상 userAccount입니다.
사용 가능한 값은 다음과 같습니다.
<ph type="x-smartling-placeholder"></ph>
- "
deviceAccount"
- "
userAccount"
|
|
응답
요청에 성공할 경우 이 메서드는 응답 본문에 Users 리소스를 반환합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eCreates or updates an EMM-managed user within a specified enterprise.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eaccountIdentifier\u003c/code\u003e and \u003ccode\u003eaccountType\u003c/code\u003e to define the user.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003e/enterprises/enterpriseId/users\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003edisplayName\u003c/code\u003e is the only field that can be updated for existing users.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary.\u003c/p\u003e\n"]]],[],null,["# Users: insert\n\n| **Note:** Requires [authorization](#auth).\n\nCreates a new EMM-managed user.\n\n\u003cbr /\u003e\n\n\nThe [Users](/android/work/play/emm-api/v1/users) resource\npassed in the body of the request should include an\n`accountIdentifier` and an `accountType`.\n\nIf a corresponding user already exists with the same account identifier,\nthe user will be updated with the resource. In this case only the\n`displayName` field can be changed.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Users resource](/android/work/play/emm-api/v1/users#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\n| `accountIdentifier` | `string` | A unique identifier you create for this user, such as \"user342\" or \"asset#44418\". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users. | |\n| `accountType` | `string` | The type of account that this user represents. A `userAccount` can be installed on multiple devices, but a `deviceAccount` is specific to a single device. An EMM-managed user (`emmManaged`) can be either type (`userAccount`, `deviceAccount`), but a Google-managed user (`googleManaged`) is always a `userAccount`. \u003cbr /\u003e Acceptable values are: - \"`deviceAccount`\" - \"`userAccount`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a [Users resource](/android/work/play/emm-api/v1/users#resource) in the response body."]]
