Directory API: الأجهزة الجوّالة

تتيح لك Google Workspace Directory API إدارة الأجهزة الجوّالة داخل مؤسستك. تتضمن هذه الصفحة أمثلة على كيفية إدراج أجهزة الجوّال الخاصة بك والحصول على تفاصيل حول جهاز معيّن، بالإضافة إلى إضافة جهاز أو إزالته.

يفترض هذا المستند أنّك أكملت المتطلبات الأساسية بنجاح. يجب تثبيت تطبيق سياسة الجهاز على أجهزة Android، كما يجب أن تكون أجهزة iOS مسجَّلة في خدمة إدارة Google للأجهزة الجوّالة.

في هذه الأمثلة، يتم استخدام العنصرَين النائبَين customerId وresourceId للإشارة إلى المكان الذي يجب توفير هذه المعرّفات فيه. يمكن الحصول على customerId من طريقة Users.get. resourceId هو معرّف Google فريد لجهاز يتم العثور عليه في استجابة طريقة استرداد جميع الأجهزة الجوّالة.

استرداد كل أجهزة الجوّال

لاسترداد جميع الأجهزة الجوّالة لحساب، استخدِم طلب 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

للاطّلاع على خصائص الطلب والاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

استجابة 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}

للاطّلاع على خصائص الطلب والاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

طلب 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

للاطّلاع على خصائص الطلب والاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

طلب 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

للاطّلاع على خصائص الطلب والاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

يعرض الطلب الناجح رمز حالة HTTP 200.