Method: mobiledevices.list

Mengambil daftar paginasi semua perangkat seluler milik pengguna untuk sebuah akun. Untuk mengambil daftar yang menyertakan perangkat milik perusahaan, gunakan Devices API Cloud Identity. Waktu tunggu metode ini akan habis setelah 60 menit. Untuk informasi selengkapnya, lihat Memecahkan masalah kode error.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

ID unik untuk akun Google Workspace pelanggan. Sebagai administrator akun, Anda juga dapat menggunakan alias my_customer untuk mewakili customerId akun Anda. customerId juga ditampilkan sebagai bagian dari Resource pengguna.

Parameter kueri

Parameter
maxResults

integer

Jumlah hasil maksimum yang akan ditampilkan. Nilai maksimum yang diizinkan adalah 100.
orderBy

enum (OrderBy)

Properti perangkat yang akan digunakan untuk mengurutkan hasil.
pageToken

string

Token untuk menentukan halaman berikutnya dalam daftar
projection

enum (Projection)

Membatasi informasi yang ditampilkan ke kumpulan kolom yang dipilih.
query

string

String penelusuran dalam format yang diberikan di https://developers.google.com/admin-sdk/directory/v1/search-operators
sortOrder

enum (SortOrder)

Apakah akan menampilkan hasil dalam urutan menaik atau menurun. Harus digunakan dengan parameter orderBy.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Kolom
kind

string

Ini adalah jenis sumber daya.
etag

string

ETag resource.
mobiledevices[]

object (MobileDevice)

Daftar objek Perangkat Seluler.
nextPageToken

string

Token yang digunakan untuk mengakses halaman berikutnya dari hasil ini.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

OrderBy

Enum
DEVICE_ID Nomor seri untuk perangkat seluler Google Sync. Untuk perangkat Android, ini adalah ID unik yang dihasilkan software.
EMAIL Alamat email pemilik perangkat.
LAST_SYNC Setelan kebijakan terakhir, waktu tanggal sinkronisasi perangkat.
MODEL Model perangkat seluler.
NAME Nama pengguna pemilik perangkat.
OS Sistem operasi perangkat.
STATUS Status perangkat.
TYPE Jenis perangkat.

Projection

Enum
BASIC Menyertakan hanya kolom metadata dasar (misalnya, deviceId, model, status, jenis, dan status)
FULL Mencakup semua kolom metadata

SortOrder

Enum
ASCENDING Urutan menaik.
DESCENDING Urutan dari atas ke bawah.