Method: enterprises.devices.issueCommand

string

O nome do dispositivo no 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)

O tipo do comando.

string (Timestamp format)

O carimbo de data/hora em que o comando foi criado. O carimbo de data/hora é gerado automaticamente pelo servidor.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Duration format)

O tempo em que o comando é válido. O comando vai expirar se não for executado pelo dispositivo durante esse período. A duração padrão, se não for especificada, é de 10 minutos. Não há duração máxima.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

string

O nome do recurso do usuário proprietário do dispositivo no formato enterprises/{enterpriseId}/users/{userId}. Ele é gerado automaticamente pelo servidor com base no dispositivo para o qual o comando é enviado.

enum (CommandErrorCode)

Se o comando falhar, um código de erro explicando a falha. Isso não é definido quando o comando é cancelado pelo autor da chamada.

string

Para comandos do tipo RESET_PASSWORD, especifica opcionalmente a nova senha. Observação: a nova senha precisa ter pelo menos seis caracteres se for numérica no caso de dispositivos com o Android 14. Caso contrário, o comando vai falhar com INVALID_VALUE.

enum (ResetPasswordFlag)

Para comandos do tipo RESET_PASSWORD, especifica flags opcionalmente.

object (ClearAppsDataParams)

Parâmetros para o comando CLEAR_APP_DATA para limpar os dados de apps especificados do dispositivo. Consulte os ClearAppsDataParams. Se esse valor estiver definido, sugerimos que type não seja definido. Nesse caso, o servidor a define automaticamente como CLEAR_APP_DATA. Também é aceitável definir type como CLEAR_APP_DATA.

object (StartLostModeParams)

Parâmetros para o comando START_LOST_MODE para colocar o dispositivo no modo perdido. Consulte os StartLostModeParams. Se esse valor estiver definido, sugerimos que type não seja definido. Nesse caso, o servidor a define automaticamente como START_LOST_MODE. Também é aceitável definir type como START_LOST_MODE.

object (StopLostModeParams)

Parâmetros para o comando STOP_LOST_MODE para tirar o dispositivo do modo perdido. Consulte os StopLostModeParams. Se esse valor estiver definido, sugerimos que type não seja definido. Nesse caso, o servidor a define automaticamente como STOP_LOST_MODE. Também é aceitável definir type como STOP_LOST_MODE.

object (ClearAppsDataStatus)

Apenas saída. Status do comando CLEAR_APP_DATA para limpar os dados de apps especificados do dispositivo. Consulte os ClearAppsDataStatus.

object (StartLostModeStatus)

Apenas saída. Status do comando START_LOST_MODE para colocar o dispositivo no modo perdido. Consulte os StartLostModeStatus.

object (StopLostModeStatus)

Apenas saída. Status do comando STOP_LOST_MODE para tirar o dispositivo do modo perdido. Consulte os StopLostModeStatus.

{
  "packageNames": [
    string
  ]
}

string

Os nomes dos pacotes dos apps cujos dados serão apagados quando o comando for executado.

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

object (UserFacingMessage)

A mensagem exibida ao usuário quando o dispositivo está no modo perdido.

object (UserFacingMessage)

O número de telefone que será chamado quando o dispositivo estiver no modo perdido e o botão de chamada para o proprietário for tocado.

string

O endereço de e-mail exibido para o usuário quando o dispositivo está no modo perdido.

object (UserFacingMessage)

O endereço exibido ao usuário quando o dispositivo está no modo perdido.

object (UserFacingMessage)

O nome da organização exibido para o usuário quando o dispositivo está no modo perdido.

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

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

Os resultados por app, um mapeamento dos nomes dos pacotes para o respectivo resultado de limpeza.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

O resultado de uma tentativa de limpar os dados de um único app.

{
  "status": enum (Status)
}

enum (Status)

O status. Consulte StartLostModeStatus.

{
  "status": enum (Status)
}

enum (Status)

O status. Consulte StopLostModeStatus.