Listę metod dotyczących tego zasobu znajdziesz na końcu tej strony.
Prezentacje zasobów
Zasób Devices reprezentuje urządzenie mobilne zarządzane przez EMM i należące do konkretnego użytkownika w firmie.
{ "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, "policyId": 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 urządzenia zakodowanego w postaci ciągu szesnastkowego z małymi literami. Na przykład: "123456789abcdef0" . |
|
device |
string |
Wewnętrzna nazwa kodowa sprzętu urządzenia. To jest z android.os.Build.DEVICE . (pole o nazwie „device” na logi/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
Odcisk cyfrowy kompilacji urządzenia, jeśli jest znany. | |
maker |
string |
Producent urządzenia. To jest z android.os.Build.MANUFACTURER . |
|
managementType |
string |
Określa zakres, w jakim urządzenie jest kontrolowane przez dostawcę usług EMM z zarządzanego Sklepu Google Play w różnych konfiguracjach wdrożenia. Możliwe wartości:
Akceptowane wartości:
|
|
model |
string |
Nazwa modelu urządzenia. To jest z android.os.Build.MODEL . |
|
policy |
nested object |
Zasady egzekwowane na urządzeniu. | |
policy.autoUpdatePolicy |
string |
Określa, kiedy na urządzeniu mogą być stosowane automatyczne aktualizacje aplikacji. Zalecana alternatywa: autoUpdateMode , która jest ustawiana dla każdej aplikacji, zapewnia większą elastyczność w zakresie częstotliwości aktualizacji. Gdy autoUpdateMode ma wartość AUTO_UPDATE_POSTPONED lub AUTO_UPDATE_HIGH_PRIORITY , autoUpdatePolicy nie ma żadnego wpływu. "choiceToTheUser" pozwala użytkownikowi urządzenia skonfigurować zasady aktualizacji aplikacji. „zawsze” włącza automatyczne aktualizacje. „Nigdy” wyłącza automatyczne aktualizacje. „wifiOnly” włącza automatyczne aktualizacje tylko wtedy, gdy urządzenie jest połączone z siecią Wi-Fi. Akceptowane wartości to:
|
|
policy.deviceReportPolicy |
string |
Określa, czy urządzenie zgłasza stany aplikacji do EMM. Wartość domyślna to „deviceReportDisabled”.
Akceptowane wartości:
|
|
policy.maintenanceWindow |
nested object |
Okres konserwacji, który określa, kiedy aplikacje uruchomione na pierwszym planie mają być aktualizowane. | |
policy.maintenanceWindow.durationMs |
long |
Czas trwania okresu konserwacji (w milisekundach). Musi on wynosić od 30 minut do 24 godzin (włącznie). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
Czas rozpoczęcia okresu konserwacji w milisekundach od północy na urządzeniu. Okna mogą obejmować północ. | |
policy.policyId |
string |
Identyfikator zasady, który zostanie przekazany wraz z informacjami o instalacji aplikacji wysłanymi ze Sklepu Play. | |
policy.productAvailabilityPolicy |
string |
Dostępność określonych produktów przypisana do urządzenia. „Wszystkie” daje urządzeniu dostęp do wszystkich usług niezależnie od stanu zatwierdzenia. „wszystko” nie włącza automatycznej widoczności wersji „alfa” lub „beta” ścieżek audio. „biała lista” przyznaje urządzeniu dostęp do produktów określonych w zasadzie productPolicy[]. Na białej liście mogą znajdować się tylko produkty zatwierdzone lub wcześniej zatwierdzone przez firmę (produkty z unieważnionym zatwierdzeniem). Jeśli nie podasz żadnej wartości, domyślnie stosowana będzie dostępność ustawiona na poziomie użytkownika.
Akceptowane wartości to:
|
|
policy.productPolicy[] |
list |
Lista zasad dotyczących usług. Aby zastosować zasady dotyczące produktów, musisz ustawić wartość productAvailabilityPolicy na WHITELIST lub ALL . |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
Zasady automatycznej instalacji produktu. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
Ograniczenia dotyczące automatycznej instalacji aplikacji. Możesz określić maksymalnie 1 ograniczenie. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Ograniczenie stanu ładowania.
Akceptowane wartości to:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Ograniczenie stanu bezczynności urządzenia.
Akceptowane wartości to:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Ograniczenie typu sieci.
Akceptowane wartości to:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
Tryb instalowania automatycznej Jeśli nie jest ustawiony, przyjmuje domyślnie wartość „doNotAutoInstall”. Aplikacja jest instalowana automatycznie niezależnie od ustawionego okresu konserwacji.
Akceptowane wartości:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
Priorytet instalacji w postaci liczby całkowitej bez znaku. Im niższa liczba, tym wyższy priorytet. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
Minimalna wersja aplikacji. Jeśli zainstalowana jest starsza wersja aplikacji, zostanie ona automatycznie zaktualizowana zgodnie z ograniczeniami dotyczącymi automatycznej instalacji, zamiast czekać na standardową aktualizację. Możesz ustawić minimalny kod wersji dla maksymalnie 20 aplikacji na urządzenie. | |
policy.productPolicy[].autoUpdateMode |
string |
Tryb automatycznej aktualizacji produktu. Gdy jest używany parametr autoUpdateMode , ma on zawsze pierwszeństwo przed wyborem użytkownika. Oznacza to, że gdy użytkownik ręcznie zmieni ustawienia urządzenia, te zmiany zostaną zignorowane.
Akceptowane wartości:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
Konfiguracja adresu URL uwierzytelniania dla aplikacji uwierzytelniającej dostawcy tożsamości. Dzięki temu podczas uwierzytelniania w aplikacji prywatnej, która korzysta z Androida WebView, uruchamia się aplikacja uwierzytelniająca dostawcy tożsamości. Aplikacja Authenticator powinna już być 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 i zestaw zmiennych konfiguracji (jeśli występują) zdefiniowanych 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 |
Zbiór zmiennych przypisany do użytkownika. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
Ciąg znaków zastępczy; zdefiniowane przez dostawcę usług EMM. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
Wartość obiektu zastępczego, która jest specyficzna dla danego użytkownika. | |
policy.productPolicy[].managedConfiguration.kind |
string |
Wycofano. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
Zestaw usług zarządzanych w ramach 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 typ właściwości to bool. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
Pakiet usług zarządzanych – będzie widoczny tylko wtedy, gdy typem usługi jest „Pakiet”. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
Lista zarządzanych usług. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
Lista pakietów usług – będzie obecna tylko wtedy, gdy typ usługi to bundle_array. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
Lista usług zarządzanych. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
Wartość całkowita – występuje tylko wtedy, gdy typem właściwości jest liczba całkowita. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
Wartość ciągu znaków – występuje tylko wtedy, gdy typem właściwości jest ciąg znaków, wybór lub ukryta. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
Lista wartości ciągu znaków – będzie widoczna tylko wtedy, gdy typem właściwości jest 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 |
Udziela urządzeniu dostępu do ścieżek wersji produktu oznaczonych trackIds . Listę ścieżek wersji produktu można uzyskać, wywołując funkcję Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
Rola wycofana. Użyj w zamian zasady trackIds . |
|
product |
string |
Nazwa urządzenia. Wynik pochodzi z: android.os.Build.PRODUCT . |
|
report |
nested object |
Raport urządzenia z aktualnymi stanami aplikacji. | |
report.appState[] |
list |
Lista stanów aplikacji ustawionych przez aplikacje zarządzane na urządzeniu. Stany aplikacji są definiowane przez deweloperów. To pole będzie zawsze widoczne. | |
report.appState[].keyedAppState[] |
list |
Lista stanów aplikacji z kluczem. To pole będzie zawsze widoczne. | |
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 z danych wszelkich elementów HTML przed ich wyświetleniem. | |
report.appState[].keyedAppState[].key |
string |
Klucz wskazujący, do czego aplikacja dostarcza stan. Treść klucza jest ustawiana przez dewelopera aplikacji. Aby zapobiec atakom XSS, zalecamy usunięcie z klucza kodu HTML przed jego wyświetleniem. To pole będzie zawsze widoczne. | |
report.appState[].keyedAppState[].message |
string |
Swobodny, zrozumiały dla człowieka komunikat opisujący stan aplikacji. Może to być na przykład komunikat o błędzie. Aby zapobiec atakom XSS, zalecamy usunięcie kodu HTML z wiadomości przed jej wyświetleniem. | |
report.appState[].keyedAppState[].severity |
string |
Waga stanu aplikacji. To pole będzie zawsze widoczne.
Akceptowane wartości to:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
Sygnatura czasowa ustawienia stanu przez aplikację w milisekundach od początku epoki. To pole będzie zawsze widoczne. | |
report.appState[].packageName |
string |
Nazwa pakietu aplikacji. To pole jest zawsze widoczne. | |
report.lastUpdatedTimestampMillis |
long |
Sygnatura czasowa ostatniej aktualizacji raportu w milisekundach od początku epoki. To pole będzie zawsze obecne. | |
retailBrand |
string |
Marka detaliczna 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 czasu wygenerowania ostatniego raportu. Możesz wywoływać tę metodę maksymalnie 3 razy w ciągu 24 godziny dla danego urządzenia.
- pobierz
- Pobiera szczegóły urządzenia.
- getState
- Pobiera informacje o tym, czy dostęp urządzenia do usług Google jest włączony czy wyłączony. Stan urządzenia ma zastosowanie tylko w przypadku egzekwowania zasad EMM na urządzeniach z Androidem. są włączone w konsoli administracyjnej Google. W przeciwnym razie stan urządzenia jest ignorowany, a wszystkie urządzenia mają dostęp do 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 zacznie obowiązywać tylko wtedy, gdy w konsoli administracyjnej Google włączone jest 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 uzyskać dostęp. do usług Google. Ta funkcja jest obsługiwana tylko w przypadku użytkowników zarządzanych przez Google.
- update
- Aktualizuje zasady urządzenia.
Aby zapewnić prawidłowe egzekwowanie zasad, musisz uniemożliwić nienadzorowanym kontom dostęp do Google Play, ustawiając wartośćallowed_accounts
w konfiguracji zarządzanej pakietu Google Play. Zobacz ograniczenie w Google Play.