Directory API: Chrome डिवाइस

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