Directory API: دستگاه های تلفن همراه

رابط برنامه‌نویسی کاربردی (API) دایرکتوری فضای کاری گوگل (Google Workspace Directory API) به شما امکان می‌دهد دستگاه‌های تلفن همراه را در سازمان خود مدیریت کنید. این صفحه شامل نمونه‌هایی از نحوه فهرست کردن دستگاه‌های تلفن همراه، دریافت جزئیات یک دستگاه خاص و همچنین اضافه یا حذف کردن یک دستگاه است.

این سند فرض می‌کند که شما پیش‌نیازها را با موفقیت تکمیل کرده‌اید. دستگاه‌های اندروید باید برنامه‌ی device policy را نصب داشته باشند. دستگاه‌های iOS باید در سرویس مدیریت موبایل گوگل ثبت شده باشند.

در این مثال‌ها، از متغیرهای customerId و resourceId برای نشان دادن محل ارائه این شناسه‌ها استفاده می‌شود. customerId را می‌توان از متد Users.get دریافت کرد. resourceId یک شناسه منحصر به فرد گوگل برای یک دستگاه است و در پاسخ متد Retrieve all mobile devices یافت می‌شود.

بازیابی تمام دستگاه‌های تلفن همراه

برای بازیابی تمام دستگاه‌های تلفن همراه یک حساب، از درخواست GET زیر استفاده کنید و مجوز شرح داده شده در درخواست‌های مجوز را نیز لحاظ کنید. برای خوانایی بیشتر، این مثال از خروجی‌های خط استفاده می‌کند:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile?projection={BASIC|FULL}&query=query
  &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING}
  &pageToken=token for next results page
  &maxResults=max number of results per page

برای ویژگی‌های درخواست و پاسخ، به مرجع API مراجعه کنید.

پاسخ JSON 

{
   "kind": "directory#mobiledevices",
   "mobiledevices": [
    {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Sales"
     ],
     "email": [
      "sales@example.com"
     ],
     "model": "Nexus 4",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "1234567890",
     "firstSync": "2013-05-15T17:30:04.325Z",
     "lastSync": "2013-06-05T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
   },
   {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Liz"
     ],
     "email": [
      "liz@example.com"
     ],
     "model": "Galaxy Nexus",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "9123456780",
     "firstSync": "2013-06-05T17:30:04.325Z",
     "lastSync": "2013-08-12T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
    }
   ],
   "nextPageToken": "next_page_token_value"
  }

بازیابی یک دستگاه تلفن همراه

برای بازیابی ویژگی‌های یک دستگاه تلفن همراه، از درخواست GET زیر استفاده کنید و مجوز شرح داده شده در درخواست‌های مجوز را نیز لحاظ کنید. برای خوانایی بیشتر، این مثال از خروجی‌های خط استفاده می‌کند:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId?projection={FULL|BASIC}

برای ویژگی‌های درخواست و پاسخ، به مرجع API مراجعه کنید.

درخواست JSON

یک نمونه درخواست برای resourceId به صورت زیر است:

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL

پاسخ JSON 

{
   "kind": "directory#mobiledevice",
   "resourceId": "resourceId",
   "deviceId": "deviceId",
   "name": [
    "Sales3"
   ],
   "email": [
    "sales@example.com"
   ],
   "model": "Nexus 4",
   "os": "Android 4.2.2",
   "type": "ANDROID",
   "status": "APPROVED",
   "hardwareId": "1234567890",
   "firstSync": "2010-05-15T17:30:04.325Z",
   "lastSync": "2013-06-05T17:30:04.325Z",
   "userAgent": "Google Apps Device Policy 4.14",
  }

تأیید دستگاه تلفن همراه

برای تأیید یک دستگاه تلفن همراه، از درخواست POST زیر استفاده کنید و مجوز شرح داده شده در درخواست‌های تأیید را نیز وارد کنید. برای خوانایی بیشتر، این مثال از خروجی‌های خط استفاده می‌کند:

POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId/action

برای ویژگی‌های درخواست و پاسخ، به مرجع API مراجعه کنید.

درخواست JSON

درخواست JSON زیر نمونه‌ای از درخواست تأیید یک دستگاه را نشان می‌دهد:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices
  /mobile/resourceId/action

بدنه درخواست عبارت است از:

{
    "action": "approve"
}

یک درخواست موفق ، کد وضعیت HTTP 200 را برمی‌گرداند.

حذف یک دستگاه تلفن همراه

برای حذف یک دستگاه تلفن همراه، از درخواست DELETE زیر استفاده کنید و مجوز شرح داده شده در درخواست‌های Authorize را نیز لحاظ کنید. برای خوانایی بیشتر، این مثال از خروجی‌های خط استفاده می‌کند:

DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId

برای ویژگی‌های درخواست و پاسخ، به مرجع API مراجعه کنید.

یک درخواست موفق ، کد وضعیت HTTP 200 را برمی‌گرداند.