Wichtig:Wir akzeptieren keine neuen Registrierungen für die Play EMM API mehr. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

Devices

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Eine Geräteressource stellt ein Mobilgerät dar, das vom EMM verwaltet wird und einem bestimmten Nutzer des Unternehmens gehört.

{
  "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
}

Property-Name	Wert	Beschreibung
`androidId`	`string`	Die Android-ID der Google Play-Dienste für das Gerät, codiert als Hexadezimalstring in Kleinbuchstaben. Beispiel: `"123456789abcdef0"`.
`device`	`string`	Der interne Hardware-Codename des Geräts. Diese Meldung stammt von `android.os.Build.DEVICE`. (Feld „device“ gemäß logs/wireless/android/android_checkin.proto)
`kind`	`string`
`latestBuildFingerprint`	`string`	Der Build-Fingerprint des Geräts, falls bekannt.
`maker`	`string`	Der Hersteller des Geräts. Diese Meldung stammt von `android.os.Build.MANUFACTURER`.
`managementType`	`string`	Gibt an, inwieweit das Gerät in verschiedenen Bereitstellungskonfigurationen von einem verwalteten Google Play EMM gesteuert wird. Mögliche Werte: „`managedDevice`“, ein Gerät, bei dem der Device Policy Controller (DPC) des EMM als Geräteinhaber festgelegt ist. „`managedProfile`“ ist ein Gerät mit einem Profil, das vom DPC verwaltet wird (DPC ist Profilinhaber), sowie einem separaten privaten Profil, das für den DPC nicht verfügbar ist. „`containerApp`“, wird nicht mehr verwendet (veraltet). „`unmanagedProfile`“: Ein Gerät, das vom Administrator der Domain über die Admin-Konsole die Berechtigung zur Nutzung von Managed Google Play erhalten hat, aber dessen Profil nicht dem DPC gehört. Zulässige Werte sind: „`containerApp`“ „`managedDevice`“ „`managedProfile`“ „`unmanagedProfile`“
`model`	`string`	Der Modellname des Geräts. Diese Informationen stammen von `android.os.Build.MODEL`.
`policy`	`nested object`	Die auf dem Gerät erzwungene Richtlinie.
`policy.autoUpdatePolicy`	`string`	Hiermit wird festgelegt, wann automatische App-Updates auf dem Gerät angewendet werden können. Empfohlene Alternative: `autoUpdateMode`. Diese wird für jede App festgelegt und bietet mehr Flexibilität bei der Aktualisierungshäufigkeit. Wenn `autoUpdateMode` auf `AUTO_UPDATE_POSTPONED` oder `AUTO_UPDATE_HIGH_PRIORITY` festgelegt ist, hat `autoUpdatePolicy` keine Auswirkungen. Auf `choiceToTheUser` kann der Nutzer die Richtlinie für App-Updates konfigurieren. `always` aktiviert automatische Updates. `never` deaktiviert automatische Updates. `wifiOnly` Aktiviert automatische Updates nur, wenn das Gerät mit einem WLAN verbunden ist. Wichtig:Änderungen an den Richtlinien für App-Updates haben keine Auswirkungen auf laufende Updates. Alle Richtlinienänderungen gelten für nachfolgende App-Updates. Zulässige Werte sind: „`always`“ „`choiceToTheUser`“ „`never`“ „`wifiOnly`“
`policy.deviceReportPolicy`	`string`	Gibt an, ob das Gerät die App-Status an den EMM-Anbieter meldet. Der Standardwert ist „deviceReportDisabled“. Zulässige Werte sind: „`deviceReportDisabled`“ „`deviceReportEnabled`“
`policy.maintenanceWindow`	`nested object`	Das Wartungsfenster, über das festgelegt wird, wann im Vordergrund ausgeführte Apps festgelegt werden, sollte aktualisiert werden.
`policy.maintenanceWindow.durationMs`	`long`	Dauer des Wartungsfensters in Millisekunden. Die Dauer muss zwischen 30 Minuten und 24 Stunden liegen.
`policy.maintenanceWindow.startTimeAfterMidnightMs`	`long`	Beginn des Wartungsfensters in Millisekunden nach Mitternacht auf dem Gerät. Zeitfenster können Mitternacht umfassen.
`policy.policyId`	`string`	Eine Kennung für die Richtlinie, die mit dem Feedback zur App-Installation übergeben wird, das vom Play Store gesendet wird.
`policy.productAvailabilityPolicy`	`string`	Die Verfügbarkeit, die dem Gerät für die angegebenen Produkte gewährt wurde. Mit „alle“ erhält das Gerät Zugriff auf alle Produkte, unabhängig vom Genehmigungsstatus. Mit „alle“ wird die automatische Sichtbarkeit von „Alpha“- oder „Beta“-Tracks nicht aktiviert. „whitelist“ gewährt dem Gerät Zugriff auf die in „productPolicy[]“ angegebenen Produkte. Nur Produkte, die vom Unternehmen genehmigt wurden oder zuvor genehmigt wurden (Produkte mit widerrufener Genehmigung), können auf die Zulassungsliste gesetzt werden. Wenn kein Wert angegeben ist, wird standardmäßig die auf Nutzerebene festgelegte Verfügbarkeit angewendet. Zulässige Werte sind: „`all`“ „`whitelist`“
`policy.productPolicy[]`	`list`	Die Liste der Produktrichtlinien. `productAvailabilityPolicy` muss auf `WHITELIST` oder `ALL` gesetzt sein, damit die Produktrichtlinien angewendet werden.
`policy.productPolicy[].autoInstallPolicy`	`nested object`	Die Richtlinie für die automatische Installation des Produkts.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]`	`list`	Die Einschränkungen für die automatische Installation der App. Sie können maximal eine Einschränkung angeben.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint`	`string`	Einschränkung für den Ladestatus Zulässige Werte sind: „`chargingNotRequired`“ „`chargingRequired`“
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint`	`string`	Einschränkung für den Inaktivitätsstatus des Geräts Zulässige Werte sind: „`deviceIdleNotRequired`“ „`deviceIdleRequired`“
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint`	`string`	Einschränkung des Netzwerktyps Zulässige Werte sind: „`anyNetwork`“ „`unmeteredNetwork`“
`policy.productPolicy[].autoInstallPolicy.autoInstallMode`	`string`	Der Modus „Automatische Installation“. Wenn nichts festgelegt ist, wird standardmäßig „doNotAutoInstall“ verwendet. Eine App wird unabhängig von einem festgelegten Wartungszeitraum automatisch installiert. Zulässige Werte sind: „`autoInstallOnce`“ „`doNotAutoInstall`“ „`forceAutoInstall`“
`policy.productPolicy[].autoInstallPolicy.autoInstallPriority`	`integer`	Die Priorität der Installation als vorzeichenlose Ganzzahl. Je niedriger die Zahl, desto höher die Priorität.
`policy.productPolicy[].autoInstallPolicy.minimumVersionCode`	`integer`	Die älteste Version der App. Wenn eine niedrigere Version der App installiert ist, wird die App gemäß den Einschränkungen für die automatische Installation automatisch aktualisiert, anstatt auf das reguläre automatische Update zu warten. Sie können einen Code für die Mindestversion für maximal 20 Apps pro Gerät festlegen.
`policy.productPolicy[].autoUpdateMode`	`string`	Der Modus für automatische Updates für das Produkt. Wenn `autoUpdateMode` verwendet wird, hat es immer Vorrang vor der Auswahl des Nutzers. Wenn ein Nutzer also manuell Änderungen an den Geräteeinstellungen vornimmt, werden diese Änderungen ignoriert. Zulässige Werte sind: „`autoUpdateDefault`“ „`autoUpdateHighPriority`“ „`autoUpdatePostponed`“
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]`	`list`	Eine Authentifizierungs-URL-Konfiguration für die Authentifizierungs-App eines Identitätsanbieters. So wird die Authentifizierungs-App des Identitätsanbieters während der Authentifizierung in einer privaten App mit Android WebView gestartet. Die Authenticator-App sollte bereits als Standard-Handler für die Authentifizierungs-URL auf dem Gerät festgelegt sein.
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri`	`string`	Eine Authentifizierungs-URL.
`policy.productPolicy[].managedConfiguration`	`nested object`	Die verwaltete Konfiguration für das Produkt.
`policy.productPolicy[].managedConfiguration.configurationVariables`	`nested object`	Enthält die ID des verwalteten Konfigurationsprofils und die für den Nutzer definierten Konfigurationsvariablen (falls vorhanden).
`policy.productPolicy[].managedConfiguration.configurationVariables.kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.mcmId`	`string`	Die ID der Einstellungen für verwaltete Konfigurationen.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]`	`list`	Der Variablensatz, der dem Nutzer zugeordnet ist.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder`	`string`	Der Platzhalterstring, definiert vom EMM.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue`	`string`	Der nutzerspezifische Wert des Platzhalters.
`policy.productPolicy[].managedConfiguration.kind`	`string`	Veraltet.
`policy.productPolicy[].managedConfiguration.managedProperty[]`	`list`	Die verwalteten Properties für diese Konfiguration.
`policy.productPolicy[].managedConfiguration.managedProperty[].key`	`string`	Der eindeutige Schlüssel, der die Unterkunft identifiziert.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBool`	`boolean`	Der boolesche Wert. Dieser ist nur vorhanden, wenn der Typ der Property „bool“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle`	`nested object`	Das Paket verwalteter Properties. Dieses Element ist nur vorhanden, wenn der Typ der Property „Paket“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]`	`list`	Die Liste der verwalteten Properties.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]`	`list`	Die Liste der Unterkunftspakete. Diese ist nur vorhanden, wenn der Typ der Property „bundle_array“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]`	`list`	Die Liste der verwalteten Properties.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger`	`integer`	Der Ganzzahlwert. Dieser ist nur vorhanden, wenn der Typ der Property „integer“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueString`	`string`	Der Stringwert. Dieser ist nur vorhanden, wenn der Typ der Property „String“, „Auswahl“ oder „Ausgeblendet“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	Liste der Stringwerte. Diese ist nur vorhanden, wenn der Typ der Property „Mehrfachauswahl“ ist.
`policy.productPolicy[].managedConfiguration.productId`	`string`	Die ID des Produkts, für das die verwaltete Konfiguration gilt, z.B. „app:com.google.android.gm“.
`policy.productPolicy[].productId`	`string`	Die ID des Produkts. Beispiel: `"app:com.google.android.gm"`.
`policy.productPolicy[].trackIds[]`	`list`	Gewährt dem Gerät Sichtbarkeit für die angegebenen Produktveröffentlichungs-Tracks, die durch `trackIds` gekennzeichnet sind. Die Liste der Release-Tracks eines Produkts kann durch Aufrufen von „Products.Get“ abgerufen werden.
`policy.productPolicy[].tracks[]`	`list`	Verworfen. Verwenden Sie stattdessen `trackIds`.
`product`	`string`	Der Produktname des Geräts. Diese Quelle ist `android.os.Build.PRODUCT`.
`report`	`nested object`	Der Gerätebericht wurde mit den neuesten App-Status aktualisiert.
`report.appState[]`	`list`	Liste der App-Status, die von verwalteten Apps auf dem Gerät festgelegt wurden. Der App-Status wird von den Entwicklern der App definiert. Dieses Feld ist immer vorhanden.
`report.appState[].keyedAppState[]`	`list`	Liste der App-Status mit Schlüsseln. Dieses Feld ist immer vorhanden.
`report.appState[].keyedAppState[].data`	`string`	Zusätzliches Feld für maschinenlesbare Daten. Dies kann beispielsweise eine Zahl oder ein JSON-Objekt sein. Zur Vermeidung von XSS empfehlen wir, jeglichen HTML-Code aus den Daten zu entfernen, bevor sie angezeigt werden.
`report.appState[].keyedAppState[].key`	`string`	Schlüssel, der angibt, für was die App einen Status bereitstellt. Der Inhalt des Schlüssels wird vom Entwickler der App festgelegt. Zur Verhinderung von XSS empfehlen wir, HTML-Code aus dem Schlüssel zu entfernen, bevor er angezeigt wird. Dieses Feld ist immer vorhanden.
`report.appState[].keyedAppState[].message`	`string`	Eine für Menschen lesbare Nachricht im freien Format, die den App-Status beschreibt. Zum Beispiel eine Fehlermeldung. Zur Vermeidung von XSS empfehlen wir, jeglichen HTML-Code aus der Nachricht zu entfernen, bevor sie angezeigt wird.
`report.appState[].keyedAppState[].severity`	`string`	Schweregrad des App-Status. Dieses Feld ist immer vorhanden. Zulässige Werte sind: „`severityError`“ „`severityInfo`“
`report.appState[].keyedAppState[].stateTimestampMillis`	`long`	Zeitstempel, zu dem die App den Status festgelegt hat, in Millisekunden seit der Epoche. Dieses Feld ist immer vorhanden.
`report.appState[].packageName`	`string`	Der Paketname der App. Dieses Feld ist immer vorhanden.
`report.lastUpdatedTimestampMillis`	`long`	Der Zeitstempel der letzten Aktualisierung des Berichts in Millisekunden seit der Epoche. Dieses Feld ist immer vorhanden.
`retailBrand`	`string`	Einzelhandelsmarke für das Gerät, falls festgelegt Siehe `android.os.Build.BRAND`
`sdkVersion`	`integer`	API-Kompatibilitätsversion.

Methoden

forceReportUpload: Ladet einen Bericht mit allen Änderungen am App-Status auf dem Gerät seit dem letzten Bericht hoch. Sie können diese Methode für ein bestimmtes Gerät alle 24 Stunden bis zu dreimal aufrufen.
get: Ruft die Details eines Geräts ab.
getState: Ruft ab, ob der Zugriff eines Geräts auf Google-Dienste aktiviert oder deaktiviert ist. Der Gerätestatus tritt nur in Kraft, wenn in der Admin-Konsole die Erzwingung von EMM-Richtlinien auf Android-Geräten aktiviert ist. Andernfalls wird der Gerätestatus ignoriert und allen Geräten wird der Zugriff auf Google-Dienste gewährt. Diese Funktion wird nur für von Google verwaltete Nutzer unterstützt.
list: Ruft die IDs aller Geräte eines Nutzers ab.
setState: Legt fest, ob der Zugriff eines Geräts auf Google-Dienste aktiviert oder deaktiviert ist. Der Gerätestatus tritt nur in Kraft, wenn in der Admin-Konsole die Erzwingung von EMM-Richtlinien auf Android-Geräten aktiviert ist. Andernfalls wird der Gerätestatus ignoriert und allen Geräten wird der Zugriff auf Google-Dienste gewährt. Diese Option wird nur für Nutzer unterstützt, die von Google verwaltet werden.
aktualisieren: Aktualisiert die Geräterichtlinie.

Damit die Richtlinie richtig erzwungen wird, müssen Sie verhindern, dass nicht verwaltete Konten auf Google Play zugreifen. Legen Sie dazu in der verwalteten Konfiguration für das Google Play-Paket die allowed_accounts fest. Weitere Informationen finden Sie unter Konten bei Google Play einschränken.