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"
}

सफल अनुरोध पर, एचटीटीपी 200 स्टेटस कोड.

मोबाइल डिवाइस हटाना

किसी मोबाइल डिवाइस को हटाने के लिए, नीचे दिए गए DELETE अनुरोध का इस्तेमाल करें और शामिल करें में बताया गया है अनुरोधों को अनुमति देना. इस उदाहरण में, लाइन लौटाने की सुविधा का इस्तेमाल किया गया है, ताकि इसे आसानी से पढ़ा जा सके: 

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

अनुरोध और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का संदर्भ.

सफल अनुरोध पर, एचटीटीपी 200 स्टेटस कोड.