डायरेक्ट्री एपीआई: 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 पाने का एक और तरीका मान है कि उपयोगकर्ता को वापस पाएं का इस्तेमाल किया जाए कार्रवाई. अपने एडमिन के ईमेल पते या अपने एडमिन खाते के यूनीक उपयोगकर्ता id का इस्तेमाल करें वैल्यू, कार्रवाई के userKey पाथ पैरामीटर में है.

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

उदाहरण: उपयोगकर्ता के हिसाब से डिवाइस फ़िल्टर करें

इस उदाहरण में, 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 डिवाइस. 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 पाने का एक और तरीका मान है कि उपयोगकर्ता को वापस पाएं का इस्तेमाल किया जाए कार्रवाई. अपने एडमिन के ईमेल पते या अपने एडमिन खाते के यूनीक उपयोगकर्ता id का इस्तेमाल करें वैल्यू, कार्रवाई के userKey पाथ पैरामीटर में है.
  • 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 पाने का एक और तरीका मान है कि उपयोगकर्ता को वापस पाएं का इस्तेमाल किया जाए कार्रवाई. अपने एडमिन के ईमेल पते या अपने एडमिन खाते के यूनीक उपयोगकर्ता id का इस्तेमाल करें वैल्यू, कार्रवाई के userKey पाथ पैरामीटर में है.
  • 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 पाने का एक और तरीका मान है कि उपयोगकर्ता को वापस पाएं का इस्तेमाल किया जाए कार्रवाई. अपने एडमिन के ईमेल पते या अपने एडमिन खाते के यूनीक उपयोगकर्ता id का इस्तेमाल करें वैल्यू, कार्रवाई के userKey पाथ पैरामीटर में है.

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

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 स्टेटस कोड.