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 de comando.

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 durante la cual el comando es válido. 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 una duración máxima.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

string

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

enum (CommandErrorCode)

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

string

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

enum (ResetPasswordFlag)

Para los comandos de tipo RESET_PASSWORD, especifica marcas de manera opcional.

object (ClearAppsDataParams)

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

object (StartLostModeParams)

Parámetros para el comando START_LOST_MODE para poner el dispositivo en modo perdido. Consulta los StartLostModeParams. Si se establece, se sugiere que no se establezca type. En este caso, el servidor lo establece automáticamente en START_LOST_MODE. También se acepta establecer type en START_LOST_MODE de forma explícita.

object (StopLostModeParams)

Parámetros del comando STOP_LOST_MODE para sacar el dispositivo del modo extraviado. Consulta los StopLostModeParams. Si se establece, se sugiere que no se establezca type. En este caso, el servidor lo establece automáticamente en STOP_LOST_MODE. También se acepta establecer type en STOP_LOST_MODE de forma explícita.

object (ClearAppsDataStatus)

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

object (StartLostModeStatus)

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

object (StopLostModeStatus)

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

{
  "packageNames": [
    string
  ]
}

string

Los nombres de los 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 al que se llamará cuando el dispositivo esté en modo perdido y se presione el botón para llamar al propietario.

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 perdido.

{
  "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.