Directory API: Chrome cihazlar

ziyaret edin.

Bir hesaba ait tüm Chrome cihazları alma

Bir hesaba atanmış tüm Chrome cihazların listesini döndürmek için şunu kullanın: GET isteği gönderin ve aşağıdaki sayfada açıklanan yetkilendirmeyi ekleyin: İstekleri yetkilendirin. Okunabilirlik açısından bu kod örneğinde satır sonuçları var: 

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, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Hesap yöneticisi olarak, my_customer dizesini de kullanabilirsiniz. hesabınızın customerId değerini temsil eder. customerId almanın başka bir yolu değeri Kullanıcı alma işlemidir. Yönetici e-posta adresinizi veya yönetici benzersiz kullanıcınızı (id) kullanın değeri, işlemin userKey yol parametresidir.

Sorgu dizeleri, istek ve yanıt özellikleri için API Referansı.

Örnek: Cihazları kullanıcıya göre filtreleme

Bu örnekte, query=user:help desk kullanılarak belirli bir kullanıcı aranır. İlgili içeriği oluşturmak için kullanılan yanıt tek bir chromeosdevice kaynağı içerir ve burada annotatedUser değeri help desk:

JSON isteği

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 yanıtı

{
  "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"
}

Örnek: Cihazları seri numarasına göre filtreleme

Bu örnekte, query=id:123456, burada 123456 değeri seri numarasını girin. Aşağıda gösterilen yanıt, eşleşen tek bir yanıt içerir. Burada serialNumber özelliği, arama değeriyle eşleşiyor.

JSON isteği

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 yanıtı

{
  "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"
}

Bu yanıt örneğinde model, meid ve macAddress mülk. Bir cihaz bu özelliklere sahip değilse bu yanıta dahil edilir. Tüm ayrıntılar için bkz. Chromeosdevices kaynak temsili.

MEID listesini dışa aktarma

meid, 3G mobil kartı için Chrome cihaz. MEID genellikle bir cihazı kablosuz operatörün ağına eklerken kullanılır. ödeme yöntemini kullanabilirsiniz. MEID listesini dışa aktarmak için aşağıdaki GET isteğini kullanın ve MEID'lerin tam listesini almak için nextPageToken değerlerini kullanın. Okunabilirlik açısından bu kod örneğinde şu satır sonuçları vardır: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?fields=nextPageToken,chromeosdevices(meid)

Chrome cihazını alma

Bir Chrome cihazın özelliklerini almak için aşağıdaki GET isteğini kullanın ve yukarıda açıklanan yetkilendirmeyi İstekleri yetkilendirin. Okunabilirlik açısından bu kod örneğinde satır sonuçları var: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Hesap yöneticisi olarak, my_customer dizesini de kullanabilirsiniz. hesabınızın customerId değerini temsil eder. customerId almanın başka bir yolu değeri Kullanıcı alma işlemidir. Yönetici e-posta adresinizi veya yönetici benzersiz kullanıcınızı (id) kullanın değeri, işlemin userKey yol parametresidir.
  • deviceId, bir cihazın benzersiz tanımlayıcısıdır ve Tüm Chrome cihazları alma işlemini geri alın.

Sorgu dizeleri, istek ve yanıt özellikleri için API Referansı.

JSON isteği

Örnek istek. Okunabilirlik açısından bu kod örneğinde satır sonları vardır: 
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos/deviceId?projection=full
.

JSON yanıtı

Başarılı bir istek, HTTP 200 durum kodu. Şununla birlikte: kodunu eklediğinizde, yanıt Chrome cihaz özelliklerini döndürür: 

{
  "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 cihazı güncelleme

Bir Chrome cihazı güncellemek için aşağıdaki PUT isteğini kullanın ve şunu ekleyin: yetki belgesinin bu bölümünde İstekleri yetkilendirin. Okunabilirlik açısından bu kod örneğinde satır sonuçları var: 

PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Hesap yöneticisi olarak, my_customer dizesini de kullanabilirsiniz. hesabınızın customerId değerini temsil eder. customerId almanın başka bir yolu değeri Kullanıcı alma işlemidir. Yönetici e-posta adresinizi veya yönetici benzersiz kullanıcınızı (id) kullanın değeri, işlemin userKey yol parametresidir.
  • deviceId, bir cihazın benzersiz tanımlayıcısıdır ve Tüm Chrome cihazları alma işlemini geri alın.

Sorgu dizeleri, istek ve yanıt özellikleri için API Referansı.

JSON isteği

Aşağıdaki örnek JSON isteği, bir Chrome cihazın annotatedUser öğesini günceller. annotatedLocation, annotatedAssetId, notes ve orgUnitPath mülk. Okunabilirlik açısından bu kod örneğinde satır sonları vardır: 

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/deviceId?projection=full
. İstek gövdesi örneği: 
{
  "deviceId": "device_id_value",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "1234567890",
  "notes": "Loaned from support",
  "orgUnitPath": "/corp/sales"
}

Güncelleme isteği için yalnızca güncel değerlere sahip mülkleri isteğinize ekleyin.

Başarılı bir istek, HTTP 200 durum kodu. Şununla birlikte: değerini görürseniz yanıt, güncellenmiş Chrome cihazına ilişkin özellikleri döndürür.

Chrome cihazların temel hazırlığını kaldırma veya devre dışı bırakma

Chrome cihazların temel hazırlığını kaldırmak veya devre dışı bırakmak için aşağıdaki POST isteğini kullanın ve İstekleri yetkilendirin. Okunabilirlik açısından bu kod örneğinde satır sonuçları var: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/
devices/chromeos:batchChangeStatus

  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Hesap yöneticisi olarak, my_customer dizesini de kullanabilirsiniz. hesabınızın customerId değerini temsil eder. customerId almanın başka bir yolu değeri Kullanıcı alma işlemidir. Yönetici e-posta adresinizi veya yönetici benzersiz kullanıcınızı (id) kullanın değeri, işlemin userKey yol parametresidir.

İstek ve yanıt özellikleri için API Referansı.

JSON isteği

Aşağıdaki JSON isteğinde, temel hazırlığı kaldırma ve devre dışı bırakmaya yönelik örnek bir istek gösterilmektedir Chrome cihazlar: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
. Örnek temel hazırlığı kaldırma isteği gövdesi: 
{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
  "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION",
  "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE"
}
Devre dışı bırakma isteği gövdesi: 
  {
    "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
    "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
  }

Başarılı bir istek, HTTP 200 durum kodu.

Chrome cihazları Kuruluş Birimine taşıma

Bir Kuruluş Birimine en fazla 50 Chrome cihaz taşımak için aşağıdakileri kullanın. POST isteği gönderin ve aşağıdaki sayfada açıklanan yetkilendirmeyi ekleyin: İstekleri yetkilendirin. Okunabilirlik açısından bu kod örneğinde satır sonuçları var: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Hesap yöneticisi olarak, my_customer dizesini de kullanabilirsiniz. hesabınızın customerId değerini temsil eder. customerId almanın başka bir yolu değeri bir kullanıcı işlemini seçin. Yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcısını kullanın İşlemin userKey yol parametresindeki id değeri.

İstek ve yanıt özellikleri için API Referansı.

JSON isteği

Aşağıdaki JSON isteğinde, 3 Chrome cihazı bir /Marketing adlı Kuruluş Birimi: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing

Cihaz taşıma isteği gövdesi:

{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"]
}

Başarılı bir istek, HTTP 200 durum kodu.