Method: enterprises.devices.issueCommand

Wydaje polecenie do urządzenia. Zwrócony zasób Operation zawiera w polu metadata wartość Command. Aby sprawdzić stan polecenia, użyj metody get operation.

Żą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 sekcji OAuth 2.0 Overview.

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)
  },
  "addEsimParams": {
    object (AddEsimParams)
  },
  "removeEsimParams": {
    object (RemoveEsimParams)
  },
  "requestDeviceInfoParams": {
    object (RequestDeviceInfoParams)
  },
  "wipeParams": {
    object (WipeParams)
  }
  // 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)
  },
  "esimStatus": {
    object (EsimCommandStatus)
  },
  "requestDeviceInfoStatus": {
    object (RequestDeviceInfoStatus)
  }
  // End of list of possible types for union field status.
}
Pola
type

enum (CommandType)

Typ polecenia.
createTime

string (Timestamp format)

Sygnatura czasowa utworzenia polecenia. Sygnatura czasowa jest generowana automatycznie przez serwer.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
duration

string (Duration format)

Okres ważności polecenia. Jeśli w tym czasie urządzenie nie wykona polecenia, wygaśnie ono. Jeśli nie określisz czasu trwania, domyślnie będzie on wynosić 10 minut. Nie ma maksymalnego czasu trwania.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
userName

string

Nazwa zasobu użytkownika, do którego należy urządzenie, w formacie enterprises/{enterpriseId}/users/{userId}. Jest on generowany automatycznie przez serwer na podstawie urządzenia, do którego wysyłane jest polecenie.
errorCode

enum (CommandErrorCode)

Jeśli polecenie się nie powiodło, kod błędu wyjaśniający przyczynę niepowodzenia. Nie jest ustawiana, gdy polecenie zostanie anulowane przez wywołującego. W przypadku błędów poleceń preferuj pola w tej kolejności (od najbardziej preferowanego): 1. Pola specyficzne dla polecenia, takie jak clearAppsDataStatus, startLostModeStatus lub podobne, jeśli istnieją. 2. To pole, jeśli jest ustawione. 3. Ogólne pole error w Operation, które zawiera polecenie.
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 mieć co najmniej 6 znaków, jeśli składa się z cyfr. W przeciwnym razie polecenie zakończy się niepowodzeniem i wyświetli się komunikat INVALID_VALUE.
resetPasswordFlags[]

enum (ResetPasswordFlag)

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

Pole unii params. Parametry specyficzne dla polecenia. Pamiętaj, że niektóre polecenia nie używają tego parametru, w szczególności LOCK, RESET_PASSWORD, REBOOT i RELINQUISH_OWNERSHIP. W przyszłości te polecenia mogą również korzystać z tej funkcji.

Jeśli ta opcja jest ustawiona, pola new_password i reset_password_flags nie mogą być ustawione. params może mieć tylko jedną z tych wartości:
clearAppsDataParams

object (ClearAppsDataParams)

Parametry polecenia CLEAR_APP_DATA służące do usuwania danych określonych aplikacji z urządzenia. Zobacz ClearAppsDataParams. Jeśli ta zasada jest skonfigurowana, zalecamy, aby zasada type nie była skonfigurowana. W takim przypadku serwer automatycznie ustawia wartość CLEAR_APP_DATA. Możesz też jawnie ustawić wartość type na CLEAR_APP_DATA.
startLostModeParams

object (StartLostModeParams)

Parametry polecenia START_LOST_MODE, które włącza tryb utraconego urządzenia. Zobacz StartLostModeParams. Jeśli ta zasada jest skonfigurowana, zalecamy, aby zasada type nie była skonfigurowana. W takim przypadku serwer automatycznie ustawia wartość START_LOST_MODE. Możesz też jawnie ustawić wartość type na START_LOST_MODE.
stopLostModeParams

object (StopLostModeParams)

Parametry polecenia STOP_LOST_MODE, które wyłącza tryb utraconego urządzenia. Zobacz StopLostModeParams. Jeśli ta zasada jest skonfigurowana, zalecamy, aby zasada type nie była skonfigurowana. W takim przypadku serwer automatycznie ustawia wartość STOP_LOST_MODE. Możesz też jawnie ustawić wartość type na STOP_LOST_MODE.
addEsimParams

object (AddEsimParams)

Opcjonalnie. Parametry polecenia ADD_ESIM służącego do dodawania profilu eSIM na urządzeniu. Jeśli ta zasada jest skonfigurowana, zalecamy, aby zasada type nie była skonfigurowana. W takim przypadku serwer automatycznie ustawia wartość ADD_ESIM. Możesz też jawnie ustawić wartość type na ADD_ESIM.
removeEsimParams

object (RemoveEsimParams)

Opcjonalnie. Parametry polecenia REMOVE_ESIM służącego do usuwania profilu eSIM z urządzenia. Jeśli ta zasada jest skonfigurowana, zalecamy, aby zasada type nie była skonfigurowana. W takim przypadku serwer automatycznie ustawia wartość REMOVE_ESIM. Możesz też jawnie ustawić wartość type na REMOVE_ESIM.
requestDeviceInfoParams

object (RequestDeviceInfoParams)

Opcjonalnie. Parametry polecenia REQUEST_DEVICE_INFO służące do uzyskiwania informacji o urządzeniu. Jeśli ta zasada jest skonfigurowana, zalecamy, aby zasada type nie była skonfigurowana. W takim przypadku serwer automatycznie ustawia wartość REQUEST_DEVICE_INFO . Możesz też jawnie ustawić wartość type na REQUEST_DEVICE_INFO.
wipeParams

object (WipeParams)

Opcjonalnie. Parametry polecenia WIPE służącego do czyszczenia urządzenia. Jeśli ta zasada jest skonfigurowana, zalecamy, aby zasada type nie była skonfigurowana. W takim przypadku serwer automatycznie ustawia wartość WIPE. Możesz też jawnie ustawić wartość type na WIPE.
Pole unii status. Stan związany z poleceniem. Pamiętaj, że niektóre polecenia nie używają tego parametru, w szczególności LOCK, RESET_PASSWORD, REBOOT i RELINQUISH_OWNERSHIP. W przyszłości te polecenia mogą również korzystać z tej funkcji. status może mieć tylko jedną z tych wartości:
clearAppsDataStatus

object (ClearAppsDataStatus)

Tylko dane wyjściowe. Stan polecenia CLEAR_APP_DATA, które służy do czyszczenia danych określonych aplikacji z urządzenia. Zobacz ClearAppsDataStatus.
startLostModeStatus

object (StartLostModeStatus)

Tylko dane wyjściowe. Stan polecenia START_LOST_MODE, które ma przełączyć urządzenie w tryb utraconego urządzenia. Zobacz StartLostModeStatus.
stopLostModeStatus

object (StopLostModeStatus)

Tylko dane wyjściowe. Stan polecenia STOP_LOST_MODE, które ma wyłączyć tryb utraconego urządzenia. Zobacz StopLostModeStatus.
esimStatus

object (EsimCommandStatus)

Tylko dane wyjściowe. Stan polecenia ADD_ESIM lub REMOVE_ESIM.
requestDeviceInfoStatus

object (RequestDeviceInfoStatus)

Tylko dane wyjściowe. Stan polecenia REQUEST_DEVICE_INFO.

CommandType

Rodzaje poleceń.

Wartości w polu enum
COMMAND_TYPE_UNSPECIFIED Ta wartość jest niedozwolona.
LOCK Zablokuj urządzenie, tak jakby upłynął czas oczekiwania na blokadę ekranu.
RESET_PASSWORD Zresetuj hasło użytkownika.
REBOOT Uruchom ponownie urządzenie. Obsługiwane 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, umożliwiając korzystanie z niego do celów osobistych. Aplikacje i dane powiązane z profilami osobistymi zostaną zachowane. Urządzenie zostanie usunięte z serwera po potwierdzeniu polecenia.
CLEAR_APP_DATA Czyści dane aplikacji określonych aplikacji. Ta funkcja jest obsługiwana na urządzeniach z Androidem 9 lub nowszym. 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 Wyłą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ż stopLostModeParams.
ADD_ESIM Dodaje profil eSIM na urządzeniu. Ta funkcja jest obsługiwana na urządzeniach z Androidem 15 lub nowszym. Zobacz też addEsimParams. Aby usunąć profil eSIM, użyj polecenia REMOVE_ESIM. Aby określić, co się stanie z profilem eSIM po wyczyszczeniu urządzenia, ustaw w zasadach wartość wipeDataFlags. Uwaga: aby zainstalować wiele kart eSIM na jednym urządzeniu, zalecamy odczekanie kilku minut między kolejnymi wykonaniami polecenia.
REMOVE_ESIM Usuwa profil eSIM z urządzenia. Ta funkcja jest obsługiwana na urządzeniach z Androidem 15 lub nowszym. Zobacz też removeEsimParams.
REQUEST_DEVICE_INFO Poproś o informacje związane z urządzeniem.
WIPE Czyści urządzenie, przywracając ustawienia fabryczne na urządzeniu należącym do firmy lub usuwając profil służbowy na urządzeniu osobistym z profilem służbowym. Wymazywanie danych następuje dopiero po potwierdzeniu polecenia przez urządzenie. Do tego czasu polecenie można anulować.

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 było żadnego błędu.
UNKNOWN Wystąpił nieznany błąd.
API_LEVEL Poziom 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 aplikacji Zasady dotyczące 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 ponowną 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 zablokować urządzenie po zresetowaniu hasła;

ClearAppsDataParams

Parametry powiązane z poleceniem CLEAR_APP_DATA, które służy do czyszczenia danych określonych aplikacji z urządzenia.

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

string

Nazwy pakietów aplikacji, których dane zostaną usunięte po wykonaniu polecenia.

StartLostModeParams

Parametry powiązane z poleceniem START_LOST_MODE, które służy do włączania trybu utraconego urządzenia. Aby urządzenie zostało przełączone w tryb utraconego urządzenia, musisz podać co najmniej 1 parametr (z wyjątkiem nazwy organizacji).

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

object (UserFacingMessage)

Wiadomość wyświetlana 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 będzie w trybie utraconego urządzenia i użytkownik kliknie przycisk właściciela połączenia.
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 jest 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 ma pól.

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

AddEsimParams

Parametry powiązane z poleceniem ADD_ESIM, które służy do dodawania profilu eSIM na urządzeniu.

Zapis JSON 
{
  "activationCode": string,
  "activationState": enum (ActivationState)
}
Pola
activationCode

string

Wymagane. Kod aktywacyjny profilu eSIM.
activationState

enum (ActivationState)

Wymagane. Stan aktywacji profilu eSIM po jego pobraniu.

ActivationState

Stan aktywacji profilu eSIM po jego pobraniu.

Wartości w polu enum
ACTIVATION_STATE_UNSPECIFIED Stan aktywacji karty eSIM jest nieokreślony. Domyślnie profil eSIM jest NOT_ACTIVATED na urządzeniach należących do pracowników i ACTIVATED na urządzeniach należących do firmy.
ACTIVATED Po pobraniu karta eSIM zostanie automatycznie aktywowana. Ustawienie tego stanu aktywacji na urządzeniach należących do użytkownika spowoduje odrzucenie polecenia.
NOT_ACTIVATED Profil eSIM zostanie pobrany, ale nieaktywowany. W takim przypadku użytkownik musi ręcznie aktywować kartę eSIM na urządzeniu.

RemoveEsimParams

Parametry powiązane z poleceniem REMOVE_ESIM, które służy do usuwania profilu eSIM z urządzenia.

Zapis JSON 
{
  "iccId": string
}
Pola
iccId

string

Wymagane. Identyfikator ICCID profilu eSIM, który ma zostać usunięty.

RequestDeviceInfoParams

Parametry powiązane z poleceniem REQUEST_DEVICE_INFO, które służą do uzyskiwania informacji o urządzeniu.

Zapis JSON 
{
  "deviceInfo": enum (DeviceInfo)
}
Pola
deviceInfo

enum (DeviceInfo)

Wymagane. Typ informacji o urządzeniu, o które chcesz poprosić.

DeviceInfo

Typ informacji o urządzeniu, o które chcesz poprosić.

Wartości w polu enum
DEVICE_INFO_UNSPECIFIED Ta wartość jest niedozwolona.
EID Poproś o identyfikator karty eSIM. Zanim użytkownik otrzyma wynik, zostanie poproszony o zatwierdzenie ujawnienia informacji. Jeśli użytkownik nie zatwierdzi ujawnienia informacji, zostanie zwrócona wartość USER_DECLINED. Ta funkcja jest obsługiwana tylko na urządzeniach należących do użytkownika z profilami służbowymi i Androidem 13 lub nowszym.

WipeParams

Parametry powiązane z poleceniem WIPE służącym do czyszczenia urządzenia.

Zapis JSON 
{
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "wipeReason": {
    object (UserFacingMessage)
  }
}
Pola
wipeDataFlags[]

enum (WipeDataFlag)

Opcjonalnie. Flagi określające, które dane mają zostać wyczyszczone.
wipeReason

object (UserFacingMessage)

Opcjonalnie. Krótka wiadomość wyświetlana użytkownikowi przed wyczyszczeniem profilu służbowego na urządzeniach osobistych. Nie ma to wpływu na urządzenia należące do firmy. Maksymalna długość wiadomości to 200 znaków.

ClearAppsDataStatus

Stan polecenia CLEAR_APP_DATA, które służy do czyszczenia 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 czyszczenia.

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

PerAppResult

Wynik próby wyczyszczenia danych pojedynczej aplikacji.

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

enum (ClearingResult)

Wynik próby wyczyszczenia danych pojedynczej aplikacji.

ClearingResult

Wynik próby wyczyszczenia danych pojedynczej 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ż nie została ona znaleziona.
APP_PROTECTED Nie udało się wyczyścić danych tej aplikacji, ponieważ jest ona chroniona. Może to dotyczyć np. aplikacji kluczowych dla działania urządzenia, takich jak Sklep Google Play.
API_LEVEL Nie można wyczyścić danych tej aplikacji, ponieważ poziom interfejsu API urządzenia nie obsługuje tego polecenia.

StartLostModeStatus

Stan polecenia START_LOST_MODE, które ma przełączyć 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 przełączone w tryb utraconego urządzenia.
RESET_PASSWORD_RECENTLY Nie udało się włączyć trybu utraconego urządzenia, ponieważ administrator niedawno zresetował hasło urządzenia.
USER_EXIT_LOST_MODE_RECENTLY Nie udało się włączyć trybu utraconego urządzenia, ponieważ użytkownik niedawno go wyłączył.
ALREADY_IN_LOST_MODE Urządzenie jest już w trybie utraconego urządzenia.

StopLostModeStatus

Stan polecenia STOP_LOST_MODE, które ma wyłączyć tryb 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 wyłączone z trybu utraconego urządzenia.
NOT_IN_LOST_MODE Urządzenie nie jest w trybie utraconego urządzenia.

EsimCommandStatus

Stan i szczegóły błędu (jeśli wystąpił) polecenia ADD_ESIM lub REMOVE_ESIM.

Zapis JSON 
{
  "status": enum (Status),
  "esimInfo": {
    object (EsimInfo)
  },

  // Union field status_details can be only one of the following:
  "internalErrorDetails": {
    object (InternalErrorDetails)
  }
  // End of list of possible types for union field status_details.
}
Pola
status

enum (Status)

Tylko dane wyjściowe. Stan polecenia ADD_ESIM lub REMOVE_ESIM.
esimInfo

object (EsimInfo)

Tylko dane wyjściowe. Informacje o dodanej lub usuniętej karcie eSIM. To pole jest wypełniane tylko wtedy, gdy operacja na karcie eSIM status ma wartość SUCCESS.
Pole unii status_details. Szczegóły stanu polecenia ADD_ESIM lub REMOVE_ESIM. status_details może mieć tylko jedną z tych wartości:
internalErrorDetails

object (InternalErrorDetails)

Tylko dane wyjściowe. Szczegóły błędu, jeśli parametr status ma wartość INTERNAL_ERROR.

Stan

Stan polecenia ADD_ESIM lub REMOVE_ESIM.

Wartości w polu enum
STATUS_UNSPECIFIED Nie określono. Ta wartość nie jest używana.
SUCCESS Operacja na karcie eSIM została wykonana na urządzeniu.
IN_PROGRESS Operacja na karcie eSIM jest w toku.
PENDING_USER_ACTION Aby można było kontynuować operację eSIM, użytkownik musi wykonać działanie.
ERROR_SETUP_IN_PROGRESS Operacji na karcie eSIM nie można wykonać, gdy trwa konfiguracja.
ERROR_USER_DENIED Użytkownik odrzucił operację eSIM.
INTERNAL_ERROR Podczas próby dodania lub usunięcia karty eSIM na urządzeniu wystąpił błąd. Więcej informacji znajdziesz w artykule internalErrorDetails.
ERROR_ICC_ID_NOT_FOUND W przypadku polecenia REMOVE_ESIM na urządzeniu nie znaleziono iccId karty eSIM, która ma zostać usunięta. Może to oznaczać, że karta eSIM nie należy do firmy lub karta eSIM odpowiadająca iccId nie jest obecna na urządzeniu.
ERROR_MULTIPLE_ACTIVE_ESIMS_NO_AVAILABLE_SLOT Polecenie ADD_ESIM nie powiodło się podczas próby dodania nowej karty eSIM ze stanem aktywacji ustawionym na ACTIVATED, ponieważ wiele gniazd eSIM na urządzeniu zawiera aktywne profile eSIM i nie ma dostępnego wolnego gniazda eSIM. Aby rozwiązać ten problem, nową kartę eSIM można dodać ze stanem aktywacji NOT_ACTIVATED, aby później aktywować ją ręcznie. Można też najpierw dezaktywować istniejącą aktywną kartę eSIM, aby kontynuować operację.

InternalErrorDetails

Szczegóły błędu wewnętrznego, jeśli występuje w przypadku polecenia ADD_ESIM lub REMOVE_ESIM.

Zapis JSON 
{
  "operationCode": string,
  "errorCode": string,
  "operationCodeDetail": enum (OperationCodeDetail),
  "errorCodeDetail": enum (ErrorCodeDetail)
}
Pola
operationCode

string (int64 format)

Tylko dane wyjściowe. Liczbowe przedstawienie kodu operacji zgodnie z opisem tutaj. Więcej informacji znajdziesz w sekcji operationCodeDetail.
errorCode

string (int64 format)

Tylko dane wyjściowe. Liczbowe przedstawienie kodu błędu zgodnie z opisem tutaj. Zobacz też OPERATION_SMDX_SUBJECT_REASON_CODE. Więcej informacji znajdziesz w sekcji errorCodeDetail.
operationCodeDetail

enum (OperationCodeDetail)

Tylko dane wyjściowe. Szczegóły kodu operacji odpowiadające wartości operationCode.
errorCodeDetail

enum (ErrorCodeDetail)

Tylko dane wyjściowe. Szczegóły kodu błędu odpowiadające wartości errorCode.

OperationCodeDetail

Szczegóły kodu operacji odpowiadające wartości operationCode.

Wartości w polu enum
OPERATION_CODE_DETAIL_UNSPECIFIED Szczegóły kodu operacji są nieokreślone. Interfejs operationCode nie jest rozpoznawany przez Android Management API. Więcej informacji znajdziesz w artykule operationCode.
OPERATION_SYSTEM Szczegółowe informacje znajdziesz w artykule EuiccManager.OPERATION_SYSTEM.
OPERATION_SIM_SLOT Szczegółowe informacje znajdziesz w artykule EuiccManager.OPERATION_SIM_SLOT.
OPERATION_EUICC_CARD Więcej informacji znajdziesz w sekcji EuiccManager.OPERATION_EUICC_CARD.
OPERATION_SMDX Więcej informacji znajdziesz w sekcji EuiccManager.OPERATION_SMDX.
OPERATION_SWITCH Szczegółowe informacje znajdziesz w artykule EuiccManager.OPERATION_SWITCH.
OPERATION_DOWNLOAD Więcej informacji znajdziesz w sekcji EuiccManager.OPERATION_DOWNLOAD.
OPERATION_METADATA Szczegółowe informacje znajdziesz w sekcji EuiccManager.OPERATION_METADATA.
OPERATION_EUICC_GSMA Szczegółowe informacje znajdziesz w artykule EuiccManager.OPERATION_EUICC_GSMA.
OPERATION_APDU Więcej informacji znajdziesz w sekcji EuiccManager.OPERATION_APDU.
OPERATION_SMDX_SUBJECT_REASON_CODE Szczegółowe informacje znajdziesz w sekcji EuiccManager.OPERATION_SMDX_SUBJECT_REASON_CODE. Pamiętaj, że w tym przypadku errorCode to 3 najmniej znaczące bajty kodu EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE, które określają kod tematu i kod przyczyny, jak wskazano tutaj. Najbardziej znaczący bajt liczby całkowitej jest wyzerowany. Na przykład kod tematu 8.11.1 i kod przyczyny 5.1 są w errorCode reprezentowane jako 0000 0000 1000 1011 0001 0000 0101 0001 w systemie binarnym, co w systemie dziesiętnym daje 9113681.
OPERATION_HTTP Szczegółowe informacje znajdziesz w sekcji EuiccManager.OPERATION_HTTP.

ErrorCodeDetail

Szczegóły kodu błędu odpowiadające wartości errorCode.

Wartości w polu enum
ERROR_CODE_DETAIL_UNSPECIFIED Szczegóły kodu błędu nie są określone. Interfejs errorCode nie jest rozpoznawany przez Android Management API. Więcej informacji znajdziesz w sekcji errorCode.
ERROR_TIME_OUT Więcej informacji znajdziesz w sekcji EuiccManager.ERROR_TIME_OUT.
ERROR_EUICC_MISSING Więcej informacji znajdziesz w sekcji EuiccManager.ERROR_EUICC_MISSING.
ERROR_UNSUPPORTED_VERSION Szczegółowe informacje znajdziesz w artykule EuiccManager.ERROR_UNSUPPORTED_VERSION.
ERROR_ADDRESS_MISSING Więcej informacji znajdziesz w sekcji EuiccManager.ERROR_ADDRESS_MISSING.
ERROR_INVALID_CONFIRMATION_CODE Szczegółowe informacje znajdziesz w sekcji EuiccManager.ERROR_INVALID_CONFIRMATION_CODE.
ERROR_CERTIFICATE_ERROR Więcej informacji znajdziesz w sekcji EuiccManager.ERROR_CERTIFICATE_ERROR.
ERROR_NO_PROFILES_AVAILABLE Szczegółowe informacje znajdziesz w sekcji EuiccManager.ERROR_NO_PROFILES_AVAILABLE.
ERROR_CONNECTION_ERROR Szczegółowe informacje znajdziesz w sekcji EuiccManager.ERROR_CONNECTION_ERROR.
ERROR_INVALID_RESPONSE Szczegółowe informacje znajdziesz w sekcji EuiccManager.ERROR_INVALID_RESPONSE.
ERROR_CARRIER_LOCKED Więcej informacji znajdziesz w sekcji EuiccManager.ERROR_CARRIER_LOCKED.
ERROR_DISALLOWED_BY_PPR Więcej informacji znajdziesz w sekcji EuiccManager.ERROR_DISALLOWED_BY_PPR.
ERROR_INVALID_ACTIVATION_CODE Szczegółowe informacje znajdziesz w artykule EuiccManager.ERROR_INVALID_ACTIVATION_CODE.
ERROR_INCOMPATIBLE_CARRIER Szczegółowe informacje znajdziesz w sekcji EuiccManager.ERROR_INCOMPATIBLE_CARRIER.
ERROR_OPERATION_BUSY Szczegółowe informacje znajdziesz w artykule EuiccManager.ERROR_OPERATION_BUSY.
ERROR_INSTALL_PROFILE Szczegółowe informacje znajdziesz w sekcji EuiccManager.ERROR_INSTALL_PROFILE.
ERROR_EUICC_INSUFFICIENT_MEMORY Więcej informacji znajdziesz w sekcji EuiccManager.ERROR_EUICC_INSUFFICIENT_MEMORY.
ERROR_INVALID_PORT Szczegółowe informacje znajdziesz w sekcji EuiccManager.ERROR_INVALID_PORT.
ERROR_SIM_MISSING Szczegółowe informacje znajdziesz w artykule EuiccManager.ERROR_SIM_MISSING.

EsimInfo

Szczegóły dodanej lub usuniętej karty eSIM.

Zapis JSON 
{
  "iccId": string
}
Pola
iccId

string

Tylko dane wyjściowe. Identyfikator ICCID karty eSIM.

RequestDeviceInfoStatus

Stan polecenia REQUEST_DEVICE_INFO.

Zapis JSON 
{
  "status": enum (Status),

  // Union field device_info can be only one of the following:
  "eidInfo": {
    object (EidInfo)
  }
  // End of list of possible types for union field device_info.
}
Pola
status

enum (Status)

Tylko dane wyjściowe. Stan polecenia REQUEST_DEVICE_INFO.
Pole unii device_info. Szczegóły informacji o urządzeniu, o które poprosił administrator. To pole jest wypełniane tylko wtedy, gdy status ma wartość SUCCEEDED. device_info może mieć tylko jedną z tych wartości:
eidInfo

object (EidInfo)

Informacje dotyczące numerów EID urządzenia.

Stan

Stan polecenia REQUEST_DEVICE_INFO.

Wartości w polu enum
STATUS_UNSPECIFIED Nie określono. Ta wartość nie jest używana.
SUCCEEDED Informacje o urządzeniu zostały przesłane.
PENDING_USER_ACTION Użytkownik nie wykonał działań wymaganych do udostępnienia informacji o urządzeniu.
USER_DECLINED Użytkownik odmówił udostępnienia informacji o urządzeniu.
UNSUPPORTED Informacje o urządzeniu nie są obsługiwane na tym urządzeniu, np. urządzenie nie obsługuje karty eSIM.

EidInfo

Informacje dotyczące numerów EID urządzenia.

Zapis JSON 
{
  "eids": [
    {
      object (Eid)
    }
  ]
}
Pola
eids[]

object (Eid)

Tylko dane wyjściowe. Informacje o identyfikatorze EID dla każdego chipa eUICC.

Eid

Informacje o identyfikatorze EID dla każdego chipa eUICC.

Zapis JSON 
{
  "eid": string
}
Pola
eid

string

Tylko dane wyjściowe. EID