Method: mobiledevices.list

Bir hesap için kullanıcıya ait tüm mobil cihazların sayfalara ayrılmış bir listesini alır. Şirkete ait cihazları içeren bir listeyi 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 edinmek için Hata kodlarıyla ilgili sorunları giderme başlıklı makaleye göz atın.

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 ürününü temsil etmesi için my_customer takma adını da kullanabilirsiniz. customerId, Kullanıcılar kaynağının bir parçası olarak 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 kullanılan jeton

projection

enum (Projection)

Döndürülen bilgileri seçili bir dizi alanla sınırlayın.

query

string

https://developers.google.com/admin-sdk/directory/v1/search-operators sayfasında verilen biçimdeki arama dizesi

sortOrder

enum (SortOrder)

Sonuçların artan veya azalan düzende döndürülüp döndürülmeyeceğini belirler. orderBy parametresiyle 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, nasıl bir kaynak.

etag

string

Kaynağın eTag'i.

mobiledevices[]

object (MobileDevice)

Mobil Cihaz nesnelerinin listesi.

nextPageToken

string

Bu sonucun 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ılavuzunu inceleyin.

Sıralama Ölçütü

Sıralamalar
DEVICE_ID Google Sync mobil cihazının seri numarası. Android cihazlar için bu, yazılım tarafından oluşturulan benzersiz bir tanımlayıcıdır.
EMAIL Cihaz sahibinin e-posta adresi.
LAST_SYNC Son politika ayarları, cihazın senkronize edildiği tarih ve saattir.
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ı içerir (ör. deviceId, model, status, type ve status)
FULL Tüm meta veri alanlarını içerir

SortOrder

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