Method: chromeosdevices.action

Utilizza BatchChangeChromeOsDeviceStatus. Esegue un'azione che interessa un dispositivo ChromeOS. Ciò include il deprovisioning, la disattivazione e la riattivazione dei dispositivi.

Richiesta HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

L'ID univoco dell'account Google Workspace del cliente. In qualità di amministratore dell'account, puoi anche utilizzare l'alias my_customer per rappresentare il customerId del tuo account. customerId viene restituito anche all'interno della risorsa Utenti.

resourceId

string

L'ID univoco del dispositivo. I resourceId vengono restituiti nella risposta del metodo chromeosdevices.list.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di ChromeOsDeviceAction.

Corpo della risposta

In caso di esito positivo, la risposta è una risposta HTTP generica il cui formato è definito dal metodo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ChromeOsDeviceAction

Dati su un aggiornamento dello stato di un dispositivo ChromeOS.

Rappresentazione JSON
{
  "action": string,
  "deprovisionReason": string
}
Campi
action

string

chromeosdevices.action da eseguire sul dispositivo ChromeOS.

I valori accettabili sono:

  • deprovision: rimuovi dalla gestione un dispositivo non più attivo, in fase di rivenduto o da restituire o riparare. Utilizza l'azione di deprovisioning per dissociarlo dalla gestione.
  • disable: se ritieni che un dispositivo della tua organizzazione sia stato perso o rubato, puoi disattivarlo in modo che nessun altro possa utilizzarlo. Quando un dispositivo viene disattivato, l'utente può vedere solo una schermata che lo informa della disattivazione e i tuoi dati di contatto per la restituzione del dispositivo.
  • reenable: riattiva un dispositivo disattivato quando viene trovato un dispositivo smarrito o viene restituito un dispositivo smarrito. Puoi utilizzare questa funzionalità anche se contrassegni per errore un dispositivo Chrome come disattivato.
  • pre_provisioned_disable: un dispositivo di cui è stato eseguito il pre-provisioning che non può essere registrato. Un amministratore può riattivare il dispositivo per consentire la registrazione zero-touch modificando lo stato in "pre_provisioned_reenable". Nota: da questo stato è possibile eseguire il deprovisioning del dispositivo.
  • pre_provisioned_reenable: gli OEM hanno eseguito il pre-provisioning del dispositivo. I dispositivi in questo stato sono idonei per la registrazione zero-touch.
deprovisionReason

string

Utilizzato solo quando l'azione è di deprovisioning. Con l'azione di deprovisioning, questo campo è obbligatorio.

I valori accettabili sono:

  • different_model_replacement: da utilizzare se esegui l'upgrade o sostituisci il dispositivo con un modello più recente dello stesso tipo.
  • retiring_device: da utilizzare se vendi, doni o rimuovi definitivamente il dispositivo dall'uso.
  • same_model_replacement: da utilizzare se è stato riscontrato un problema hardware su un dispositivo e questo viene sostituito con lo stesso modello o con un modello simile da un fornitore / produttore di servizi di riparazione.
  • upgrade_transfer: da utilizzare se sostituisci i dispositivi Cloud Ready con Chromebook entro un anno.