Devices

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 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” w pliku logs/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 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” – 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 Zasada stosowana 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 Określa, czy urządzenie zgłasza stany aplikacji do EMM. 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. 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ść 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 zasady dotyczące produktów mogły być stosowane, wartość productAvailabilityPolicy musi wynosić 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:
  • „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:
  • „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ę. Minimalny kod wersji możesz ustawić dla maksymalnie 20 aplikacji na urządzenie.
policy.productPolicy[].autoUpdateMode string Tryb automatycznej aktualizacji produktu. Gdy używana jest wartość autoUpdateMode, ma ona 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:
  • „autoUpdateDefault”
  • „autoUpdateHighPriority”
  • „autoUpdatePostponed”
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 uwierzytelniająca powinna być już domyślnym elementem obsługującym adres 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 Wartość obiektu zastępczego, która jest specyficzna dla danego użytkownika.
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 usług – będzie obecna tylko wtedy, gdy typ usługi to bundle_array.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] list Lista zarządzanych usług.
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 produktu, dla którego ma być używana 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. Zamiast tego użyj trackIds.
product string Nazwa urządzenia. To jest 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, dla czego aplikacja udostępnia stan. Treść klucza jest ustawiana przez dewelopera aplikacji. Aby zapobiec XSS, zalecamy usunięcie z klucza wszelkich elementów HTML przed jego wyświetleniem. To pole będzie zawsze widoczne.
report.appState[].keyedAppState[].message string Zrozumiały dla człowieka ciąg tekstowy 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 widoczne.

Akceptowane wartości:
  • „severityError”
  • „severityInfo”
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 widoczne.
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. W przypadku danego urządzenia możesz wywołać tę metodę maksymalnie 3 razy na 24 godziny.
get
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 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.
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. Zapoznaj się z informacjami o ograniczaniu dostępu do kont w Google Play.