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