Method: mobiledevices.list

ดึงข้อมูลรายการอุปกรณ์เคลื่อนที่ทั้งหมดที่ผู้ใช้เป็นเจ้าของสำหรับบัญชีหนึ่งๆ โดยแบ่งเป็นหน้า หากต้องการเรียกข้อมูลรายการที่มีอุปกรณ์ของบริษัท ให้ใช้ Devices API ของ Cloud Identity แทน โดยวิธีนี้จะหมดเวลาหลังจากผ่านไป 60 นาที โปรดดูข้อมูลเพิ่มเติมที่หัวข้อแก้ปัญหารหัสข้อผิดพลาด

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

รหัสที่ไม่ซ้ำกันสำหรับบัญชี Google Workspace ของลูกค้า ในฐานะผู้ดูแลระบบบัญชี คุณสามารถใช้อีเมลแทน my_customer เพื่อแสดง customerId ของบัญชีได้เช่นกัน ระบบจะแสดงผล customerId เป็นส่วนหนึ่งของทรัพยากรผู้ใช้ด้วย

พารามิเตอร์การค้นหา

พารามิเตอร์
maxResults

integer

จำนวนผลลัพธ์สูงสุดที่จะแสดง ค่าสูงสุดที่อนุญาตคือ 100
orderBy

enum (OrderBy)

พร็อพเพอร์ตี้อุปกรณ์ที่จะใช้จัดเรียงผลลัพธ์
pageToken

string

โทเค็นสำหรับระบุหน้าถัดไปในรายการ
projection

enum (Projection)

จำกัดข้อมูลที่แสดงผลเป็นชุดช่องที่เลือก
query

string

สตริงการค้นหาในรูปแบบที่ระบุไว้ที่ https://developers.google.com/workspace/admin/directory/v1/search-operators
sortOrder

enum (SortOrder)

แสดงผลลัพธ์ตามลําดับจากน้อยไปมากหรือมากไปน้อย ต้องใช้ร่วมกับพารามิเตอร์ orderBy

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
ช่อง
kind

string

ประเภทของทรัพยากร
etag

string

ETag ของทรัพยากร
mobiledevices[]

object (MobileDevice)

รายการออบเจ็กต์อุปกรณ์เคลื่อนที่
nextPageToken

string

โทเค็นที่ใช้เข้าถึงหน้าถัดไปของผลการค้นหานี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • 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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์

OrderBy

Enum
DEVICE_ID หมายเลขซีเรียลของอุปกรณ์เคลื่อนที่ที่ใช้ Google Sync สำหรับอุปกรณ์ Android ข้อมูลนี้เป็นตัวระบุที่ไม่ซ้ำกันซึ่งซอฟต์แวร์สร้างขึ้น
EMAIL อีเมลเจ้าของอุปกรณ์
LAST_SYNC วันที่และเวลาที่ซิงค์การตั้งค่านโยบายล่าสุดของอุปกรณ์
MODEL รุ่นของอุปกรณ์เคลื่อนที่
NAME ชื่อผู้ใช้ของเจ้าของอุปกรณ์
OS ระบบปฏิบัติการของอุปกรณ์
STATUS สถานะอุปกรณ์
TYPE ประเภทของอุปกรณ์

การฉายภาพ

Enum
BASIC มีเฉพาะช่องข้อมูลเมตาพื้นฐาน (เช่น deviceId, รุ่น, สถานะ, ประเภท และสถานะ)
FULL รวมช่องข้อมูลเมตาทั้งหมด

SortOrder

Enum
ASCENDING เรียงลำดับจากน้อยไปมาก
DESCENDING เรียงลำดับจากมากไปน้อย