- Żą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
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 |
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 OAuth 2.0.
Polecenie
polecenie,
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Typ polecenia. |
create |
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: |
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ś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ę „ |
user |
Nazwa zasobu użytkownika, który jest właścicielem urządzenia, w formacie |
error |
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ę. |
new |
W przypadku poleceń typu |
reset |
W przypadku poleceń typu |
Pole unii Jeśli to pole jest skonfigurowane, pola |
|
clear |
Parametry polecenia |
start |
Parametry polecenia |
stop |
Parametry polecenia |
Pole unii status . Stan powiązany z poleceniem. Pamiętaj, że niektóre polecenia nie korzystają z tego, w szczególności , , i . W przyszłości te polecenia też mogą używać tego ustawienia. status może mieć tylko jedną z tych wartości: |
|
clear |
Tylko dane wyjściowe. Stan polecenia |
start |
Tylko dane wyjściowe. Stan polecenia |
stop |
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ął 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ż . |
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ż . |
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ż . |
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
służące do wyczyszczenia danych określonych aplikacji z urządzenia.CLEAR_APP_DATA
Zapis JSON |
---|
{ "packageNames": [ string ] } |
Pola | |
---|---|
package |
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 jeden z parametrów niezawierających nazwy organizacji.START_LOST_MODE
Zapis JSON |
---|
{ "lostMessage": { object ( |
Pola | |
---|---|
lost |
Komunikat wyświetlany użytkownikowi, gdy urządzenie jest w trybie utraconego urządzenia. |
lost |
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. |
lost |
Adres e-mail wyświetlany użytkownikowi, gdy urządzenie jest w trybie utraconego urządzenia. |
lost |
Ulica i numer domu wyświetlane użytkownikowi, gdy urządzenie działa w trybie utraconego urządzenia. |
lost |
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 usuwania danych określonych aplikacji z urządzenia.CLEAR_APP_DATA
Zapis JSON |
---|
{
"results": {
string: {
object ( |
Pola | |
---|---|
results |
Wyniki dla poszczególnych aplikacji, czyli mapowanie nazw pakietów na odpowiednie wyniki weryfikacji. Obiekt zawierający listę par |
PerAppResult
Wynik próby wyczyszczenia danych z pojedynczej aplikacji.
Zapis JSON |
---|
{
"clearingResult": enum ( |
Pola | |
---|---|
clearing |
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
, które przełącza urządzenie 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 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
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 wyjęte z trybu utraconego urządzenia. |
NOT_IN_LOST_MODE |
Urządzenie nie jest w trybie utraconego urządzenia. |