- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Polecenie
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- Status
- StopLostModeStatus
- Status
- Wypróbuj
Wydaje polecenie urządzeniu. Zwrócony zasób Operation
zawiera w polu metadata
Command
. Aby sprawdzić stan polecenia, użyj metody get Operations.
Żą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 |
Nazwa urządzenia w formacie |
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 protokołu OAuth 2.0.
Polecenie
Polecenie.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Typ polecenia. |
createTime |
Sygnatura czasowa określająca, kiedy polecenie zostało utworzone. Sygnatura czasowa jest automatycznie generowana przez serwer. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
duration |
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ślono 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, kończący się cyfrą „ |
userName |
Nazwa zasobu użytkownika, do którego należy urządzenie, w formacie |
errorCode |
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 |
W przypadku poleceń typu |
resetPasswordFlags[] |
W przypadku poleceń typu |
Pole sumy Jeśli ta wartość jest ustawiona, pola |
|
clearAppsDataParams |
Parametry polecenia |
startLostModeParams |
Parametry polecenia |
stopLostModeParams |
Parametry polecenia |
Pole sumy status . Stan powiązany z poleceniem. Pamiętaj, że w niektórych poleceniach, na przykład , , i , ta funkcja nie jest używana. W przyszłości te polecenia też mogą używać tego ustawienia. status może mieć tylko jedną z tych wartości: |
|
clearAppsDataStatus |
Tylko dane wyjściowe. Stan polecenia |
startLostModeStatus |
Tylko dane wyjściowe. Stan polecenia |
stopLostModeStatus |
Tylko dane wyjściowe. Stan polecenia |
CommandType
Typy poleceń.
Wartości w polu enum | |
---|---|
COMMAND_TYPE_UNSPECIFIED |
Ta wartość jest niedozwolona. |
LOCK |
Zablokuj urządzenie, tak jakby upłynął limit czasu blokady ekranu. |
RESET_PASSWORD |
zresetować hasło użytkownika, |
REBOOT |
Zrestartuj 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 |
spowoduje usunięcie profilu służbowego i wszystkich zasad z należącego do firmy urządzenia z Androidem 8.0 lub nowszym, a urządzenie zostanie wówczas przekazane do użytku osobistego; Aplikacje i dane powiązane z profilami osobistymi są zachowywane. Po potwierdzeniu polecenia urządzenie zostanie usunięte z serwera. |
CLEAR_APP_DATA |
Usuwa dane określonych aplikacji. Ta funkcja jest obsługiwana w Androidzie 9 i nowszych. Pamiętaj, że aplikacja może przechowywać dane poza swoimi danymi, na przykład w pamięci zewnętrznej czy w słowniku użytkownika. Zobacz też . |
START_LOST_MODE |
Przełącza urządzenie w tryb utraconego urządzenia. Ta funkcja jest obsługiwana tylko na w pełni zarządzanych urządzeniach i urządzeniach należących do organizacji z profilem zarządzanym. Zobacz też . |
STOP_LOST_MODE |
Powoduje wyjście z trybu utraconego urządzenia. Ta funkcja jest obsługiwana tylko na w pełni zarządzanych urządzeniach i urządzeniach należących do organizacji z profilem zarządzanym. Zobacz też . |
CommandErrorCode
Kod błędu polecenia. To pole tylko do odczytu wypełniane przez serwer.
Wartości w polu enum | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED |
Brak błędów. |
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 zawiera nieprawidłową wartość parametru. |
UNSUPPORTED |
Urządzenie nie obsługuje tego polecenia. Problem może rozwiązać zaktualizowanie Android Device Policy do najnowszej wersji. |
ResetPasswordFlag
Flagi, które mogą być używane w przypadku poleceń typu RESET_PASSWORD
.
Wartości w polu enum | |
---|---|
RESET_PASSWORD_FLAG_UNSPECIFIED |
Jest ona 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 pytaj o dane logowania użytkownika podczas uruchamiania urządzenia. |
LOCK_NOW |
Po zresetowaniu hasła zablokuj urządzenie. |
ClearAppsDataParams
Parametry powiązane z poleceniem
służące do usuwania z urządzenia danych określonych aplikacji.CLEAR_APP_DATA
Zapis JSON |
---|
{ "packageNames": [ string ] } |
Pola | |
---|---|
packageNames[] |
Nazwy pakietów aplikacji, których dane zostaną wyczyszczone po wykonaniu polecenia. |
StartLostModeParams
Parametry powiązane z poleceniem
, które włącza tryb utraconego urządzenia. Aby urządzenie znalazło się w trybie utraconego urządzenia, należy podać co najmniej 1 z parametrów (bez nazwy organizacji).START_LOST_MODE
Zapis JSON |
---|
{ "lostMessage": { object ( |
Pola | |
---|---|
lostMessage |
Komunikat wyświetlany użytkownikowi, gdy urządzenie jest w trybie utraconego urządzenia. |
lostPhoneNumber |
Numer telefonu, z którym zostanie nawiązane połączenie, gdy urządzenie znajdzie się w trybie utraconego urządzenia i naciśniesz przycisk „Zadzwoń do właściciela”. |
lostEmailAddress |
Adres e-mail wyświetlany użytkownikowi, gdy urządzenie jest w trybie utraconego urządzenia. |
lostStreetAddress |
Ulica i numer domu wyświetlane użytkownikowi, gdy urządzenie działa w trybie utraconego urządzenia. |
lostOrganization |
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
, które włącza tryb utraconego urządzenia.STOP_LOST_MODE
ClearAppsDataStatus
Stan polecenia
służącego do usunięcia z urządzenia danych określonych aplikacji.CLEAR_APP_DATA
Zapis JSON |
---|
{
"results": {
string: {
object ( |
Pola | |
---|---|
results |
Wyniki dla poszczególnych aplikacji, czyli mapowanie nazw pakietów na odpowiednie wyniki czyszczenia. Obiekt zawierający listę par |
PerAppResult
Wynik próby wyczyszczenia danych jednej aplikacji.
Zapis JSON |
---|
{
"clearingResult": enum ( |
Pola | |
---|---|
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 wyczyszczone. |
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
, które powoduje przełączenie urządzenia w tryb utraconego urządzenia.START_LOST_MODE
Zapis JSON |
---|
{
"status": enum ( |
Pola | |
---|---|
status |
Stan. Zobacz |
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 przełączone w tryb 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
wskazującego na wyjście z trybu utraconego urządzenia.STOP_LOST_MODE
Zapis JSON |
---|
{
"status": enum ( |
Pola | |
---|---|
status |
Stan. Zobacz |
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 wyłączone z trybu utraconego urządzenia. |
NOT_IN_LOST_MODE |
Urządzenie nie jest w trybie utraconego urządzenia. |