Method: enterprises.devices.issueCommand

string

Es el nombre del dispositivo con el 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)

Es el tipo del comando.

string (Timestamp format)

La marca de tiempo en la que se creó el comando El servidor genera automáticamente la marca de tiempo.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Es la duración de la validez del comando. El comando vencerá si el dispositivo no lo ejecuta durante este tiempo. Si no se especifica, la duración predeterminada es de diez minutos. No hay duración máxima.

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

string

El nombre de recurso del usuario que posee el dispositivo con el formato enterprises/{enterpriseId}/users/{userId}. El servidor lo genera automáticamente en función del dispositivo al que se envía el comando.

enum (CommandErrorCode)

Si el comando falló, un código que explica el error Esto no se establece cuando el llamador cancela el comando.

string

Para los comandos de tipo RESET_PASSWORD, especifica de manera opcional la contraseña nueva. Nota: La nueva contraseña debe tener al menos 6 caracteres si es numérica en el caso de los dispositivos con Android 14. De lo contrario, el comando fallará con INVALID_VALUE.

enum (ResetPasswordFlag)

De manera opcional, para los comandos de tipo RESET_PASSWORD, especifica las marcas.

object (ClearAppsDataParams)

Son los parámetros del comando CLEAR_APP_DATA para borrar del dispositivo los datos de apps especificadas. Consulta los ClearAppsDataParams. Si se configura, se sugiere que no se establezca type. En este caso, el servidor lo configura automáticamente en CLEAR_APP_DATA. También es posible establecer type en CLEAR_APP_DATA de forma explícita.

object (StartLostModeParams)

Son los parámetros del comando START_LOST_MODE para poner el dispositivo en modo extraviado. Consulta los StartLostModeParams. Si se configura, se sugiere que no se establezca type. En este caso, el servidor lo configura automáticamente en START_LOST_MODE. También es posible establecer type en START_LOST_MODE de forma explícita.

object (StopLostModeParams)

Son los parámetros del comando STOP_LOST_MODE para quitar el dispositivo del modo extraviado. Consulta los StopLostModeParams. Si se configura, se sugiere que no se establezca type. En este caso, el servidor lo configura automáticamente en STOP_LOST_MODE. También es posible establecer type en STOP_LOST_MODE de forma explícita.

object (ClearAppsDataStatus)

Solo salida. Estado del comando CLEAR_APP_DATA para borrar del dispositivo los datos de las apps especificadas. Consulta los ClearAppsDataStatus.

object (StartLostModeStatus)

Solo salida. Estado del comando START_LOST_MODE para poner el dispositivo en modo extraviado. Consulta los StartLostModeStatus.

object (StopLostModeStatus)

Solo salida. Estado del comando STOP_LOST_MODE para quitar el dispositivo del modo extraviado. Consulta los StopLostModeStatus.

{
  "packageNames": [
    string
  ]
}

string

Los nombres de paquetes de las apps cuyos datos se borrarán cuando se ejecute el comando.

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

object (UserFacingMessage)

Es el mensaje que se muestra al usuario cuando el dispositivo está en modo extraviado.

object (UserFacingMessage)

Es el número de teléfono que se muestra al usuario cuando el dispositivo está en modo extraviado.

string

Es la dirección de correo electrónico que se muestra al usuario cuando el dispositivo está en modo extraviado.

object (UserFacingMessage)

Es la dirección que se muestra al usuario cuando el dispositivo está en modo extraviado.

object (UserFacingMessage)

Es el nombre de la organización que se muestra al usuario cuando el dispositivo está en modo extraviado.

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

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

Los resultados por app, una asignación de nombres de paquetes al resultado de limpieza correspondiente.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

Es el resultado de un intento de borrar los datos de una sola app.

{
  "status": enum (Status)
}

enum (Status)

El estado. Consulta los StartLostModeStatus.

{
  "status": enum (Status)
}

enum (Status)

El estado. Consulta los StopLostModeStatus.