Ważne: nie przyjmujemy już nowych rejestracji w interfejsie Play EMM API. Więcej informacji

Ta strona została przetłumaczona przez Cloud Translation API.

Devices

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

Reprezentacje 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
`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ętrzny kryptonim sprzętowy urządzenia. Wynik pochodzi 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. Wynik pochodzi 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. Projekt „`containerApp`” nie jest już używany (wycofano). „`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. Wynik pochodzi 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óry jest ustawiany dla poszczególnych 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 efektu. "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`	Czy urządzenie przekazuje do usług EMM stany aplikacji. Wartość domyślna to „deviceReportDisabled”. Akceptowane wartości to: „`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`	Godzina rozpoczęcia okresu konserwacji na urządzeniu (w milisekundach po północy). Windows może obejmować północ.
`policy.productAvailabilityPolicy`	`string`	Dostępność określonych produktów przypisana do urządzenia. „wszystko” umożliwia urządzeniu dostęp do wszystkich produktów 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 można było zastosować zasady dotyczące produktów, `productAvailabilityPolicy` musi mieć wartość `WHITELIST` lub `ALL`.
`policy.productPolicy[].autoInstallPolicy`	`nested object`	Zasady automatycznej instalacji produktu.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]`	`list`	Ograniczenia związane z automatycznym instalowaniem 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 zasada jest nieskonfigurowana, domyślna wartość to „doNotAutoInstall”. Aplikacja jest instalowana automatycznie niezależnie od ustawionego okresu konserwacji. Akceptowane wartości to: „`autoInstallOnce`” „`doNotAutoInstall`” „`forceAutoInstall`”
`policy.productPolicy[].autoInstallPolicy.autoInstallPriority`	`integer`	Priorytet instalacji w postaci liczby całkowitej bez znaku. Niższa liczba oznacza 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. Gdy użytkownik wprowadzi zmiany w ustawieniach urządzenia ręcznie, zostaną one zignorowane. Akceptowane wartości to: „`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 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 oraz zbiór 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`	Zestaw 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`	Specyficzna dla użytkownika wartość zmiennej.
`policy.productPolicy[].managedConfiguration.kind`	`string`	Wycofano.
`policy.productPolicy[].managedConfiguration.managedProperty[]`	`list`	Zbiór usług zarządzanych dla tej konfiguracji.
`policy.productPolicy[].managedConfiguration.managedProperty[].key`	`string`	Unikalny klucz identyfikujący usługę.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBool`	`boolean`	Wartość logiczna – występuje tylko wtedy, gdy typem właściwości jest wartość logiczna.
`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 usług zarządzanych.
`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 – 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`	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 metodę Products.Get.
`policy.productPolicy[].tracks[]`	`list`	Rola wycofana. Użyj w zamian zasady `trackIds`.
`product`	`string`	Nazwa produktu urządzenia. Wynik pochodzi 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 deweloperów aplikacji. To pole będzie zawsze obecne.
`report.appState[].keyedAppState[]`	`list`	Lista stanów aplikacji z kluczem. To pole będzie zawsze 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 z danych kodu HTML przed jego wyświetleniem.
`report.appState[].keyedAppState[].key`	`string`	Klucz wskazujący, do czego aplikacja dostarcza stan. Zawartość klucza jest określana przez dewelopera aplikacji. Aby zapobiec atakom XSS, zalecamy usunięcie z klucza kodu 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 kodu HTML z wiadomości przed jej wyświetleniem.
`report.appState[].keyedAppState[].severity`	`string`	Waga stanu aplikacji. To pole będzie zawsze obecne. Akceptowane wartości to: „`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 obecne.
`report.appState[].packageName`	`string`	Nazwa pakietu aplikacji. To pole będzie zawsze obecne.
`report.lastUpdatedTimestampMillis`	`long`	Sygnatura czasowa ostatniej aktualizacji raportu wyrażona 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 wszelkie zmiany stanu aplikacji na urządzeniu od za pomocą którego wygenerowano ostatni raport. 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: Sprawdza, czy dostęp urządzenia do usług Google jest włączony lub wyłączono. 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 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.
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 w przypadku egzekwowania zasad EMM na urządzeniach z Androidem. są włączone w konsoli administracyjnej Google. 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.
zaktualizuj: Aktualizuje zasady dotyczące urządzeń.

Aby mieć pewność, że zasada jest prawidłowo egzekwowana, musisz uniemożliwić dostępu do Google Play przez ustawienie allowed_accounts w konfiguracji zarządzanej dla Google Odtwórz pakiet. Zobacz ograniczenie w Google Play.