Method: enterprises.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet EMM-verwaltete Unternehmen auf. Es werden nur BASIC-Felder zurückgegeben.
HTTP-Anfrage
GET https://androidmanagement.googleapis.com/v1/enterprises
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
projectId |
string
Erforderlich. Die Cloud-Projekt-ID des EMM, mit dem die Unternehmen verwaltet werden.
|
pageSize |
integer
Die angeforderte Seitengröße. Die tatsächliche Seitengröße kann auf einen Mindest- oder Maximalwert festgelegt werden.
|
pageToken |
string
Ein Token, das eine vom Server zurückgegebene Ergebnisseite identifiziert.
|
view |
enum (EnterpriseView)
Gibt an, welche Enterprise-Felder zurückgegeben werden sollen. Diese Methode unterstützt nur BASIC.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort auf eine Anfrage zum Auflisten von Unternehmen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"enterprises": [
{
object (Enterprise)
}
],
"nextPageToken": string
} |
| Felder |
enterprises[] |
object (Enterprise)
Die Liste der Unternehmen.
|
nextPageToken |
string
Wenn es weitere Ergebnisse gibt, ein Token zum Abrufen der nächsten Ergebnisseite.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidmanagement
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
EnterpriseView
Gibt an, welche Enterprise-Felder zurückgegeben werden sollen.
| Enums |
ENTERPRISE_VIEW_UNSPECIFIED |
Die API verwendet standardmäßig die BASIC-Ansicht für die List-Methode. |
BASIC |
Enthält die Felder „name“ und „enterpriseDisplayName“. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
