Users: list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
기본 이메일 주소로 사용자를 조회합니다.
이 기능은 Google 관리 사용자에게만 지원됩니다. ID 조회가 올바르지 않음
ID가 이미
Users.insert 호출의 결과를 표시합니다.
요청
HTTP 요청
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
매개변수
매개변수 이름 |
값 |
설명 |
경로 매개변수 |
enterpriseId |
string |
기업의 ID입니다.
|
필수 쿼리 매개변수 |
email |
string |
조회할 사용자의 정확한 기본 이메일 주소입니다.
|
승인
다음 범위를 사용하여 이 요청을 인증받아야 합니다.
범위 |
https://www.googleapis.com/auth/androidenterprise |
자세한 내용은 인증 및 승인 페이지를 참조하세요.
요청 본문
이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{
"kind": "androidenterprise#usersListResponse",
"user": [
users Resource
]
}
속성 이름 |
값 |
설명 |
참고 |
user[] |
list |
기업의 사용자입니다. |
|
kind |
string |
리소스의 종류를 식별합니다. 값은 고정 문자열 "androidenterprise#usersListResponse" 입니다. |
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eLooks up a Google-managed user within a specific enterprise using their primary email address.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eSends an HTTP GET request to the specified URL with enterprise ID and email as parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of users matching the provided email, if found within the enterprise.\u003c/p\u003e\n"],["\u003cp\u003eThis method is not applicable for EMM-managed users as their IDs are obtained during the user creation process.\u003c/p\u003e\n"]]],[],null,["# Users: list\n\n| **Note:** Requires [authorization](#auth).\n\nLooks up a user by primary email address.\nThis is only supported for Google-managed users. Lookup of the id is not\nneeded for EMM-managed users because the id is already returned in the\nresult of the Users.insert call.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET 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| **Required query parameters** |||\n| `email` | `string` | The exact primary email address of the user to look up. |\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\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"androidenterprise#usersListResponse\",\n \"user\": [\n users Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|------------------------------------------------------------------------------------------------------------|-------|\n| `user[]` | `list` | A user of an enterprise. | |\n| `kind` | `string` | Identifies what kind of resource this is. Value: the fixed string `\"androidenterprise#usersListResponse\"`. | |"]]