किसी खाते के लिए, सभी Chrome डिवाइसों की जानकारी पाना
किसी खाते से असाइन किए गए सभी Chrome डिवाइसों की सूची दिखाने के लिए, यहां दिए गए
GET
अनुरोध का इस्तेमाल करें. साथ ही, अनुरोधों को अनुमति दें में बताए गए अनुमति का ब्यौरा शामिल करें. कोड को आसानी से पढ़ने के लिए,
इस कोड सैंपल में लाइन रिटर्न का इस्तेमाल किया गया है:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} / devices/chromeos?projection={ BASIC|FULL}&query=query &orderBy=orderBy category &sortOrder={ ASCENDING|DESCENDING} &pageToken=token for next results page, if applicable &maxResults=max number of results per page
customerId
, ग्राहक के Google खाते का यूनीक आइडेंटिफ़ायर है.- खाते के एडमिन के तौर पर,
my_customer
स्ट्रिंग का इस्तेमाल भी किया जा सकता है. यह स्ट्रिंग, आपके खाते केcustomerId
को दिखाती है.customerId
वैल्यू पाने का दूसरा तरीका, उपयोगकर्ता की जानकारी पाना ऑपरेशन का इस्तेमाल करना है. ऑपरेशन केuserKey
पाथ पैरामीटर में, अपने एडमिन ईमेल पते या अपने एडमिन यूनीक उपयोगकर्ताid
वैल्यू का इस्तेमाल करें.
क्वेरी स्ट्रिंग, अनुरोध, और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का रेफ़रंस देखें.
उदाहरण: उपयोगकर्ता के हिसाब से डिवाइसों को फ़िल्टर करना
इस उदाहरण में,query=user:help desk
का इस्तेमाल करके किसी उपयोगकर्ता को खोजा गया है. रिस्पॉन्स में एक chromeosdevice
रिसॉर्स है, जहां annotatedUser
help desk
है:
JSON अनुरोध
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=user:help desk &orderBy=status &sortOrder=ASCENDING&maxResults=100
JSON का रिस्पॉन्स
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "etag": "1234567890" "deviceId": "def456", "serialNumber": "234567", "status": "ACTIVE", "lastSync": "2013-03-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "1234567890", "notes": "Loaned from support", "orderNumber": "1234", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated", "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering", "recentUsers": [ { "type": "USER_TYPE_MANAGED", "email": "user@customer.com" } ], "activeTimeRanges": [ { "date": "2012-04-05", "activeTime": "3600000" } ], } ], "nextPageToken": "abcdefghijkl123" }
उदाहरण: डिवाइसों को सीरियल नंबर के हिसाब से फ़िल्टर करना
इस उदाहरण में, query=id:123456
का इस्तेमाल करके किसी खास सीरियल नंबर को खोजा गया है. यहां 123456
, डिवाइस का सीरियल नंबर है. नीचे दिए गए रिस्पॉन्स में, खोज क्वेरी से मैच करने वाला एक जवाब है. इसमें serialNumber
प्रॉपर्टी, खोज क्वेरी से मैच करती है.
JSON अनुरोध
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=id:123456 &orderBy=status &sortOrder=ASCENDING&maxResults=100
JSON का रिस्पॉन्स
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "deviceId": "abc123", "serialNumber": "123456", "status": "SHIPPED", "supportEndDate": "1404457200000", "model": "model_value", "meid": "meid_value", "macAddress": "mac_address_value", "orderNumber": "1234", "willAutoRenew": true } ], "nextPageToken": "abcdefghijkl123" }
जवाब के इस उदाहरण में model
, meid
, और
macAddress
प्रॉपर्टी शामिल हैं. अगर किसी डिवाइस में ये प्रॉपर्टी नहीं हैं, तो उन्हें रिस्पॉन्स में शामिल नहीं किया जाता. पूरी जानकारी के लिए, Chromeosdevices रिसॉर्स का प्रतिनिधित्व देखें.
MEID की सूची एक्सपोर्ट करना
meid
, Chrome डिवाइस में 3G मोबाइल कार्ड के लिए मोबाइल उपकरण आइडेंटिफ़ायर (एमईआईडी) है. आम तौर पर, किसी वायरलेस कैरियर के पोस्ट-पेड सेवा प्लान में डिवाइस जोड़ते समय, MEID का इस्तेमाल किया जाता है. MEID की सूची एक्सपोर्ट करने के लिए, यहां दिए गए GET
अनुरोध का इस्तेमाल करें और
MEID की पूरी सूची पाने के लिए nextPageToken
वैल्यू डालें. कोड को आसानी से पढ़ने के लिए, इस
कोड सैंपल में लाइन रिटर्न का इस्तेमाल किया गया है:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} / devices/chromeos?fields=nextPageToken,chromeosdevices(meid)
Chrome डिवाइस वापस पाना
Chrome डिवाइस की प्रॉपर्टी वापस पाने के लिए, यहां दिए गए GET
अनुरोध का इस्तेमाल करें और अनुरोधों को अनुमति दें में बताए गए अनुमति फ़ॉर्मैट को शामिल करें. कोड को आसानी से पढ़ने के लिए,
इस कोड सैंपल में लाइन रिटर्न का इस्तेमाल किया गया है:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} / devices/chromeos/deviceId ?projection={ FULL|BASIC}
customerId
, ग्राहक के Google खाते का यूनीक आइडेंटिफ़ायर है.- खाते के एडमिन के तौर पर,
my_customer
स्ट्रिंग का इस्तेमाल भी किया जा सकता है. यह स्ट्रिंग, आपके खाते केcustomerId
को दिखाती है.customerId
वैल्यू पाने का दूसरा तरीका, उपयोगकर्ता की जानकारी पाना ऑपरेशन का इस्तेमाल करना है. ऑपरेशन केuserKey
पाथ पैरामीटर में, अपने एडमिन ईमेल पते या अपने एडमिन यूनीक उपयोगकर्ताid
वैल्यू का इस्तेमाल करें. deviceId
, किसी डिवाइस का यूनीक आइडेंटिफ़ायर होता है. यह सभी Chrome डिवाइसों की जानकारी पाएं ऑपरेशन के रिस्पॉन्स में मिलता है.
क्वेरी स्ट्रिंग, अनुरोध, और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का रेफ़रंस देखें.
JSON अनुरोध
अनुरोध का उदाहरण. इस कोड सैंपल में, आसानी से पढ़ने के लिए लाइन रिटर्न का इस्तेमाल किया गया है:GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos/deviceId ?projection=full
JSON का रिस्पॉन्स
अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड दिखता है. रिस्पॉन्स में, स्टेटस कोड के साथ-साथ Chrome डिवाइस की प्रॉपर्टी भी दिखती हैं:
{ "kind": "directory#chromeosdevice", "deviceId": "device_id_value", "serialNumber": "device_serial_number", "status": "ACTIVE", "lastSync": "2012-04-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "12345667890", "notes": "Loaned from support", "orderNumber": "123456", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated" "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering" }
Chrome डिवाइस को अपडेट करना
किसी Chrome डिवाइस को अपडेट करने के लिए, यहां दिए गए PUT
अनुरोध का इस्तेमाल करें. साथ ही, अनुरोधों को अनुमति दें में बताई गई अनुमति शामिल करें. कोड को आसानी से पढ़ने के लिए,
इस सैंपल में लाइन रिटर्न का इस्तेमाल किया गया है:
PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} / devices/chromeos/deviceId ?projection={ FULL|BASIC}
customerId
, ग्राहक के Google खाते का यूनीक आइडेंटिफ़ायर है.- खाते के एडमिन के तौर पर,
my_customer
स्ट्रिंग का इस्तेमाल भी किया जा सकता है. यह स्ट्रिंग, आपके खाते केcustomerId
को दिखाती है.customerId
वैल्यू पाने का दूसरा तरीका, उपयोगकर्ता की जानकारी पाना ऑपरेशन का इस्तेमाल करना है. ऑपरेशन केuserKey
पाथ पैरामीटर में, अपने एडमिन ईमेल पते या अपने एडमिन यूनीक उपयोगकर्ताid
वैल्यू का इस्तेमाल करें. deviceId
, किसी डिवाइस का यूनीक आइडेंटिफ़ायर होता है. यह सभी Chrome डिवाइसों की जानकारी पाएं ऑपरेशन के रिस्पॉन्स में मिलता है.
क्वेरी स्ट्रिंग, अनुरोध, और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का रेफ़रंस देखें.
JSON अनुरोध
यहां दिए गए उदाहरण में, JSON अनुरोध की मदद से Chrome डिवाइस की annotatedUser
,
annotatedLocation
, annotatedAssetId
, notes
, और
orgUnitPath
प्रॉपर्टी अपडेट की गई हैं. इस कोड सैंपल में, आसानी से पढ़ने के लिए लाइन रिटर्न का इस्तेमाल किया गया है:
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/deviceId ?projection=full
{
"deviceId": "device_id_value",
"annotatedUser": "help desk",
"annotatedLocation": "Mountain View help desk Chromebook",
"annotatedAssetId": "1234567890",
"notes": "Loaned from support",
"orgUnitPath": "/corp/sales"
}
अपडेट के अनुरोध के लिए, अपने अनुरोध में सिर्फ़ अपडेट की गई वैल्यू वाली प्रॉपर्टी शामिल करें.
अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड दिखता है. रिस्पॉन्स में, स्टेटस कोड के साथ-साथ, अपडेट किए गए Chrome डिवाइस की प्रॉपर्टी भी दिखती हैं.
Chrome डिवाइसों को डिवाइसों की सूची से हटाना या बंद करना
Chrome डिवाइसों को हटाने या बंद करने के लिए, यहां दिए गए POST
अनुरोध का इस्तेमाल करें और अनुरोधों को अनुमति दें में बताए गए अनुमति पत्र को शामिल करें. कोड को आसानी से पढ़ने के लिए,
इस कोड सैंपल में लाइन रिटर्न का इस्तेमाल किया गया है:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId / devices/chromeos:batchChangeStatus
customerId
, ग्राहक के Google खाते का यूनीक आइडेंटिफ़ायर है.- खाते के एडमिन के तौर पर,
my_customer
स्ट्रिंग का इस्तेमाल भी किया जा सकता है. यह स्ट्रिंग, आपके खाते केcustomerId
को दिखाती है.customerId
वैल्यू पाने का दूसरा तरीका, उपयोगकर्ता की जानकारी पाना ऑपरेशन का इस्तेमाल करना है. ऑपरेशन केuserKey
पाथ पैरामीटर में, अपने एडमिन ईमेल पते या अपने एडमिन यूनीक उपयोगकर्ताid
वैल्यू का इस्तेमाल करें.
अनुरोध और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का रेफ़रंस देखें.
JSON अनुरोध
नीचे दिए गए JSON अनुरोध में, Chrome डिवाइसों को डिप्रावाइज़ करने और बंद करने के लिए, अनुरोध का सैंपल दिया गया है:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION", "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE" }
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE", }
अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड दिखता है.
Chrome डिवाइसों को संगठन की इकाई में ले जाना
ज़्यादा से ज़्यादा 50 Chrome डिवाइसों को किसी संगठन की इकाई में ट्रांसफ़र करने के लिए, यहां दिए गए POST
अनुरोध का इस्तेमाल करें. साथ ही, अनुरोधों को अनुमति दें में बताए गए अनुमति फ़ॉर्मैट का इस्तेमाल करें. कोड को आसानी से पढ़ने के लिए,
इस कोड सैंपल में लाइन रिटर्न का इस्तेमाल किया गया है:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
customerId
, ग्राहक के Google खाते का यूनीक आइडेंटिफ़ायर है.- खाते के एडमिन के तौर पर,
my_customer
स्ट्रिंग का इस्तेमाल भी किया जा सकता है. यह स्ट्रिंग, आपके खाते केcustomerId
को दिखाती है.customerId
वैल्यू पाने का दूसरा तरीका, उपयोगकर्ता को फिर से हासिल करना ऑपरेशन का इस्तेमाल करना है. ऑपरेशन केuserKey
पाथ पैरामीटर में, अपने एडमिन ईमेल पते या एडमिन के यूनीक उपयोगकर्ताid
की वैल्यू का इस्तेमाल करें.
अनुरोध और रिस्पॉन्स प्रॉपर्टी के लिए, एपीआई का रेफ़रंस देखें.
JSON अनुरोध
यहां दिया गया JSON अनुरोध, तीन Chrome डिवाइसों को /Marketing
नाम की संगठन की इकाई में ले जाने के लिए, अनुरोध का सैंपल दिखाता है:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing
डिवाइस को दूसरी जगह ले जाने के लिए अनुरोध का मुख्य हिस्सा यह है:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"] }
अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड दिखता है.