Method: enterprises.devices.issueCommand

Wydaje polecenie urządzeniu. Zwrócony zasób Operation zawiera w polu metadata wartość Command. Aby uzyskać stan polecenia, użyj metody operacji pobierania.

Żądanie HTTP

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Nazwa urządzenia w formacie enterprises/{enterpriseId}/devices/{deviceId}.

Treść żądania

Treść żądania zawiera wystąpienie elementu Command.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/androidmanagement

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.

Polecenie

polecenie,

Zapis JSON
{
  "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.
}
Pola
type

enum (CommandType)

Typ polecenia.

createTime

string (Timestamp format)

Sygnatura czasowa utworzenia polecenia. Znak czasu jest generowany automatycznie przez serwer.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Czas, przez jaki polecenie jest ważne. Polecenie wygaśnie, jeśli nie zostanie wykonane w tym czasie przez urządzenie. Jeśli nie określisz inaczej, domyślny czas to 10 minut. Nie ma maksymalnego czasu trwania.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

userName

string

Nazwa zasobu użytkownika, który jest właścicielem urządzenia, w formacie enterprises/{enterpriseId}/users/{userId}. Jest on generowany automatycznie przez serwer na podstawie urządzenia, na które wysyłane jest polecenie.

errorCode

enum (CommandErrorCode)

Jeśli polecenie nie zadziała, kod błędu wyjaśniający błąd. Nie jest ona ustawiana, gdy polecenie zostanie anulowane przez rozmówcę.

newPassword

string

W przypadku poleceń typu RESET_PASSWORD opcjonalnie określa nowe hasło. Uwaga: w przypadku urządzeń z Androidem 14 nowe hasło musi składać się z co najmniej 6 znaków, jeśli jest liczbowe. W przeciwnym razie polecenie zakończy się niepowodzeniem i wyświetleniem komunikatu INVALID_VALUE.

resetPasswordFlags[]

enum (ResetPasswordFlag)

W przypadku poleceń typu RESET_PASSWORD opcjonalnie określa flagi.

Pole unii params. Parametry specyficzne dla danego polecenia. Pamiętaj, że w niektórych poleceniach, na przykład LOCK, RESET_PASSWORD, REBOOT i RELINQUISH_OWNERSHIP, ta funkcja nie jest używana. W przyszłości te polecenia też mogą używać tej funkcji.

Jeśli to pole jest skonfigurowane, pola new_passwordreset_password_flags nie mogą być skonfigurowane. params może mieć tylko jedną z tych wartości:

clearAppsDataParams

object (ClearAppsDataParams)

Parametry polecenia CLEAR_APP_DATA służące do wyczyszczenia danych określonych aplikacji z urządzenia. Zobacz ClearAppsDataParams. Jeśli jest skonfigurowana, sugeruje, że type nie powinna być skonfigurowana. W tym przypadku serwer automatycznie ustawia wartość CLEAR_APP_DATA. Dopuszczalne jest też jawne ustawienie wartości type na CLEAR_APP_DATA.

startLostModeParams

object (StartLostModeParams)

Parametry polecenia START_LOST_MODE, które umożliwia włączenie trybu utraconego urządzenia. Zobacz StartLostModeParams. Jeśli ta wartość jest ustawiona, zalecamy nie ustawiać wartości type. W tym przypadku serwer automatycznie ustawia wartość START_LOST_MODE. Dopuszczalne jest też bezpośrednie ustawienie atrybutu type jako START_LOST_MODE.

stopLostModeParams

object (StopLostModeParams)

Parametry polecenia STOP_LOST_MODE, które włączają urządzenie z trybu utraconego urządzenia. Zobacz StopLostModeParams. Jeśli ta opcja jest ustawiona, sugeruje się, że type nie powinno być skonfigurowane. W tym przypadku serwer automatycznie ustawia wartość STOP_LOST_MODE. Dopuszczalne jest też jawne ustawienie wartości type na STOP_LOST_MODE.

Pole unii status. Stan powiązany z poleceniem. Pamiętaj, że niektóre polecenia nie korzystają z tego, w szczególności LOCK, RESET_PASSWORD, REBOOTRELINQUISH_OWNERSHIP. W przyszłości te polecenia też mogą używać tego ustawienia. status może mieć tylko jedną z tych wartości:
clearAppsDataStatus

object (ClearAppsDataStatus)

Tylko dane wyjściowe. Stan polecenia CLEAR_APP_DATA służącego do usuwania danych określonych aplikacji z urządzenia. Zobacz ClearAppsDataStatus.

startLostModeStatus

object (StartLostModeStatus)

Tylko dane wyjściowe. Stan polecenia START_LOST_MODE, które powoduje przełączenie urządzenia w tryb utraconego urządzenia. Zobacz StartLostModeStatus.

stopLostModeStatus

object (StopLostModeStatus)

Tylko dane wyjściowe. Stan polecenia STOP_LOST_MODE wskazującego na wyjście z trybu utraconego urządzenia. Zobacz StopLostModeStatus.

CommandType

Typy poleceń.

Wartości w polu enum
COMMAND_TYPE_UNSPECIFIED Ta wartość jest niedozwolona.
LOCK Zablokuj urządzenie, tak jakby upłynął czas oczekiwania na ekranie blokady.
RESET_PASSWORD zresetować hasło użytkownika,
REBOOT Uruchom ponownie urządzenie. Ta funkcja jest obsługiwana tylko na w pełni zarządzanych urządzeniach z Androidem 7.0 (poziom interfejsu API 24) lub nowszym.
RELINQUISH_OWNERSHIP Usuwa profil służbowy i wszystkie zasady z urządzenia z Androidem 8.0 lub nowszym należącego do firmy, co pozwala na korzystanie z urządzenia do celów osobistych. Aplikacje i dane powiązane z profilami osobistymi są zachowywane. Po potwierdzeniu polecenia urządzenie zostanie usunięte z serwera.
CLEAR_APP_DATA Czyści dane aplikacji w określonych aplikacjach. Ta funkcja jest obsługiwana w Androidzie 9 i nowszych. Pamiętaj, że aplikacja może przechowywać dane poza swoimi danymi, np. w pamięci zewnętrznej lub w słowniku użytkownika. Zobacz też clearAppsDataParams.
START_LOST_MODE Włącza tryb utraconego urządzenia. Obsługiwane tylko na w pełni zarządzanych urządzeniach lub urządzeniach należących do organizacji z profilem zarządzanym. Zobacz też startLostModeParams.
STOP_LOST_MODE Powoduje wyjście z trybu utraconego urządzenia. Obsługiwane tylko na w pełni zarządzanych urządzeniach lub urządzeniach należących do organizacji z profilem zarządzanym. Zobacz też stopLostModeParams.

CommandErrorCode

Kod błędu polecenia. To pole jest tylko do odczytu i jest wypełniane przez serwer.

Wartości w polu enum
COMMAND_ERROR_CODE_UNSPECIFIED Nie wystąpił żaden błąd.
UNKNOWN Wystąpił nieznany błąd.
API_LEVEL Poziom interfejsu API urządzenia nie obsługuje tego polecenia.
MANAGEMENT_MODE Tryb zarządzania (właściciel profilu, właściciel urządzenia itp.) nie obsługuje tego polecenia.
INVALID_VALUE Polecenie ma nieprawidłową wartość parametru.
UNSUPPORTED Urządzenie nie obsługuje tego polecenia. Problem może rozwiązać zaktualizowanie Zasad dotyczących urządzeń z Androidem do najnowszej wersji.

ResetPasswordFlag

Flagi, których można używać w przypadku typu polecenia RESET_PASSWORD.

Wartości w polu enum
RESET_PASSWORD_FLAG_UNSPECIFIED Ta wartość jest ignorowana.
REQUIRE_ENTRY Nie zezwalaj innym administratorom na zmianę hasła, dopóki użytkownik go nie wpisze.
DO_NOT_ASK_CREDENTIALS_ON_BOOT Nie proś o dane logowania użytkownika podczas uruchamiania urządzenia.
LOCK_NOW Po zresetowaniu hasła zablokuj urządzenie.

ClearAppsDataParams

Parametry powiązane z poleceniem CLEAR_APP_DATA służące do wyczyszczenia danych określonych aplikacji z urządzenia.

Zapis JSON
{
  "packageNames": [
    string
  ]
}
Pola
packageNames[]

string

Nazwy pakietów aplikacji, których dane zostaną wyczyszczone po wykonaniu polecenia.

StartLostModeParams

Parametry powiązane z poleceniem START_LOST_MODE, które włącza tryb utraconego urządzenia. Aby urządzenie znalazło się w trybie utraconego urządzenia, należy podać co najmniej jeden z parametrów niezawierających nazwy organizacji.

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

object (UserFacingMessage)

Komunikat wyświetlany użytkownikowi, gdy urządzenie jest w trybie utraconego urządzenia.

lostPhoneNumber

object (UserFacingMessage)

Numer telefonu, z którym zostanie nawiązane połączenie, gdy urządzenie jest w trybie utraconego urządzenia i klikniesz przycisk Połącz z właścicielem.

lostEmailAddress

string

Adres e-mail wyświetlany użytkownikowi, gdy urządzenie jest w trybie utraconego urządzenia.

lostStreetAddress

object (UserFacingMessage)

Ulica i numer domu wyświetlane użytkownikowi, gdy urządzenie działa w trybie utraconego urządzenia.

lostOrganization

object (UserFacingMessage)

Nazwa organizacji wyświetlana użytkownikowi, gdy urządzenie jest w trybie utraconego urządzenia.

StopLostModeParams

Ten typ nie zawiera pól.

Parametry powiązane z poleceniem STOP_LOST_MODE, które włącza tryb utraconego urządzenia.

ClearAppsDataStatus

Stan polecenia CLEAR_APP_DATA służącego do usuwania danych określonych aplikacji z urządzenia.

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

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

Wyniki dla poszczególnych aplikacji, czyli mapowanie nazw pakietów na odpowiednie wyniki weryfikacji.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

PerAppResult

Wynik próby wyczyszczenia danych z pojedynczej aplikacji.

Zapis JSON
{
  "clearingResult": enum (ClearingResult)
}
Pola
clearingResult

enum (ClearingResult)

Wynik próby wyczyszczenia danych jednej aplikacji.

ClearingResult

Wynik próby wyczyszczenia danych jednej aplikacji.

Wartości w polu enum
CLEARING_RESULT_UNSPECIFIED Nieokreślony wynik.
SUCCESS Dane tej aplikacji zostały usunięte.
APP_NOT_FOUND Nie udało się wyczyścić danych tej aplikacji, ponieważ jej nie znaleziono.
APP_PROTECTED Nie udało się wyczyścić danych tej aplikacji, ponieważ aplikacja jest chroniona. Może to dotyczyć na przykład aplikacji, które są niezbędne do działania urządzenia, takich jak Sklep Google Play.
API_LEVEL Nie udało się wyczyścić danych tej aplikacji, ponieważ poziom interfejsu API urządzenia nie obsługuje tego polecenia.

StartLostModeStatus

Stan polecenia START_LOST_MODE, które przełącza urządzenie w tryb utraconego urządzenia.

Zapis JSON
{
  "status": enum (Status)
}
Pola
status

enum (Status)

Stan. Zobacz StartLostModeStatus.

Stan

Stan. Zobacz StartLostModeStatus.

Wartości w polu enum
STATUS_UNSPECIFIED Nie określono. Ta wartość nie jest używana.
SUCCESS Urządzenie zostało ustawione w trybie utraconego urządzenia.
RESET_PASSWORD_RECENTLY Nie udało się przełączyć urządzenia w tryb utraconego urządzenia, ponieważ administrator niedawno zresetował do niego hasło.
USER_EXIT_LOST_MODE_RECENTLY Nie udało się przełączyć urządzenia w tryb utraconego urządzenia, ponieważ użytkownik niedawno opuścił go.
ALREADY_IN_LOST_MODE Urządzenie jest już w trybie utraconego urządzenia.

StopLostModeStatus

Stan polecenia STOP_LOST_MODE wskazującego na wyjście z trybu utraconego urządzenia.

Zapis JSON
{
  "status": enum (Status)
}
Pola
status

enum (Status)

Stan. Zobacz StopLostModeStatus.

Stan

Stan. Zobacz StopLostModeStatus.

Wartości w polu enum
STATUS_UNSPECIFIED Nie określono. Ta wartość nie jest używana.
SUCCESS Urządzenie zostało wyjęte z trybu utraconego urządzenia.
NOT_IN_LOST_MODE Urządzenie nie jest w trybie utraconego urządzenia.