- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Команда
- ТипКоманды
- Коммандерроркоде
- СброспароляФлаг
- ClearAppsDataParams
- СтартЛостРежимПарамс
- СтопЛостРежимПарамс
- ClearAppsDataStatus
- PerAppResult
- ОчисткаРезультат
- Стартлостмодестатус
- Статус
- СтопLostModeStatus
- Статус
- Попробуйте!
Выдает команду устройству. Возвращенный ресурс Operation
содержит Command
в поле metadata
. Используйте метод операции get , чтобы получить статус команды.
HTTP-запрос
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
name | Имя устройства в формате |
Тело запроса
Тело запроса содержит экземпляр Command
.
Тело ответа
В случае успеха тело ответа содержит экземпляр Operation
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/androidmanagement
Дополнительную информацию см. в обзоре OAuth 2.0 .
Команда
Команда.
JSON-представление |
---|
{ "type": enum ( |
Поля | |
---|---|
type | Тип команды. |
createTime | Временная метка создания команды. Временная метка автоматически генерируется сервером. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
duration | Продолжительность действия команды. Срок действия команды истечет, если она не будет выполнена устройством в течение этого времени. Продолжительность по умолчанию, если она не указана, составляет десять минут. Максимальной продолжительности не существует. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
userName | Имя ресурса пользователя, которому принадлежит устройство, в форме |
errorCode | Если команда не выполнена, отображается код ошибки, объясняющий сбой. Не устанавливается, когда команда отменяется вызывающим абонентом. |
newPassword | Для команд типа |
resetPasswordFlags[] | Для команд типа |
Если он установлен, то поля | |
clearAppsDataParams | Параметры для команды |
startLostModeParams | Параметры для команды |
stopLostModeParams | Параметры для команды |
status поля объединения. Статус, специфичный для команды. Обратите внимание, что некоторые команды не используют это, в частности , , и . В будущем эти команды также могут использовать это. status может быть только одним из следующих: | |
clearAppsDataStatus | Только вывод. Статус команды |
startLostModeStatus | Только вывод. Статус команды |
stopLostModeStatus | Только вывод. Статус команды |
ТипКоманды
Типы команд.
Перечисления | |
---|---|
COMMAND_TYPE_UNSPECIFIED | Это значение запрещено. |
LOCK | Заблокируйте устройство, как если бы время ожидания блокировки экрана истекло. |
RESET_PASSWORD | Сбросьте пароль пользователя. |
REBOOT | Перезагрузите устройство. Поддерживается только на полностью управляемых устройствах под управлением Android 7.0 (уровень API 24) или выше. |
RELINQUISH_OWNERSHIP | Удаляет рабочий профиль и все политики с корпоративного устройства Android 8.0+, предоставляя устройство для личного использования. Приложения и данные, связанные с личными профилями, сохраняются. Устройство будет удалено с сервера после подтверждения команды. |
CLEAR_APP_DATA | Очищает данные приложений указанных приложений. Это поддерживается на Android 9 и выше. Обратите внимание, что приложение может хранить данные за пределами данных своего приложения, например, во внешнем хранилище или в пользовательском словаре. См. также . |
START_LOST_MODE | Переводит устройство в режим пропажи. Поддерживается только на полностью управляемых устройствах или устройствах, принадлежащих организации, с управляемым профилем. См. также . |
STOP_LOST_MODE | Выводит устройство из режима пропажи. Поддерживается только на полностью управляемых устройствах или устройствах, принадлежащих организации, с управляемым профилем. См. также . |
Коммандерроркоде
Код ошибки команды. Это поле, доступное только для чтения, заполняемое сервером.
Перечисления | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED | Ошибки не было. |
UNKNOWN | Произошла неизвестная ошибка. |
API_LEVEL | Уровень API устройства не поддерживает эту команду. |
MANAGEMENT_MODE | Режим управления (владелец профиля, владелец устройства и т. д.) не поддерживает команду. |
INVALID_VALUE | Команда имеет недопустимое значение параметра. |
UNSUPPORTED | Устройство не поддерживает команду. Обновление Политики устройств Android до последней версии может решить проблему. |
СброспароляФлаг
Флаги, которые можно использовать для типа команды RESET_PASSWORD
.
Перечисления | |
---|---|
RESET_PASSWORD_FLAG_UNSPECIFIED | Это значение игнорируется. |
REQUIRE_ENTRY | Не позволяйте другим администраторам снова менять пароль, пока пользователь не введет его. |
DO_NOT_ASK_CREDENTIALS_ON_BOOT | Не запрашивайте учетные данные пользователя при загрузке устройства. |
LOCK_NOW | Заблокируйте устройство после сброса пароля. |
ClearAppsDataParams
Параметры, связанные с командой
для очистки данных указанных приложений с устройства. CLEAR_APP_DATA
JSON-представление |
---|
{ "packageNames": [ string ] } |
Поля | |
---|---|
packageNames[] | Имена пакетов приложений, данные которых будут удалены при выполнении команды. |
СтартЛостРежимПарамс
Параметры, связанные с командой
для перевода устройства в режим потери. Для перевода устройства в режим пропажи необходимо указать хотя бы один из параметров, не включая название организации. START_LOST_MODE
JSON-представление |
---|
{ "lostMessage": { object ( |
Поля | |
---|---|
lostMessage | Сообщение, отображаемое пользователю, когда устройство находится в режиме потери. |
lostPhoneNumber | Номер телефона, на который будет звонить, когда устройство находится в режиме потери и нажата кнопка владельца вызова. |
lostEmailAddress | Адрес электронной почты, отображаемый пользователю, когда устройство находится в режиме потери. |
lostStreetAddress | Адрес, отображаемый пользователю, когда устройство находится в режиме потери. |
lostOrganization | Название организации, отображаемое пользователю, когда устройство находится в режиме потери. |
СтопЛостРежимПарамс
Этот тип не имеет полей.
Параметры, связанные с командой
для вывода устройства из режима потери. STOP_LOST_MODE
ClearAppsDataStatus
Статус команды
для очистки данных указанных приложений с устройства. CLEAR_APP_DATA
JSON-представление |
---|
{
"results": {
string: {
object ( |
Поля | |
---|---|
results | Результаты для каждого приложения — сопоставление имен пакетов с соответствующим результатом очистки. Объект, содержащий список пар |
PerAppResult
Результат попытки очистки данных одного приложения.
JSON-представление |
---|
{
"clearingResult": enum ( |
Поля | |
---|---|
clearingResult | Результат попытки очистки данных одного приложения. |
ОчисткаРезультат
Результат попытки очистки данных одного приложения.
Перечисления | |
---|---|
CLEARING_RESULT_UNSPECIFIED | Неопределенный результат. |
SUCCESS | Данные этого приложения были успешно удалены. |
APP_NOT_FOUND | Данные этого приложения не удалось очистить, поскольку приложение не найдено. |
APP_PROTECTED | Данные этого приложения не могут быть удалены, поскольку приложение защищено. Например, это может относиться к приложениям, критически важным для работы устройства, таким как Google Play Store. |
API_LEVEL | Данные этого приложения не удалось очистить, поскольку уровень API устройства не поддерживает эту команду. |
Стартлостмодестатус
Статус команды
для перевода устройства в режим потери. START_LOST_MODE
JSON-представление |
---|
{
"status": enum ( |
Поля | |
---|---|
status | Статус. См. |
Статус
Статус. См.
. StartLostModeStatus
Перечисления | |
---|---|
STATUS_UNSPECIFIED | Не указано. Это значение не используется. |
SUCCESS | Устройство было переведено в режим потери. |
RESET_PASSWORD_RECENTLY | Устройство не удалось перевести в режим потери, так как администратор недавно сбросил пароль устройства. |
USER_EXIT_LOST_MODE_RECENTLY | Устройство не удалось перевести в режим пропажи, поскольку пользователь недавно вышел из режима пропажи. |
ALREADY_IN_LOST_MODE | Устройство уже находится в режиме пропажи. |
СтопLostModeStatus
Статус команды
для вывода устройства из режима потери. STOP_LOST_MODE
JSON-представление |
---|
{
"status": enum ( |
Поля | |
---|---|
status | Статус. См. |
Статус
Статус. См.
. StopLostModeStatus
Перечисления | |
---|---|
STATUS_UNSPECIFIED | Не указано. Это значение не используется. |
SUCCESS | Устройство выведено из режима пропажи. |
NOT_IN_LOST_MODE | Устройство не находится в режиме потери. |