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

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

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

في هذه الأمثلة، يتم استخدام العنصرَين النائبَين 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.