API Directory: dispositivi Chrome

di Gemini Advanced.

Recuperare tutti i dispositivi Chrome associati a un account

Per visualizzare un elenco di tutti i dispositivi Chrome assegnati a un account, utilizza la seguente istruzione richiedere GET e includere l'autorizzazione descritta in Autorizzare le richieste. Per una migliore leggibilità, in questo esempio di codice vengono restituiti i ritorni a riga: 

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

  • Il customerId è un identificatore univoco dell'Account Google del cliente.
  • In qualità di amministratore dell'account, puoi anche utilizzare la stringa my_customer, che rappresenta il customerId del tuo account. Un altro modo per recuperare customerId è utilizzare il comando Recupera un utente operativa. Utilizza il tuo indirizzo email di amministratore o l'utente univoco dell'amministratore id nel parametro del percorso userKey dell'operazione.

Per le stringhe di query e le proprietà di richiesta e risposta, consulta Riferimento API.

Esempio: filtrare i dispositivi in base all'utente

In questo esempio viene cercato un utente specifico utilizzando query=user:help desk. La contiene una singola risorsa chromeosdevice, in cui annotatedUser è help desk:

Richiesta 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

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

Esempio: filtrare i dispositivi in base al numero di serie

In questo esempio viene cercato un numero di serie specifico utilizzando query=id:123456, dove 123456 è il numero di serie del dispositivo. La risposta mostrata di seguito contiene una singola risposta corrispondente, in cui il parametro La proprietà serialNumber corrisponde al valore di ricerca.

Richiesta 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

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

Questo esempio di risposta include model, meid e macAddress proprietà. Se un dispositivo non dispone di queste proprietà, non saranno incluso nella risposta. Per i dettagli completi, consulta Rappresentazione delle risorse dei dispositivi ChromeOS.

Esportare un elenco MEID

Il meid è l'identificatore MEID (Mobile Equipment Identifier) della scheda per dispositivi mobili 3G in una Dispositivo Chrome. Il codice MEID viene generalmente utilizzato quando si aggiunge un dispositivo all'account di un operatore wireless piano di servizio con pagamento posticipato. Per esportare l'elenco MEID, usa la seguente richiesta GET e i valori nextPageToken per recuperare l'elenco completo dei MEID. Per una migliore leggibilità, l'esempio di codice presenta ritorni a riga: 

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

Recuperare un dispositivo Chrome

Per recuperare le proprietà di un dispositivo Chrome, utilizza la seguente richiesta GET e includono l'autorizzazione descritta in Autorizzare le richieste. Per una migliore leggibilità, in questo esempio di codice vengono restituiti i ritorni a riga: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • Il customerId è un identificatore univoco dell'Account Google del cliente.
  • In qualità di amministratore dell'account, puoi anche utilizzare la stringa my_customer, che rappresenta il customerId del tuo account. Un altro modo per recuperare customerId è utilizzare il comando Recupera un utente operativa. Utilizza il tuo indirizzo email di amministratore o l'utente univoco dell'amministratore id nel parametro del percorso userKey dell'operazione.
  • deviceId è un identificatore univoco di un dispositivo e si trova nella risposta di l'operazione Recupera tutti i dispositivi Chrome.

Per le stringhe di query e le proprietà di richiesta e risposta, consulta Riferimento API.

Richiesta JSON

Una richiesta di esempio. Per migliorarne la leggibilità, questo esempio di codice presenta dei ritorni a riga: 
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos/deviceId?projection=full

Risposta JSON

Una richiesta andata a buon fine restituisce un Codice di stato HTTP 200. Insieme a il codice di stato, la risposta restituisce le proprietà del dispositivo 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"
}

Aggiornare un dispositivo Chrome

Per aggiornare un dispositivo Chrome, usa la seguente richiesta di PUT e includi i campi l'autorizzazione descritta in Autorizzare le richieste. Per una migliore leggibilità, in questo esempio di codice vengono restituiti i ritorni a riga: 

PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • Il customerId è un identificatore univoco dell'Account Google del cliente.
  • In qualità di amministratore dell'account, puoi anche utilizzare la stringa my_customer, che rappresenta il customerId del tuo account. Un altro modo per recuperare customerId è utilizzare il comando Recupera un utente operativa. Utilizza il tuo indirizzo email di amministratore o l'utente univoco dell'amministratore id nel parametro del percorso userKey dell'operazione.
  • deviceId è un identificatore univoco di un dispositivo e si trova nella risposta di l'operazione Recupera tutti i dispositivi Chrome.

Per le stringhe di query e le proprietà di richiesta e risposta, consulta Riferimento API.

Richiesta JSON

La seguente richiesta JSON di esempio aggiorna annotatedUser di un dispositivo Chrome, annotatedLocation, annotatedAssetId, notes e orgUnitPath proprietà. Per migliorarne la leggibilità, questo esempio di codice presenta dei ritorni a riga: 

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/deviceId?projection=full
Esempio di corpo della richiesta: 
{
  "deviceId": "device_id_value",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "1234567890",
  "notes": "Loaned from support",
  "orgUnitPath": "/corp/sales"
}

Per una richiesta di aggiornamento, includi nella richiesta solo le proprietà con valori aggiornati.

Una richiesta andata a buon fine restituisce un Codice di stato HTTP 200. Insieme a il codice di stato, la risposta restituisce le proprietà del dispositivo Chrome aggiornato.

Deprovisioning o disattivazione dei dispositivi Chrome

Per eseguire il deprovisioning o disattivare i dispositivi Chrome, utilizza la seguente richiesta POST e includere l'autorizzazione descritta in Autorizzare le richieste. Per una migliore leggibilità, in questo esempio di codice vengono restituiti i ritorni a riga: 

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

  • Il customerId è un identificatore univoco dell'Account Google del cliente.
  • In qualità di amministratore dell'account, puoi anche utilizzare la stringa my_customer, che rappresenta il customerId del tuo account. Un altro modo per recuperare customerId è utilizzare il comando Recupera un utente operativa. Utilizza il tuo indirizzo email di amministratore o l'utente univoco dell'amministratore id nel parametro del percorso userKey dell'operazione.

Per le proprietà della richiesta e della risposta, consulta Riferimento API.

Richiesta JSON

La seguente richiesta JSON mostra una richiesta di esempio per il deprovisioning e la disattivazione Dispositivi Chrome: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
Il corpo della richiesta per un deprovisioning di esempio è: 
{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
  "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION",
  "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE"
}
Il corpo della richiesta per la disattivazione è: 
  {
    "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
    "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
  }

Una richiesta andata a buon fine restituisce un Codice di stato HTTP 200.

Sposta i dispositivi Chrome nell'unità organizzativa

Per spostare fino a 50 dispositivi Chrome in un'unità organizzativa, usa quanto segue richiedere POST e includere l'autorizzazione descritta in Autorizzare le richieste. Per una migliore leggibilità, in questo esempio di codice vengono restituiti i ritorni a riga: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
  • Il customerId è un identificatore univoco dell'Account Google del cliente.
  • In qualità di amministratore dell'account, puoi anche utilizzare la stringa my_customer, che rappresenta il customerId del tuo account. Un altro modo per recuperare customerId è l'utilizzo della funzione Recupera dell'utente. Utilizza il tuo indirizzo email di amministratore o l'utente unico dell'amministratore Valore id nel parametro del percorso userKey dell'operazione.

Per le proprietà della richiesta e della risposta, consulta Riferimento API.

Richiesta JSON

La seguente richiesta JSON mostra una richiesta di esempio per spostare tre dispositivi Chrome in un Unità organizzativa denominata /Marketing: 

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

Il corpo della richiesta per lo spostamento del dispositivo è:

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

Una richiesta andata a buon fine restituisce un Codice di stato HTTP 200.