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