Method: enterprises.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
EMM tarafından yönetilen kuruluşları listeler. Yalnızca BASIC alanları döndürülür.
HTTP isteği
GET https://androidmanagement.googleapis.com/v1/enterprises
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler |
projectId |
string
Zorunlu. Kuruluşları yöneten EMM'nin Cloud proje kimliği.
|
pageSize |
integer
İstenen sayfa boyutu. Gerçek sayfa boyutu minimum veya maksimum bir değere sabitlenmiş olabilir.
|
pageToken |
string
Sunucu tarafından döndürülen bir sonuç sayfasını tanımlayan jeton.
|
view |
enum (EnterpriseView)
Hangi Enterprise alanlarının döndürüleceğini belirtir. Bu yöntem yalnızca BASIC destekler.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Kuruluşları listeleme isteğine verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"enterprises": [
{
object (Enterprise)
}
],
"nextPageToken": string
} |
| Alanlar |
enterprises[] |
object (Enterprise)
Kuruluşların listesi.
|
nextPageToken |
string
Daha fazla sonuç varsa bir sonraki sonuç sayfasını almak için bir jeton.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/androidmanagement
Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
EnterpriseView
Hangi Enterprise alanlarının döndürüleceğini belirtir.
| Sıralamalar |
ENTERPRISE_VIEW_UNSPECIFIED |
API, varsayılan olarak Liste yöntemi için TEMEL görünümüne ayarlanır. |
BASIC |
ad ve enterpriseDisplayName alanlarını içerir. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]
