Directory API: Chrome cihazlar

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

Bir hesaba atanmış tüm Chrome 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 üzere 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, Chrome cihazdaki 3G mobil kartın Mobil Ekipman Kimliği'dir (MEID). MEID, genellikle bir cihazı kablosuz operatörün faturalı servis 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 girin. 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)

Chrome cihazını alma

Chrome 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 Chrome 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 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 İ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 Chrome 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 Chrome 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 Chrome cihazın özelliklerini döndürür.

Chrome cihazların temel hazırlığını kaldırma veya cihazları 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 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, Chrome 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.

Chrome cihazları kuruluş birimine taşıma

Bir kuruluş birimine 50'ye kadar Chrome cihazı 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ğinde, 3 Chrome cihazını /Marketing adlı bir kuruluş birimine taşımak için örnek bir istek gösterilmektedir: 

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.