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

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

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

در این مثال‌ها، متغیرهای customerId و resourceId برای نشان دادن محل ارائه این شناسه‌ها استفاده می‌شوند. customerId می توان از روش Users.get بدست آورد. resourceId یک شناسه Google منحصر به فرد برای یک دستگاه است و در پاسخ روش 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 زیر استفاده کنید و مجوز شرح داده شده در درخواست‌های مجاز را وارد کنید. برای خوانایی، این مثال از بازگشت خط استفاده می کند:

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

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

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