Method: chromeosdevices.action

Utilizza invece BatchChangeChromeOsDeviceStatus. Esegue un'azione che ha impatto su un dispositivo ChromeOS. Sono incluse le attività di deprovisioning, disattivazione e 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 le customerId del tuo account. customerId viene restituito anche come parte della risorsa Utenti.
resourceId

string

L'ID univoco del dispositivo. I resourceId vengono restituiti nella risposta dal 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 alle autorizzazioni.

ChromeOsDeviceAction

Dati relativi a un aggiornamento dello stato di un dispositivo ChromeOS.

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

string

chromeosdevices.action da eseguire sul dispositivo Chrome OS.

I valori accettati sono:

  • deprovision: per rimuovere dalla gestione un dispositivo che non è più attivo, che è in fase di rivendita o che viene inviato per una restituzione o una riparazione, utilizza l'azione di deprovisioning per annullare l'associazione con la gestione.
  • disable: se ritieni che un dispositivo della tua organizzazione sia stato smarrito o rubato, puoi disattivarlo in modo che nessun altro possa utilizzarlo. Quando un dispositivo è disattivato, l'unica cosa che l'utente può vedere quando accende il dispositivo Chrome è una schermata che comunica che il dispositivo è stato disattivato e le informazioni di contatto desiderate per la restituzione del dispositivo.
  • reenable: riattiva un dispositivo disattivato quando viene trovato un dispositivo smarrito o se viene restituito un dispositivo smarrito. Puoi utilizzare questa funzionalità anche se contrassegni accidentalmente 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: con questo stato è possibile eseguire il deprovisioning del dispositivo.
  • pre_provisioned_reenable: il provisioning del dispositivo è stato eseguito dagli OEM. I dispositivi in questo stato sono idonei per la registrazione zero-touch.
deprovisionReason

string

Utilizzato solo quando è in corso il deprovisioning dell'azione. Con l'azione di deprovisioning, questo campo è obbligatorio.

I valori accettati sono:

  • different_model_replacement: da utilizzare se stai eseguendo l'upgrade del dispositivo o se stai sostituendo il tuo dispositivo con un modello più recente dello stesso dispositivo.
  • retiring_device: da usare per 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 a quello di un fornitore di servizi di riparazione / produttore.
  • upgrade_transfer: da utilizzare se stai sostituendo i tuoi dispositivi cloud con Chromebook entro un anno.