Devices

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Prezentacje 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,
    "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 Usług Google Play dla urządzenia zakodowany jako ciąg szesnastkowy w małej literze. 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, w jakim stopniu urządzenie jest kontrolowane przez zarządzaną usługę EMM Google Play w różnych konfiguracjach wdrożenia.

Możliwe wartości:
  • „managedDevice”, urządzenie, które ma kontroler zasad dotyczących urządzeń EMM (DPC) jako właściciela urządzenia.
  • „managedProfile”, urządzenie z profilem zarządzanym przez DPC (DPC jest właścicielem profilu) oraz dodatkowym profilem osobistym, który jest niedostępny dla DPC.
  • „containerApp” – nie jest już używany (wycofany).
  • „unmanagedProfile”, czyli urządzenie, które ma zezwolenie (przyznane przez administratora domeny za pomocą konsoli administracyjnej) na korzystanie z zarządzanego Google Play, ale nie jest własnością DPC.


Akceptowane wartości:
  • „containerApp”
  • „managedDevice”
  • „managedProfile”
  • „unmanagedProfile”
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 można stosować automatyczne aktualizacje aplikacji na urządzeniu.

Zalecane rozwiązanie alternatywne: autoUpdateMode, które jest ustawiane 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.
  • always włącza automatyczne aktualizacje.
  • never wyłącza automatyczne aktualizacje.
  • wifiOnly włącza automatyczne aktualizacje tylko wtedy, gdy urządzenie jest połączone z Wi-Fi.


Akceptowane wartości:
  • „always”
  • „choiceToTheUser”
  • „never”
  • „wifiOnly”
policy.deviceReportPolicy string Czy urządzenie przekazuje do usług EMM stany aplikacji. Wartość domyślna to „deviceReportDisabled”.

Akceptowane wartości:
  • „deviceReportDisabled”
  • „deviceReportEnabled”
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 Czas rozpoczęcia okresu konserwacji w milisekundach od północy na urządzeniu. Windows może 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ść przyznana urządzeniu dla określonych produktów. „Wszystkie” daje urządzeniu dostęp do wszystkich usług niezależnie od stanu zatwierdzenia. Ustawienie „all” nie powoduje automatycznego włączenia widoczności ścieżek „alpha” ani „beta”. „whitelist” (lista dozwolonych) przyznaje urządzeniu dostęp do produktów określonych w productPolicy[]. Na liście dozwolonych mogą się znajdować tylko produkty, które zostały zatwierdzone lub które zostały wcześniej zatwierdzone przez firmę (produkty z cofniętym zatwierdzeniem). Jeśli nie podasz żadnej wartości, domyślnie zostanie zastosowana dostępność ustawiona na poziomie użytkownika.

Akceptowane wartości:
  • „all”
  • „whitelist”
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:
  • „chargingNotRequired”
  • „chargingRequired”
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint string Ograniczenie stanu bezczynności urządzenia.

Akceptowane wartości:
  • „deviceIdleNotRequired”
  • „deviceIdleRequired”
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint string Ograniczenie typu sieci.

Akceptowane wartości to:
  • „anyNetwork”
  • „unmeteredNetwork”
policy.productPolicy[].autoInstallPolicy.autoInstallMode string Tryb automatycznego instalowania. Jeśli nie jest ustawiony, przyjmuje domyślnie wartość „doNotAutoInstall”. Aplikacja jest instalowana automatycznie niezależnie od ustawionego okna konserwacji.

Akceptowane wartości to:
  • „autoInstallOnce”
  • „doNotAutoInstall”
  • „forceAutoInstall”
policy.productPolicy[].autoInstallPolicy.autoInstallPriority integer Priorytet instalacji podany jako niepodpisana liczba całkowita. 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 zaktualizowana automatycznie zgodnie z ograniczeniami automatycznej instalacji, zamiast czekać na regularną automatyczną aktualizację. Możesz ustawić minimalny kod wersji dla maksymalnie 20 aplikacji na urządzenie.
policy.productPolicy[].autoUpdateMode string Tryb automatycznej aktualizacji produktu. Gdy używana jest opcja autoUpdateMode, ma ona zawsze pierwszeństwo przed wyborem użytkownika. Gdy użytkownik wprowadzi zmiany w ustawieniach urządzenia ręcznie, zostaną one zignorowane.

Akceptowane wartości:
  • „autoUpdateDefault”
  • „autoUpdateHighPriority”
  • „autoUpdatePostponed”
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] list Konfiguracja adresu URL uwierzytelniania dla aplikacji uwierzytelniającej dostawcy tożsamości. Pomaga to uruchamiać aplikację uwierzytelniającą dostawcy tożsamości podczas uwierzytelniania w aplikacji prywatnej z wykorzystaniem komponentu WebView Androida. Aplikacja uwierzytelniająca powinna być już domyślnym elementem 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ądzanej.
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ępczych zdefiniowany przez EMM.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue string Specyficzna dla użytkownika wartość zmiennej.
policy.productPolicy[].managedConfiguration.kind string Wycofane.

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 typ usługi to „pakiet”.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] list Lista zarządzanych usług.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] list Lista pakietów właściwości – będzie widoczna tylko wtedy, gdy typem właściwości jest 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 obecna tylko wtedy, gdy typ właściwości to liczba całkowita.
policy.productPolicy[].managedConfiguration.managedProperty[].valueString string Wartość ciągu znaków – będzie obecna tylko wtedy, gdy typ właściwości to ciąg znaków, wybór lub ukryty.
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] list Lista wartości ciągu znaków – będzie widoczna tylko wtedy, gdy typ właściwości to „wieloznaczny”.
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 Daje widoczność urządzenia na określonych ścieżkach wersji usługi identyfikowanych przez trackIds. Listę ścieżek wersji produktu można uzyskać, wywołując funkcję Products.Get.
policy.productPolicy[].tracks[] list Rola wycofana. Zamiast tego użyj pola 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 kluczami. To pole będzie zawsze widoczne.
report.appState[].keyedAppState[].data string Dodatkowe pole przeznaczone do danych zrozumiałych dla komputerów. Może to być 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 wszelkich elementów HTML przed jego wyświetleniem. To pole będzie zawsze obecne.
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 z wiadomości wszelkich tagów HTML przed jej wyświetleniem.
report.appState[].keyedAppState[].severity string Poważne naruszenie stanu aplikacji. To pole będzie zawsze obecne.

Akceptowane wartości:
  • „severityError”
  • „severityInfo”
report.appState[].keyedAppState[].stateTimestampMillis long Sygnatura czasowa momentu, w którym aplikacja ustawiła stan (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 widoczne.
retailBrand string Marka detaliczna urządzenia (jeśli została określona). Zobacz android.os.Build.BRAND
sdkVersion integer Wersja zgodności interfejsu API.

Metody

forceReportUpload
Przesyła raport zawierający wszystkie zmiany stanu aplikacji na urządzeniu od czasu wygenerowania ostatniego raportu. W przypadku danego urządzenia możesz wywołać tę metodę maksymalnie 3 razy na 24 godziny.
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 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 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 działa tylko wtedy, gdy w konsoli administracyjnej Google jest włączone egzekwowanie zasad EMM na urządzeniach z Androidem. 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.
zaktualizuj
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 ograniczenia na kontach w Google Play.