Method: enterprises.devices.issueCommand

string

Имя устройства в формате 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 )

Тип команды.

string ( Timestamp format)

Временная метка создания команды. Временная метка автоматически генерируется сервером.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Duration format)

Продолжительность действия команды. Срок действия команды истечет, если она не будет выполнена устройством в течение этого времени. Продолжительность по умолчанию, если она не указана, составляет десять минут. Максимальной продолжительности не существует.

Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

string

Имя ресурса пользователя, которому принадлежит устройство, в форме enterprises/{enterpriseId}/users/{userId} . Он автоматически генерируется сервером в зависимости от устройства, на которое отправляется команда.

enum ( CommandErrorCode )

Если команда не выполнена, отображается код ошибки, объясняющий сбой. Не устанавливается, когда команда отменяется вызывающим абонентом.

string

Для команд типа RESET_PASSWORD дополнительно указывает новый пароль. Примечание. Новый пароль должен содержать не менее 6 символов, если он цифровой, в случае устройств Android 14. В противном случае команда завершится с ошибкой INVALID_VALUE .

enum ( ResetPasswordFlag )

Для команд типа RESET_PASSWORD дополнительно задаются флаги.

object ( ClearAppsDataParams )

Параметры для команды CLEAR_APP_DATA для очистки данных указанных приложений с устройства. См. ClearAppsDataParams . Если этот параметр установлен, то рекомендуется не задавать type . В этом случае сервер автоматически устанавливает значение CLEAR_APP_DATA . Также допустимо явно указать type CLEAR_APP_DATA .

object ( StartLostModeParams )

Параметры для команды START_LOST_MODE для перевода устройства в режим потери. См. StartLostModeParams . Если этот параметр установлен, то рекомендуется не задавать type . В этом случае сервер автоматически устанавливает для него значение START_LOST_MODE . Также допустимо явно указать type START_LOST_MODE .

object ( StopLostModeParams )

Параметры для команды STOP_LOST_MODE для вывода устройства из режима потери. См. StopLostModeParams . Если этот параметр установлен, то рекомендуется не задавать type . В этом случае сервер автоматически устанавливает для него значение STOP_LOST_MODE . Также допустимо явно указать type STOP_LOST_MODE .

object ( ClearAppsDataStatus )

Только вывод. Статус команды CLEAR_APP_DATA для очистки данных указанных приложений с устройства. См. ClearAppsDataStatus .

object ( StartLostModeStatus )

Только вывод. Статус команды START_LOST_MODE для перевода устройства в режим потери. См. StartLostModeStatus .

object ( StopLostModeStatus )

Только вывод. Статус команды STOP_LOST_MODE для вывода устройства из режима потери. См. StopLostModeStatus .

{
  "packageNames": [
    string
  ]
}

string

Имена пакетов приложений, данные которых будут удалены при выполнении команды.

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

object ( UserFacingMessage )

Сообщение, отображаемое пользователю, когда устройство находится в режиме потери.

object ( UserFacingMessage )

Номер телефона, на который будет звонить, когда устройство находится в режиме потери и нажата кнопка владельца вызова.

string

Адрес электронной почты, отображаемый пользователю, когда устройство находится в режиме потери.

object ( UserFacingMessage )

Адрес, отображаемый пользователю, когда устройство находится в режиме потери.

object ( UserFacingMessage )

Название организации, отображаемое пользователю, когда устройство находится в режиме потери.

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

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

Результаты для каждого приложения — сопоставление имен пакетов с соответствующим результатом очистки.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

{
  "clearingResult": enum (ClearingResult)
}

enum ( ClearingResult )

Результат попытки очистки данных одного приложения.

{
  "status": enum (Status)
}

enum ( Status )

Статус. См. StartLostModeStatus .

{
  "status": enum (Status)
}

enum ( Status )

Статус. См. StopLostModeStatus .