Method: chromeosdevices.list

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.