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 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:
  • managedDevice” – urządzenie, którego właścicielem jest kontroler zasad dotyczących urządzeń (DPC) dostawcy usług EMM.
  • managedProfile” – urządzenie z profilem zarządzanym przez DPC (DPC jest właścicielem profilu) oprócz osobnego, osobistego profilu, który jest niedostępny dla DPC.
  • containerApp” – nie jest już używany (wycofany).
  • unmanagedProfile” – urządzenie, na którym administrator domeny włączył te uprawnienia przy użyciu konsoli administracyjnej, ale profil sam w sobie nie należy do 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 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:
  • 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, 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:
  • 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 to:
  • chargingNotRequired
  • chargingRequired
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint string Ograniczenie stanu bezczynności urządzenia.

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

Akceptowane wartości to:
  • anyNetwork
  • unmeteredNetwork
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:
  • autoInstallOnce
  • doNotAutoInstall
  • forceAutoInstall
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:
  • 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 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:
  • 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 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.