Directory API: ChromeOS cihazlar

Hesaplar için tüm ChromeOS cihazlarını alma

Bir hesaba atanmış tüm ChromeOS cihazlarının listesini döndürmek için aşağıdaki GET isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi ekleyin. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 

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 tanımlayıcısıdır.
  • Hesap yöneticisi olarak, hesabınızın customerId değerini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da Kullanıcı alma işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı id değerini kullanın.

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

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

Bu örnekte, query=user:help desk kullanılarak belirli bir kullanıcı aranmaktadır. Yanıt, annotatedUser değeri help desk olan tek bir chromeosdevice kaynağı içerir:

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, 123456 cihazın seri numarası olmak kaydıyla query=id:123456 kullanılarak belirli bir seri numarası aranır. Aşağıda gösterilen yanıt, serialNumber mülkünün arama değeriyle eşleştiği tek bir eşleşen yanıt içerir.

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 özellikleri yer almaktadır. Bir cihazda bu özellikler yoksa bunlar yanıta dahil edilmez. Ayrıntılı bilgi için Chromeosdevices kaynak temsili başlıklı makaleyi inceleyin.

MEID listesini dışa aktarma

meid, ChromeOS cihazdaki 3G mobil kartın Mobil Cihaz Kimliği'dir (MEID). MEID, genellikle bir cihazı kablosuz operatörün faturalı hizmet planına eklerken kullanılır. 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. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 

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

ChromeOS cihazı alma

ChromeOS cihazlarının özelliklerini almak için aşağıdaki GET isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi dahil edin. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 

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 tanımlayıcısıdır.
  • Hesap yöneticisi olarak, hesabınızın customerId değerini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da Kullanıcı alma işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı id değerini kullanın.
  • deviceId, cihazın benzersiz tanımlayıcısıdır ve Tüm ChromeOS cihazlarını alma işleminin yanıtında bulunur.

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

JSON isteği

Bir istek örneği. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 
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 döndürür. Yanıt, durum koduyla birlikte ChromeOS 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"
}

ChromeOS cihazı güncelleme

Bir ChromeOS cihazı güncellemek için aşağıdaki PUT isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi ekleyin. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 

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 tanımlayıcısıdır.
  • Hesap yöneticisi olarak, hesabınızın customerId değerini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da Kullanıcı alma işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı id değerini kullanın.
  • deviceId, cihazın benzersiz tanımlayıcısıdır ve Tüm ChromeOS cihazlarını alma işleminin yanıtında bulunur.

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

JSON isteği

Aşağıdaki örnek JSON isteği, bir ChromeOS cihazın annotatedUser, annotatedLocation, annotatedAssetId, notes ve orgUnitPath özelliklerini günceller. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/deviceId?projection=full
 İstek metni ö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 isteğinize yalnızca güncellenmiş değerlere sahip mülkleri ekleyin.

Başarılı bir istek HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte güncellenen ChromeOS cihazın özelliklerini döndürür.

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

ChromeOS 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 yetkilendirme bölümünde açıklanan yetkilendirmeyi ekleyin. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 

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

  • customerId, müşterinin Google Hesabı'nın benzersiz tanımlayıcısıdır.
  • Hesap yöneticisi olarak, hesabınızın customerId değerini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da Kullanıcı alma işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı id değerini kullanın.

İstek ve yanıt özellikleri için API Referansı'na bakın.

JSON isteği

Aşağıdaki JSON isteği, ChromeOS cihazların temel hazırlığını kaldırma ve devre dışı bırakmayla ilgili örnek bir isteği göstermektedir: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
 Örnek bir erişim izninin kaldırılmasına ilişkin istek metni: 
{
  "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 metni: 
  {
    "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
    "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
  }

Başarılı bir istek HTTP 200 durum kodu döndürür.

ChromeOS cihazları kuruluş birimine taşıma

50'ye kadar ChromeOS cihazı bir kuruluş birimine taşımak için aşağıdaki POST isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi ekleyin. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
  • customerId, müşterinin Google Hesabı'nın benzersiz tanımlayıcısıdır.
  • Hesap yöneticisi olarak, hesabınızın customerId değerini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da Kullanıcı alma işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı id değerini kullanın.

İstek ve yanıt özellikleri için API Referansı'na bakın.

JSON isteği

Aşağıdaki JSON isteği, 3 ChromeOS cihazı /Marketing adlı bir kuruluş birimine taşımak için örnek bir istek gösterir: 

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

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

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

Başarılı bir istek HTTP 200 durum kodu döndürür.