Method: enterprises.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
רשימה של ארגונים בניהול EMM. רק שדות BASIC מוחזרים.
בקשת HTTP
GET https://androidmanagement.googleapis.com/v1/enterprises
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של שאילתה
| פרמטרים |
projectId |
string
חובה. מזהה הפרויקט ב-Cloud של ה-EMM שמנהל את הארגונים.
|
pageSize |
integer
גודל הדף המבוקש. גודל הדף בפועל עשוי להיות קבוע לערך מינימלי או מקסימלי.
|
pageToken |
string
אסימון שמזהה דף תוצאות שהשרת החזיר.
|
view |
enum (EnterpriseView)
מציין אילו שדות Enterprise להחזיר. השיטה הזו תומכת רק ב-BASIC.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה לבקשה להוספת ארגונים לרשימה.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"enterprises": [
{
object (Enterprise)
}
],
"nextPageToken": string
} |
| שדות |
enterprises[] |
object (Enterprise)
רשימת הארגונים.
|
nextPageToken |
string
אם יש תוצאות נוספות, אסימון לאחזור דף התוצאות הבא.
|
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/androidmanagement
מידע נוסף זמין בOAuth 2.0 Overview.
EnterpriseView
מציין אילו שדות Enterprise להחזיר.
| טיפוסים בני מנייה (enum) |
ENTERPRISE_VIEW_UNSPECIFIED |
כברירת מחדל, תצוגת ה-API תהיה BASIC בשיטת List. |
BASIC |
כולל את השדות name ו-enterpriseDisplayName. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eLists EMM-managed enterprises, returning only basic fields like name and display name.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by Cloud project ID and pagination for large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty, and the response includes a list of enterprises and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eUses a GET request to the \u003ccode\u003ehttps://androidmanagement.googleapis.com/v1/enterprises\u003c/code\u003e endpoint.\u003c/p\u003e\n"]]],["This document details how to list EMM-managed enterprises via a `GET` request to `https://androidmanagement.googleapis.com/v1/enterprises`. The request requires a `projectId`, and supports optional `pageSize`, `pageToken`, and `view` query parameters. The `view` parameter only supports `BASIC`. The request body must be empty. The response includes a list of enterprises, with a `nextPageToken` for pagination. Authentication requires the `https://www.googleapis.com/auth/androidmanagement` OAuth scope.\n"],null,["# Method: enterprises.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListEnterprisesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [EnterpriseView](#EnterpriseView)\n- [Try it!](#try-it)\n\nLists EMM-managed enterprises. Only [BASIC](/android/management/reference/rest/v1/enterprises/list#EnterpriseView.ENUM_VALUES.BASIC) fields are returned.\n\n### HTTP request\n\n`GET https://androidmanagement.googleapis.com/v1/enterprises`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `projectId` | `string` Required. The Cloud project ID of the EMM managing the enterprises. |\n| `pageSize` | `integer` The requested page size. The actual page size may be fixed to a min or max value. |\n| `pageToken` | `string` A token identifying a page of results returned by the server. |\n| `view` | `enum (`[EnterpriseView](/android/management/reference/rest/v1/enterprises/list#EnterpriseView)`)` Specifies which Enterprise fields to return. This method only supports [BASIC](/android/management/reference/rest/v1/enterprises/list#EnterpriseView.ENUM_VALUES.BASIC). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to a request to list enterprises.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"enterprises\": [ { object (/android/management/reference/rest/v1/enterprises#Enterprise) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------|\n| `enterprises[]` | `object (`[Enterprise](/android/management/reference/rest/v1/enterprises#Enterprise)`)` The list of enterprises. |\n| `nextPageToken` | `string` If there are more results, a token to retrieve next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nEnterpriseView\n--------------\n\nSpecifies which Enterprise fields to return.\n\n| Enums ||\n|-------------------------------|-------------------------------------------------------------|\n| `ENTERPRISE_VIEW_UNSPECIFIED` | The API will default to the BASIC view for the List method. |\n| `BASIC` | Includes name and enterpriseDisplayName fields. |"]]
