Method: enterprises.devices.issueCommand

string

Il nome del dispositivo nel formato enterprises/{enterpriseId}/devices/{deviceId}.

{
  "type": enum (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  }
  // End of list of possible types for union field status.
}

enum (CommandType)

Il tipo di comando.

string (Timestamp format)

Il timestamp della creazione del comando. Il timestamp viene generato automaticamente dal server.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Duration format)

La durata di validità del comando. Il comando scadrà se non viene eseguito dal dispositivo durante questo periodo di tempo. Se non specificato, la durata predefinita è di dieci minuti. Non è prevista una durata massima.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

string

Il nome della risorsa dell'utente proprietario del dispositivo nel formato enterprises/{enterpriseId}/users/{userId}. Viene generato automaticamente dal server in base al dispositivo a cui viene inviato il comando.

enum (CommandErrorCode)

Se il comando non è riuscito, viene visualizzato un codice di errore che spiega il problema. Questo valore non viene impostato quando il comando viene annullato dall'utente che ha effettuato la chiamata.

string

Per i comandi di tipo RESET_PASSWORD, specifica facoltativamente la nuova password. Nota: la nuova password deve contenere almeno 6 caratteri se è numerica nel caso di dispositivi Android 14. In caso contrario, il comando avrà esito negativo e restituirà INVALID_VALUE.

enum (ResetPasswordFlag)

Per i comandi di tipo RESET_PASSWORD, specifica facoltativamente i flag.

object (ClearAppsDataParams)

Parametri per il comando CLEAR_APP_DATA per cancellare i dati delle app specificate dal dispositivo. Leggi i ClearAppsDataParams. Se questo valore è impostato, si consiglia di non impostare type. In questo caso, il server lo imposta automaticamente su CLEAR_APP_DATA. È anche accettabile impostare esplicitamente type su CLEAR_APP_DATA.

object (StartLostModeParams)

Parametri per il comando START_LOST_MODE per mettere il dispositivo in modalità Dispositivo smarrito. Leggi i StartLostModeParams. Se questo valore è impostato, si consiglia di non impostare type. In questo caso, il server lo imposta automaticamente su START_LOST_MODE. È anche accettabile impostare esplicitamente type su START_LOST_MODE.

object (StopLostModeParams)

Parametri per il comando STOP_LOST_MODE per rimuovere il dispositivo dalla modalità Dispositivo smarrito. Leggi i StopLostModeParams. Se questo valore è impostato, si consiglia di non impostare type. In questo caso, il server lo imposta automaticamente su STOP_LOST_MODE. È anche accettabile impostare esplicitamente type su STOP_LOST_MODE.

object (ClearAppsDataStatus)

Solo output. Stato del comando CLEAR_APP_DATA per cancellare i dati delle app specificate dal dispositivo. Leggi i ClearAppsDataStatus.

object (StartLostModeStatus)

Solo output. Stato del comando START_LOST_MODE per mettere il dispositivo in modalità Dispositivo smarrito. Leggi i StartLostModeStatus.

object (StopLostModeStatus)

Solo output. Stato del comando STOP_LOST_MODE per rimuovere il dispositivo dalla modalità Dispositivo smarrito. Leggi i StopLostModeStatus.

{
  "packageNames": [
    string
  ]
}

string

I nomi dei pacchetti delle app di cui verranno cancellati i dati quando viene eseguito il comando.

{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}

object (UserFacingMessage)

Il messaggio visualizzato all'utente quando il dispositivo è in modalità Dispositivo smarrito.

object (UserFacingMessage)

Il numero di telefono che verrà chiamato quando il dispositivo è in modalità Dispositivo smarrito e viene toccato il pulsante Chiama proprietario.

string

L'indirizzo email visualizzato all'utente quando il dispositivo è in modalità Dispositivo smarrito.

object (UserFacingMessage)

L'indirizzo visualizzato all'utente quando il dispositivo è in modalità Dispositivo smarrito.

object (UserFacingMessage)

Il nome dell'organizzazione visualizzato all'utente quando il dispositivo è in modalità Dispositivo smarrito.

{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}

map (key: string, value: object (PerAppResult))

I risultati per app, una mappatura dai nomi dei pacchetti al rispettivo risultato di approvazione.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

Il risultato di un tentativo di cancellare i dati di una singola app.

{
  "status": enum (Status)
}

enum (Status)

Lo stato. Leggi i StartLostModeStatus.

{
  "status": enum (Status)
}

enum (Status)

Lo stato. Leggi i StopLostModeStatus.