Method: mobiledevices.list

یک لیست صفحه بندی شده از تمام دستگاه های تلفن همراه متعلق به کاربر را برای یک حساب بازیابی می کند. برای بازیابی لیستی که شامل دستگاه های متعلق به شرکت است، به جای آن از Cloud Identity Devices API استفاده کنید. این روش پس از 60 دقیقه از بین می رود. برای اطلاعات بیشتر، عیب‌یابی کدهای خطا را ببینید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

سفارش توسط

Enums
DEVICE_ID شماره سریال یک دستگاه تلفن همراه Google Sync. برای دستگاه های Android، این یک شناسه منحصر به فرد ایجاد شده توسط نرم افزار است.
EMAIL آدرس ایمیل مالک دستگاه.
LAST_SYNC آخرین تنظیمات خط مشی زمان تاریخ همگام سازی دستگاه.
MODEL مدل دستگاه موبایل
NAME نام کاربری مالک دستگاه.
OS سیستم عامل دستگاه.
STATUS وضعیت دستگاه
TYPE نوع دستگاه.

فرافکنی

Enums
BASIC فقط شامل فیلدهای ابرداده اصلی (به عنوان مثال، شناسه دستگاه، مدل، وضعیت، نوع و وضعیت) است.
FULL شامل تمام فیلدهای ابرداده است

مرتب سازی

Enums
ASCENDING ترتیب صعودی
DESCENDING ترتیب نزولی