- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Comando
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- Stato
- StopLostModeStatus
- Stato
- Prova!
Invia un comando a un dispositivo. La risorsa Operation
restituita contiene un elemento Command
nel campo metadata
. Utilizza il metodo operativo get per ottenere lo stato del comando.
Richiesta HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Il nome del dispositivo nel formato |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Command
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidmanagement
Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
Comando
Un comando.
Rappresentazione JSON |
---|
{ "type": enum ( |
Campi | |
---|---|
type |
Il tipo di comando. |
createTime |
Il timestamp in cui è stato creato il comando. Il timestamp viene generato automaticamente dal server. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
duration |
La durata di validità del comando. Il comando scadrà se non viene eseguito dal dispositivo durante questo periodo. Se non specificata, la durata predefinita è dieci minuti. Non esiste una durata massima. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
userName |
Il nome della risorsa dell'utente proprietario del dispositivo nel formato |
errorCode |
Se il comando non è riuscito, un codice di errore che spiega l'errore. Non è impostato quando il comando viene annullato dal chiamante. |
newPassword |
Per i comandi di tipo |
resetPasswordFlags[] |
Per i comandi di tipo |
Campo di unione Se questa impostazione è impostata, i campi |
|
clearAppsDataParams |
Parametri per il comando |
startLostModeParams |
Parametri per il comando |
stopLostModeParams |
Parametri per il comando |
Campo di unione status . Stato specifico del comando. Tieni presente che alcuni comandi non la utilizzano, in particolare , , e . In futuro potrebbero essere usati anche questi comandi. status può essere solo uno dei seguenti: |
|
clearAppsDataStatus |
Solo output. Stato del comando |
startLostModeStatus |
Solo output. Stato del comando |
stopLostModeStatus |
Solo output. Stato del comando |
CommandType
Tipi di comandi.
Enum | |
---|---|
COMMAND_TYPE_UNSPECIFIED |
Questo valore non è consentito. |
LOCK |
Blocca il dispositivo come se il timeout della schermata di blocco fosse scaduto. |
RESET_PASSWORD |
Reimpostare la password dell'utente. |
REBOOT |
Riavvia il dispositivo. Funzionalità supportata solo sui dispositivi completamente gestiti con Android 7.0 (livello API 24) o versioni successive. |
RELINQUISH_OWNERSHIP |
Rimuove il profilo di lavoro e tutti i criteri da un dispositivo Android 8.0 o versioni successive di proprietà dell'azienda, cedendo il dispositivo per uso personale. Le app e i dati associati ai profili personali vengono conservati. Il dispositivo verrà eliminato dal server dopo che avrà confermato il comando. |
CLEAR_APP_DATA |
Cancella i dati delle app specificate. Questa funzionalità è supportata su Android 9 e versioni successive. Tieni presente che un'applicazione può archiviare dati al di fuori dei propri dati dell'applicazione, ad esempio in un'unità di archiviazione esterna o in un dizionario utente. Vedi anche . |
START_LOST_MODE |
Attiva la modalità Dispositivo smarrito sul dispositivo. Funzionalità supportata solo sui dispositivi completamente gestiti o di proprietà dell'organizzazione con un profilo gestito. Vedi anche . |
STOP_LOST_MODE |
Consente di disattivare la modalità Dispositivo smarrito. Funzionalità supportata solo sui dispositivi completamente gestiti o di proprietà dell'organizzazione con un profilo gestito. Vedi anche . |
CommandErrorCode
Un codice di errore del comando. Si tratta di un campo di sola lettura compilato dal server.
Enum | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED |
Non si è verificato alcun errore. |
UNKNOWN |
Si è verificato un errore sconosciuto. |
API_LEVEL |
Il livello API del dispositivo non supporta questo comando. |
MANAGEMENT_MODE |
La modalità di gestione (proprietario del profilo, proprietario del dispositivo e così via) non supporta il comando. |
INVALID_VALUE |
Il comando contiene un valore del parametro non valido. |
UNSUPPORTED |
Il dispositivo non supporta il comando. L'aggiornamento di Android Device Policy alla versione più recente potrebbe risolvere il problema. |
ResetPasswordFlag
Flag utilizzabili per il tipo di comando RESET_PASSWORD
.
Enum | |
---|---|
RESET_PASSWORD_FLAG_UNSPECIFIED |
Questo valore viene ignorato. |
REQUIRE_ENTRY |
Non consentire ad altri amministratori di cambiare di nuovo la password finché l'utente non l'ha inserita. |
DO_NOT_ASK_CREDENTIALS_ON_BOOT |
Non chiedere le credenziali utente all'avvio del dispositivo. |
LOCK_NOW |
Blocca il dispositivo dopo la reimpostazione della password. |
ClearAppsDataParams
Parametri associati al comando
per cancellare dal dispositivo i dati delle app specificate.CLEAR_APP_DATA
Rappresentazione JSON |
---|
{ "packageNames": [ string ] } |
Campi | |
---|---|
packageNames[] |
I nomi dei pacchetti delle app i cui dati verranno cancellati quando viene eseguito il comando. |
StartLostModeParams
Parametri associati al comando
per attivare la modalità Dispositivo smarrito. Per attivare la modalità Dispositivo smarrito è necessario specificare almeno uno dei parametri, escluso il nome dell'organizzazione.START_LOST_MODE
Rappresentazione JSON |
---|
{ "lostMessage": { object ( |
Campi | |
---|---|
lostMessage |
Il messaggio mostrato all'utente quando il dispositivo è in modalità Dispositivo smarrito. |
lostPhoneNumber |
Il numero di telefono che verrà chiamato quando il dispositivo è in modalità Dispositivo smarrito e si tocca il pulsante Chiama proprietario. |
lostEmailAddress |
L'indirizzo email visualizzato all'utente quando il dispositivo è in modalità Dispositivo smarrito. |
lostStreetAddress |
La via mostrata all'utente quando il dispositivo è in modalità Dispositivo smarrito. |
lostOrganization |
Il nome dell'organizzazione mostrato all'utente quando il dispositivo è in modalità Dispositivo smarrito. |
StopLostModeParams
Questo tipo non contiene campi.
Parametri associati al comando
per disattivare la modalità Dispositivo smarrito.STOP_LOST_MODE
ClearAppsDataStatus
Stato del comando
per cancellare dal dispositivo i dati delle app specificate.CLEAR_APP_DATA
Rappresentazione JSON |
---|
{
"results": {
string: {
object ( |
Campi | |
---|---|
results |
I risultati per app, una mappatura dai nomi dei pacchetti al rispettivo risultato di cancellazione. Un oggetto contenente un elenco di |
PerAppResult
Il risultato di un tentativo di cancellare i dati di una singola app.
Rappresentazione JSON |
---|
{
"clearingResult": enum ( |
Campi | |
---|---|
clearingResult |
Il risultato di un tentativo di cancellare i dati di una singola app. |
ClearingResult
Il risultato di un tentativo di cancellare i dati di una singola app.
Enum | |
---|---|
CLEARING_RESULT_UNSPECIFIED |
Risultato non specificato. |
SUCCESS |
I dati di questa app sono stati cancellati. |
APP_NOT_FOUND |
Impossibile cancellare i dati di questa app perché non è stata trovata. |
APP_PROTECTED |
Impossibile cancellare i dati di questa app perché è protetta. Ciò potrebbe riguardare, ad esempio, app essenziali per il funzionamento del dispositivo, come Google Play Store. |
API_LEVEL |
Impossibile cancellare i dati di questa app perché il livello API del dispositivo non supporta questo comando. |
StartLostModeStatus
Stato del comando
per attivare la modalità Dispositivo smarrito.START_LOST_MODE
Rappresentazione JSON |
---|
{
"status": enum ( |
Campi | |
---|---|
status |
Lo stato. Leggi i |
Stato
Lo stato. Leggi i
.StartLostModeStatus
Enum | |
---|---|
STATUS_UNSPECIFIED |
Non specificato. Questo valore non è utilizzato. |
SUCCESS |
Sul dispositivo è stata attivata la modalità Dispositivo smarrito. |
RESET_PASSWORD_RECENTLY |
Non è stato possibile attivare la modalità Dispositivo smarrito perché l'amministratore ha reimpostato di recente la password del dispositivo. |
USER_EXIT_LOST_MODE_RECENTLY |
Non è stato possibile attivare la modalità Dispositivo smarrito perché l'utente è uscito di recente dalla modalità Dispositivo smarrito. |
ALREADY_IN_LOST_MODE |
Il dispositivo è già in modalità Dispositivo smarrito. |
StopLostModeStatus
Stato del comando
per disattivare la modalità Dispositivo smarrito.STOP_LOST_MODE
Rappresentazione JSON |
---|
{
"status": enum ( |
Campi | |
---|---|
status |
Lo stato. Leggi i |
Stato
Lo stato. Leggi i
.StopLostModeStatus
Enum | |
---|---|
STATUS_UNSPECIFIED |
Non specificato. Questo valore non è utilizzato. |
SUCCESS |
Il dispositivo è stato ripristinato dalla modalità Dispositivo smarrito. |
NOT_IN_LOST_MODE |
Il dispositivo non è in modalità Dispositivo smarrito. |