Listę metod stosowanych w tym zasobie znajdziesz na końcu tej strony.
Reprezentacja zasobów
Zasób Urządzenia reprezentuje urządzenie mobilne zarządzane przez dostawcę usług EMM i należące do określonego użytkownika firmowego.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
Nazwa usługi, | Wartość | Opis | Uwagi |
---|---|---|---|
androidId |
string |
Identyfikator Androida w Usługach Google Play dla urządzenia zakodowany jako ciąg szesnastkowy z małymi literami. Na przykład: "123456789abcdef0" . |
|
device |
string |
Wewnętrzna nazwa kodowa urządzenia. Dane pochodzą z: android.os.Build.DEVICE . (pole o nazwie „device” w przypadku logów/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
Odcisk cyfrowy kompilacji urządzenia, jeśli jest znany. | |
maker |
string |
Producent urządzenia. Dane pochodzą z: android.os.Build.MANUFACTURER . |
|
managementType |
string |
Określa zakres, w jakim urządzenie jest kontrolowane przez dostawcę usług EMM w zarządzanym Sklepie Google Play w różnych konfiguracjach wdrożeń. Możliwe wartości:
Akceptowane wartości:
|
|
model |
string |
Nazwa modelu urządzenia. Dane pochodzą z: android.os.Build.MODEL . |
|
policy |
nested object |
Zasada egzekwowana na urządzeniu. | |
policy.autoUpdatePolicy |
string |
Określa, kiedy na urządzeniu mogą być stosowane automatyczne aktualizacje aplikacji. Zalecana alternatywa: autoUpdateMode , ustawiony dla każdej aplikacji, zapewnia większą elastyczność w zakresie częstotliwości aktualizacji. Gdy zasada autoUpdateMode ma wartość AUTO_UPDATE_POSTPONED lub AUTO_UPDATE_HIGH_PRIORITY , funkcja autoUpdatePolicy nie ma żadnego efektu. Funkcja „choiceToTheUser” pozwala użytkownikowi urządzenia skonfigurować zasady aktualizacji aplikacji. Ustawienie „zawsze” włącza automatyczne aktualizacje. Opcja „nigdy” powoduje wyłączenie automatycznych aktualizacji. Ustawienie „wifiOnly” powoduje automatyczne aktualizacje tylko wtedy, gdy urządzenie jest połączone z Wi-Fi. Akceptowane wartości:
|
|
policy.deviceReportPolicy |
string |
Określa, czy urządzenie zgłasza do dostawcy usług EMM stany aplikacji. Wartość domyślna to „deviceReportDisabled”.
Akceptowane wartości:
|
|
policy.maintenanceWindow |
nested object |
Okres konserwacji określający, kiedy aplikacje działające na pierwszym planie powinny zostać zaktualizowane. | |
policy.maintenanceWindow.durationMs |
long |
Czas trwania okresu konserwacji w milisekundach. Czas trwania musi wynosić od 30 minut do 24 godzin (włącznie). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
Godzina rozpoczęcia okresu konserwacji na urządzeniu (w milisekundach po północy). System Windows może obejmować północ. | |
policy.productAvailabilityPolicy |
string |
Dostępność określonych produktów dla urządzenia. Ustawienie „Wszystkie” oznacza, że urządzenie ma dostęp do wszystkich produktów, niezależnie od stanu zatwierdzenia. Opcja „wszystkie” nie włącza automatycznej widoczności ścieżek „alfa” i „beta”. „biała lista” zapewnia urządzeniu dostęp do produktów określonych w zasadach productPolicy[]. Na białej liście mogą umieścić tylko produkty zatwierdzone i wcześniej zatwierdzone przez firmę (które zostały unieważnione). Jeśli nie podasz żadnej wartości, domyślnie zostanie zastosowana dostępność ustawiona na poziomie użytkownika.
Akceptowane wartości:
|
|
policy.productPolicy[] |
list |
Lista zasad dotyczących usług. Aby można było zastosować zasady usługi, productAvailabilityPolicy musi być ustawiony na WHITELIST lub ALL . |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
Zasady automatycznej instalacji usługi. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
Ograniczenia dotyczące automatycznego instalowania aplikacji. Możesz określić maksymalnie 1 ograniczenie. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Ograniczenie stanu ładowania.
Akceptowane wartości:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Ograniczenie dotyczące stanu bezczynności urządzenia.
Akceptowane wartości:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Ograniczenie typu sieci.
Akceptowane wartości:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
tryb automatycznej instalacji. Jeśli zasada jest nieskonfigurowana, stosowana jest domyślna wartość „doNotAutoInstall”. Aplikacja jest instalowana automatycznie niezależnie od ustawionego okresu konserwacji.
Akceptowane wartości:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
Priorytet instalacji w postaci nieoznaczonej liczby całkowitej. Mniejsza liczba oznacza wyższy priorytet. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
Minimalna wersja aplikacji. Jeśli zainstalowana jest niższa wersja aplikacji, zostanie ona automatycznie zaktualizowana zgodnie z ograniczeniami dotyczącymi instalacji automatycznej, zamiast czekać na zwykłą automatyczną aktualizację. Minimalny kod wersji możesz ustawić dla maksymalnie 20 aplikacji na urządzenie. | |
policy.productPolicy[].autoUpdateMode |
string |
Tryb automatycznych aktualizacji usługi. Jeśli używana jest zasada autoUpdateMode , ma ona zawsze pierwszeństwo przed wyborami użytkownika. Gdy użytkownik ręcznie wprowadzi zmiany w ustawieniach urządzenia, zostaną one zignorowane.
Akceptowane wartości:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
Konfiguracja adresu URL uwierzytelniania dla aplikacji uwierzytelniającej dostawcy tożsamości. Ułatwia to uruchamianie aplikacji uwierzytelniającej dostawcy tożsamości podczas uwierzytelniania w aplikacji prywatnej z Androidem WebView. Aplikacja Authenticator powinna być już domyślnym modułem obsługi adresu URL uwierzytelniania na urządzeniu. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
Adres URL uwierzytelniania. | |
policy.productPolicy[].managedConfiguration |
nested object |
Konfiguracja zarządzana usługi. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
Zawiera identyfikator profilu konfiguracji zarządzanej oraz zbiór zmiennych konfiguracji (jeśli istnieją) zdefiniowane dla użytkownika. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
Identyfikator ustawień konfiguracji zarządzanych. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
Zestaw zmiennych przypisany do użytkownika. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
Ciąg zastępczy zdefiniowany przez dostawcę usług EMM. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
Wartość obiektu zastępczego przypisana do użytkownika. | |
policy.productPolicy[].managedConfiguration.kind |
string |
Wycofane. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
Zbiór właściwości zarządzanych na potrzeby tej konfiguracji. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
Unikalny klucz identyfikujący usługę. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
Wartość logiczna – będzie widoczna tylko wtedy, gdy typem właściwości jest wartość logiczna. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
Pakiet usług zarządzanych – występuje tylko wtedy, gdy typ usługi to pakiet. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
Lista usług zarządzanych. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
Lista pakietów właściwości – występuje tylko wtedy, gdy typ właściwości to „bundle_array”. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
Lista usług zarządzanych. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
Wartość całkowita – będzie widoczna tylko wtedy, gdy typem właściwości jest liczba całkowita. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
Wartość ciągu – będzie widoczna tylko wtedy, gdy typem właściwości jest ciąg znaków, wybór lub ukryty. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
lista wartości ciągów tekstowych – występuje tylko wtedy, gdy typ usługi to wybór wielokrotny. | |
policy.productPolicy[].managedConfiguration.productId |
string |
Identyfikator usługi, której dotyczy konfiguracja zarządzana, np. „app:com.google.android.gm”. | |
policy.productPolicy[].productId |
string |
Identyfikator produktu. Na przykład: "app:com.google.android.gm" . |
|
policy.productPolicy[].trackIds[] |
list |
Przyznaje urządzeniu widoczność na określonych ścieżkach wersji usługi identyfikowanych przez trackIds . Listę ścieżek wersji usługi można uzyskać za pomocą wywołania usługi Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
Rola wycofana. Użyj w zamian zasady trackIds . |
|
product |
string |
Nazwa produktu urządzenia. Dane pochodzą z: android.os.Build.PRODUCT . |
|
report |
nested object |
Raport o urządzeniach został zaktualizowany o najnowsze stany aplikacji. | |
report.appState[] |
list |
Lista stanów aplikacji ustawionych przez aplikacje zarządzane na urządzeniu. Stany aplikacji są definiowane przez jej deweloperów. To pole zawsze będzie obecne. | |
report.appState[].keyedAppState[] |
list |
Lista stanów aplikacji z kluczem. To pole zawsze będzie obecne. | |
report.appState[].keyedAppState[].data |
string |
Dodatkowe pole przeznaczone na dane czytelne dla komputera. Na przykład liczba lub obiekt JSON. Aby zapobiec atakom XSS, zalecamy usunięcie kodu HTML z danych przed ich wyświetleniem. | |
report.appState[].keyedAppState[].key |
string |
Klucz wskazujący, do czego aplikacja przekazuje stan. Zawartość klucza jest ustawiana przez dewelopera aplikacji. Aby zapobiec atakom XSS, zalecamy usunięcie z klucza kodu HTML przed jego wyświetleniem. To pole zawsze będzie obecne. | |
report.appState[].keyedAppState[].message |
string |
Dowolny, zrozumiały dla człowieka komunikat opisujący stan aplikacji. np. komunikat o błędzie. Aby zapobiec atakom XSS, zalecamy usunięcie z wiadomości kodu HTML przed jej wyświetleniem. | |
report.appState[].keyedAppState[].severity |
string |
Poziom ważności stanu aplikacji. To pole zawsze będzie obecne.
Akceptowane wartości:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
Sygnatura czasowa ustawienia stanu przez aplikację w milisekundach od początku epoki. To pole zawsze będzie obecne. | |
report.appState[].packageName |
string |
Nazwa pakietu aplikacji. To pole będzie zawsze obecne. | |
report.lastUpdatedTimestampMillis |
long |
Sygnatura czasowa ostatniej aktualizacji raportu w milisekundach od początku epoki. To pole zawsze będzie obecne. | |
retailBrand |
string |
Marka handlowa urządzenia (jeśli jest ustawiona). Zobacz android.os.Build.BRAND |
|
sdkVersion |
integer |
Wersja zgodności interfejsu API. |
Metody
- forceReportUpload
- Przesyła raport zawierający wszystkie zmiany stanów aplikacji na urządzeniu od momentu wygenerowania ostatniego raportu. Tę metodę możesz wywoływać na danym urządzeniu maksymalnie 3 razy w ciągu 24 godzin.
- pobierz
- Pobiera szczegółowe informacje o urządzeniu.
- getState
- Sprawdza, czy dostęp urządzenia do usług Google jest włączony czy wyłączony. Stan urządzenia ma zastosowanie tylko wtedy, gdy w konsoli administracyjnej Google jest włączone egzekwowanie zasad EMM na urządzeniach z Androidem. W przeciwnym razie stan urządzenia będzie ignorowany, a wszystkie urządzenia będą mogły korzystać z usług Google. Ta funkcja jest obsługiwana tylko w przypadku użytkowników zarządzanych przez Google.
- list
- Pobiera identyfikatory wszystkich urządzeń użytkownika.
- setState
- Określa, czy dostęp urządzenia do usług Google jest włączony czy wyłączony. Stan urządzenia ma zastosowanie tylko wtedy, gdy w konsoli administracyjnej Google jest włączone egzekwowanie zasad EMM na urządzeniach z Androidem. W przeciwnym razie stan urządzenia będzie ignorowany, a wszystkie urządzenia będą mogły korzystać z usług Google. Ta funkcja jest obsługiwana tylko w przypadku użytkowników zarządzanych przez Google.
- aktualizacja
- Aktualizuje zasady dotyczące urządzeń.
Aby mieć pewność, że zasady są prawidłowo egzekwowane, musisz zablokować dostęp do Google Play kontom niezarządzanym, ustawiając właściwośćallowed_accounts
w konfiguracji zarządzanej pakietu Google Play. Więcej informacji znajdziesz w artykule o ograniczaniu kont w Google Play.