Method: mobiledevices.list

Bir hesaptaki kullanıcıya ait tüm mobil cihazların sayfalandırılmış listesini alır. Şirkete ait cihazları içeren bir liste almak için bunun yerine Cloud Identity Devices API'yi kullanın. Bu yöntem 60 dakika sonra zaman aşımına uğrar. Daha fazla bilgi için Hata kodlarıyla ilgili sorunları giderme başlıklı makaleyi inceleyin.

HTTP isteği

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

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ı. İzin verilen maksimum değer 100'dür.

orderBy

enum (OrderBy)

Sonuçları sıralamak için kullanılacak cihaz özelliği.

pageToken

string

Listede sonraki sayfayı belirtmek için jeton

projection

enum (Projection)

Seçilen alan grubuna döndürülen bilgileri kısıtlayın.

query

string

https://developers.google.com/workspace/admin/directory/v1/search-operators adresinde verilen biçimdeki 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.

İ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,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Alanlar
kind

string

Bu kaynağın türü.

etag

string

Kaynağın ETag'i.

mobiledevices[]

object (MobileDevice)

Mobil Cihaz nesnelerinin listesi.

nextPageToken

string

Bu sonucun bir sonraki sayfasına erişmek için kullanılan jeton.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.

Şuna göre sırala

Sıralamalar
DEVICE_ID Google Sync mobil cihazın seri numarası. Android cihazlarda bu, yazılım tarafından oluşturulan benzersiz bir tanımlayıcıdır.
EMAIL Cihaz sahibinin e-posta adresi.
LAST_SYNC Cihazın son politika ayarları senkronizasyon tarihi ve saati.
MODEL Mobil cihazın modeli.
NAME Cihaz sahibinin kullanıcı adı.
OS Cihazın işletim sistemi.
STATUS Cihaz durumu.
TYPE Cihazın türü.

Projeksiyon

Sıralamalar
BASIC Yalnızca temel meta veri alanlarını (ör.deviceId, model, durum, tür ve durum) içerir.
FULL Tüm meta veri alanlarını içerir

SortOrder

Sıralamalar
ASCENDING Artan düzen.
DESCENDING Azalan düzen.