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 i customerId del tuo account. customerId viene restituito anche nell'ambito 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

Se l'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.azione da intraprendere sul dispositivo ChromeOS.

I valori accettati 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 è disattivato, all'accensione del dispositivo Chrome viene visualizzata una schermata che informa che il dispositivo è stato disattivato e i dati di contatto desiderati con cui restituire il 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 viene eseguito il deprovisioning dell'azione. Questo campo è obbligatorio quando è attiva l'azione di deprovisioning.

I valori accettati sono:

  • different_model_replacement: utilizza questa opzione se vuoi eseguire l'upgrade o la sostituzione del dispositivo con un modello più recente dello stesso dispositivo.
  • retiring_device: da utilizzare se vuoi rivendere, donare o rimuovere definitivamente il dispositivo dall'uso.
  • same_model_replacement: da utilizzare se si è verificato un problema hardware su un dispositivo che viene sostituito con lo stesso modello o con un modello sostitutivo simile da un fornitore / produttore di riparazioni.
  • upgrade_transfer: utilizza questa opzione se stai sostituendo i dispositivi cloud con Chromebook entro un anno.