Method: mobiledevices.list

Mengambil daftar yang diberi nomor halaman dari semua perangkat seluler milik pengguna untuk sebuah akun. Untuk mengambil daftar yang berisi perangkat milik perusahaan, gunakan Devices API Cloud Identity. Waktu metode ini akan habis setelah 60 menit. Untuk mengetahui 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

Jenis sumber daya ini.
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 Waktu tanggal sinkronisasi setelan kebijakan terakhir perangkat.
MODEL Model perangkat seluler.
NAME Nama pengguna pemilik perangkat.
OS Sistem operasi perangkat.
STATUS Status perangkat.
TYPE Jenis perangkat.

Proyeksi

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

SortOrder

Enum
ASCENDING Urutan menaik.
DESCENDING Urutan menurun.