חשוב: אנחנו לא מקבלים יותר רישומים חדשים עבור Play EMM API.
מידע נוסף
Users: list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
חיפוש משתמש לפי כתובת אימייל ראשית.
האפשרות הזו נתמכת רק עבור משתמשים שמנוהלים על ידי Google. החיפוש של המזהה אינו
נדרש למשתמשים שמנוהלים על ידי EMM כי המזהה כבר מוחזר
התוצאה של הקריאה ל-Users.insert.
בקשה
בקשת HTTP
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
פרמטרים
שם הפרמטר |
ערך |
תיאור |
פרמטרים של נתיב |
enterpriseId |
string |
המזהה של הארגון.
|
פרמטרים נדרשים של שאילתה |
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. Java הוא סימן מסחרי רשום של חברת 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\"`. | |"]]