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.