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 in cui è stato creato il comando. Il timestamp viene generato automaticamente dal server.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi 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 eseguito dal dispositivo durante questo periodo. Se non specificata, la durata predefinita è di dieci minuti. Non esiste una durata massima.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

string

Il nome 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 riesce, viene visualizzato un codice di errore che spiega l'errore. Questa opzione non viene impostata se il comando viene annullato dal chiamante.

string

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

enum (ResetPasswordFlag)

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

object (ClearAppsDataParams)

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

object (StartLostModeParams)

Parametri del comando START_LOST_MODE per attivare la modalità Dispositivo smarrito. Leggi i StartLostModeParams. Se questo criterio è impostato, si consiglia di non impostare type. In questo caso, il server lo imposta automaticamente su START_LOST_MODE. È inoltre accettabile impostare esplicitamente type su START_LOST_MODE.

object (StopLostModeParams)

Parametri del comando STOP_LOST_MODE per disattivare la modalità Dispositivo smarrito. Leggi i StopLostModeParams. Se questo criterio è impostato, si consiglia di non impostare type. In questo caso, il server lo imposta automaticamente su STOP_LOST_MODE. È inoltre 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 attivare la modalità Dispositivo smarrito. Leggi i StartLostModeStatus.

object (StopLostModeStatus)

Solo output. Stato del comando STOP_LOST_MODE per disattivare la modalità Dispositivo smarrito. Leggi i StopLostModeStatus.

{
  "packageNames": [
    string
  ]
}

string

I nomi dei pacchetti delle app i cui dati verranno cancellati all'esecuzione del comando.

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

object (UserFacingMessage)

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

object (UserFacingMessage)

Il numero di telefono che verrà chiamato quando il dispositivo sarà in modalità Dispositivo smarrito e viene toccato il pulsante del proprietario della chiamata.

string

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

object (UserFacingMessage)

La via mostrata all'utente quando il dispositivo è in modalità Dispositivo smarrito.

object (UserFacingMessage)

Il nome dell'organizzazione mostrato 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 cancellazione.

Un oggetto contenente un elenco di "key": value coppie. 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.