Method: chromeosdevices.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir hesaptaki Chrome OS cihazlarının sayfalandırılmış listesini alır.
HTTP isteği
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
customerId |
string
Müşterinin Google Workspace hesabının benzersiz kimliği. Hesap yöneticisi olarak, hesabınızın customerId değerini temsil etmek için my_customer takma adını da kullanabilirsiniz. customerId , Users kaynağı kapsamında da döndürülür.
|
Sorgu parametreleri
Parametreler |
maxResults |
integer
Döndürülecek maksimum sonuç sayısı. Değer 300'ü aşmamalıdır.
|
orderBy |
enum (OrderBy )
Sonuçları sıralamak için kullanılacak cihaz özelliği.
|
orgUnitPath |
string
Kuruluş biriminin tam yolu (öndeki / hariç) veya benzersiz kimliği.
|
pageToken |
string
pageToken sorgu parametresi, sorgu sonuçlarının bir sonraki sayfasını istemek için kullanılır. Takip eden isteğin pageToken sorgu parametresi, önceki yanıtınızdaki nextPageToken parametresidir.
|
projection |
enum (Projection )
Yanıtın özelliklerin tam listesini mi yoksa yalnızca bir kısmını mı içereceğini belirler.
|
query |
string
https://developers.google.com/workspace/admin/directory/v1/list-query-operators adresinde verilen biçimde arama dizesi
|
sortOrder |
enum (SortOrder )
Sonuçların artan düzende mi yoksa azalan düzende mi döndürüleceğini belirtir. orderBy parametresi ile kullanılmalıdır.
|
includeChildOrgunits |
boolean
Belirtilen kuruluş biriminin yanı sıra tüm alt kuruluş birimlerindeki cihazları döndürme. Bu ayar doğru olarak belirlenirse "orgUnitPath" sağlanmalıdır.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"kind": string,
"etag": string,
"chromeosdevices": [
{
object (ChromeOsDevice )
}
],
"nextPageToken": string
} |
Alanlar |
kind |
string
Bu kaynağın türü.
|
etag |
string
Kaynağın ETag'i.
|
chromeosdevices[] |
object (ChromeOsDevice )
Chrome OS cihaz nesnelerinin listesi.
|
nextPageToken |
string
Bu sonucun bir sonraki sayfasına erişmek için kullanılan jeton. Sonraki sayfaya erişmek için bu isteğin pageToken sorgu dizesinde bu jetonun değerini kullanın.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/admin.directory.device.chromeos
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Şuna göre sırala
Sıralamalar |
ANNOTATED_LOCATION |
Yönetici tarafından belirtildiği şekilde Chrome cihazının konumu. |
ANNOTATED_USER |
Yönetici tarafından belirtildiği şekilde Chromebook kullanıcısı. |
LAST_SYNC |
Chrome cihazın, Yönetici Konsolu'ndaki politika ayarlarıyla son senkronize edilme tarihi ve saati. |
NOTES |
Yönetici tarafından belirtildiği şekilde Chrome cihaz notları. |
SERIAL_NUMBER |
Cihaz etkinleştirilirken girilen Chrome cihaz seri numarası. |
STATUS |
Chrome cihaz durumu. Daha fazla bilgi için <a chromeosdevices başlıklı makaleyi inceleyin. |
Projeksiyon
Cihazlarda gösterilecek projeksiyon türü.
Sıralamalar |
BASIC |
Yalnızca temel meta veri alanlarını (ör.deviceId, serialNumber, status ve user) içerir. |
FULL |
Tüm meta veri alanlarını içerir |
SortOrder
Cihaz listesine uygulanması gereken sıralama düzeni.
Sıralamalar |
ASCENDING |
Artan düzen. |
DESCENDING |
Azalan düzen. |
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-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Method: chromeosdevices.list\n\nRetrieves a paginated list of Chrome OS devices within an account.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). |\n\n### Query parameters\n\n| Parameters ||\n|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of results to return. Value should not exceed 300. |\n| `orderBy` | `enum (`[OrderBy](/workspace/admin/directory/reference/rest/v1/chromeosdevices/list#OrderBy)`)` Device property to use for sorting results. |\n| `orgUnitPath` | `string` The full path of the organizational unit (minus the leading `/`) or its unique ID. |\n| `pageToken` | `string` The `pageToken` query parameter is used to request the next page of query results. The follow-on request's `pageToken` query parameter is the `nextPageToken` from your previous response. |\n| `projection` | `enum (`[Projection](/workspace/admin/directory/reference/rest/v1/chromeosdevices/list#Projection)`)` Determines whether the response contains the full list of properties or only a subset. |\n| `query` | `string` Search string in the format given at \u003chttps://developers.google.com/workspace/admin/directory/v1/list-query-operators\u003e |\n| `sortOrder` | `enum (`[SortOrder](/workspace/admin/directory/reference/rest/v1/chromeosdevices/list#SortOrder)`)` Whether to return results in ascending or descending order. Must be used with the `orderBy` parameter. |\n| `includeChildOrgunits` | `boolean` Return devices from all child orgunits, as well as the specified org unit. If this is set to true, 'orgUnitPath' must be provided. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"chromeosdevices\": [ { object (/workspace/admin/directory/reference/rest/v1/chromeosdevices#ChromeOsDevice) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Kind of resource this is. |\n| `etag` | `string` ETag of the resource. |\n| `chromeosdevices[]` | `object (`[ChromeOsDevice](/workspace/admin/directory/reference/rest/v1/chromeosdevices#ChromeOsDevice)`)` A list of Chrome OS Device objects. |\n| `nextPageToken` | `string` Token used to access the next page of this result. To access the next page, use this token's value in the `pageToken` query string of this request. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.directory.device.chromeos`\n- `\n https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nOrderBy\n-------\n\n| Enums ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ANNOTATED_LOCATION` | Chrome device location as annotated by the administrator. |\n| `ANNOTATED_USER` | Chromebook user as annotated by administrator. |\n| `LAST_SYNC` | The date and time the Chrome device was last synchronized with the policy settings in the Admin console. |\n| `NOTES` | Chrome device notes as annotated by the administrator. |\n| `SERIAL_NUMBER` | The Chrome device serial number entered when the device was enabled. |\n| `STATUS` | Chrome device status. For more information, see the \\\u003ca [chromeosdevices](https://developers.google.com/workspace/admin/directory/v1/reference/chromeosdevices.html). |\n\nProjection\n----------\n\nThe type of projection to show for the devices.\n\n| Enums ||\n|---------|------------------------------------------------------------------------------------------|\n| `BASIC` | Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user) |\n| `FULL` | Includes all metadata fields |\n\nSortOrder\n---------\n\nThe sorting order that should be applied to the device list.\n\n| Enums ||\n|--------------|-------------------|\n| `ASCENDING` | Ascending order. |\n| `DESCENDING` | Descending order. |"]]