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

अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड दिखता है.

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

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

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

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

अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड दिखता है.