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

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

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 स्टेटस कोड मिलता है.