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 Ressource vom Typ „Geräte“ steht für ein Mobilgerät, das vom EMM verwaltet wird und zu einem bestimmten Unternehmensnutzer 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
  },
  "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 Codename der internen Hardware des Geräts. Diese stammt von `android.os.Build.DEVICE`. (Feld namens „device“ gemäß „logs/wireless/android/android_checkin.proto“)
`kind`	`string`
`latestBuildFingerprint`	`string`	Der Build-Fingerabdruck des Geräts, falls bekannt.
`maker`	`string`	Der Hersteller des Geräts. Diese stammt von `android.os.Build.MANUFACTURER`.
`managementType`	`string`	Gibt an, in welchem Umfang das Gerät in verschiedenen Bereitstellungskonfigurationen von einem Managed Google Play-EMM gesteuert wird. Mögliche Werte sind: „`managedDevice`“: Ein Gerät, auf dem der Device Policy Controller (DPC) des EMM-Anbieters als Geräteinhaber festgelegt ist. „`managedProfile`“, ein Gerät mit einem vom DPC (DPC ist Profilinhaber) verwalteten Profil sowie einem separaten, persönlichen Profil, das für den DPC nicht verfügbar ist. „`containerApp`“, nicht mehr verwendet (eingestellt). „`unmanagedProfile`“: ein Gerät, das vom Administrator der Domain über die Admin-Konsole zur Verwendung von Managed Google Play zugelassen wurde, das Profil selbst aber keinem DPC gehört. Zulässige Werte sind: "`containerApp`" "`managedDevice`" "`managedProfile`" "`unmanagedProfile`"
`model`	`string`	Der Modellname des Geräts. Diese stammt von `android.os.Build.MODEL`.
`policy`	`nested object`	Die auf dem Gerät erzwungene Richtlinie.
`policy.autoUpdatePolicy`	`string`	Mit dieser Einstellung legen Sie fest, wann automatische App-Updates auf dem Gerät installiert werden können. Empfohlene Alternative: `autoUpdateMode` wird pro App festgelegt und bietet mehr Flexibilität bei der Häufigkeit von Updates. Wenn `autoUpdateMode` auf `AUTO_UPDATE_POSTPONED` oder `AUTO_UPDATE_HIGH_PRIORITY` gesetzt ist, hat `autoUpdatePolicy` keine Auswirkungen. Mit „choiceToTheUser“ können Nutzer des Geräts die Richtlinie für App-Updates konfigurieren. „immer“ aktiviert automatische Updates. Mit der Option „Nie“ werden automatische Updates deaktiviert. „wifiOnly“ aktiviert automatische Updates nur, wenn das Gerät mit einem WLAN verbunden ist. Zulässige Werte sind: "`always`" "`choiceToTheUser`" "`never`" "`wifiOnly`"
`policy.deviceReportPolicy`	`string`	Gibt an, ob das Gerät den App-Status an EMM meldet. Der Standardwert ist „deviceReportDisabled“. Zulässige Werte sind: "`deviceReportDisabled`" "`deviceReportEnabled`"
`policy.maintenanceWindow`	`nested object`	Das Wartungsfenster, das definiert, wann im Vordergrund ausgeführte Apps aktualisiert werden sollen.
`policy.maintenanceWindow.durationMs`	`long`	Dauer des Wartungsfensters in Millisekunden. Die Dauer muss zwischen 30 Minuten und 24 Stunden (einschließlich) liegen.
`policy.maintenanceWindow.startTimeAfterMidnightMs`	`long`	Beginn des Wartungsfensters auf dem Gerät in Millisekunden nach Mitternacht. Fenster können bis Mitternacht dauern.
`policy.productAvailabilityPolicy`	`string`	Die Verfügbarkeit, die dem Gerät für die angegebenen Produkte gewährt wird. Mit „all“ erhält das Gerät Zugriff auf alle Produkte, unabhängig vom Genehmigungsstatus. Durch die Einstellung „all“ 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 genehmigte Produkte oder Produkte, die zuvor vom Unternehmen genehmigt wurden (Produkte mit aufgehobener Genehmigung), können auf die Zulassungsliste gesetzt werden. Wenn kein Wert angegeben ist, wird standardmäßig die auf User-Ebene eingestellte 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 zur automatischen Installation des Produkts.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]`	`list`	Die Einschränkungen für die automatische Installation der App. Du kannst maximal eine Einschränkung angeben.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint`	`string`	Ladestatus-Beschränkung. 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`	Netzwerktypeinschränkung. Zulässige Werte sind: "`anyNetwork`" "`unmeteredNetwork`"
`policy.productPolicy[].autoInstallPolicy.autoInstallMode`	`string`	Der Modus für die automatische Installation. Wenn kein Wert festgelegt ist, wird standardmäßig „doNotAutoInstall“ verwendet. Eine Anwendung wird unabhängig von einem festgelegten Wartungsfenster 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 Mindestversion 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 die regelmäßige automatische Aktualisierung zu warten. Sie können einen Mindestversionscode 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 Authenticator-App eines Identitätsanbieters. Dies hilft beim Starten der Authentifizierungs-App des Identitätsanbieters während der Authentifizierung in einer privaten App mit Android WebView. Die Authenticator App sollte bereits der Standard-Handler für die Authentifizierungs-URL auf dem Gerät 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 gegebenenfalls die für den Nutzer definierten Konfigurationsvariablen.
`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 dem Nutzer zugeordnete Variablensatz.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder`	`string`	Der Platzhalterstring; von EMM definiert.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue`	`string`	Der Wert des Platzhalters, spezifisch für den Nutzer.
`policy.productPolicy[].managedConfiguration.kind`	`string`	Eingestellt.
`policy.productPolicy[].managedConfiguration.managedProperty[]`	`list`	Die verwalteten Properties für diese Konfiguration.
`policy.productPolicy[].managedConfiguration.managedProperty[].key`	`string`	Der eindeutige Schlüssel, der das Attribut identifiziert.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBool`	`boolean`	Der boolesche Wert – dieser ist nur vorhanden, wenn der Typ der Eigenschaft „bool“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle`	`nested object`	Das Set verwalteter Properties. Dieses ist nur vorhanden, wenn der Typ der Property „Bundle“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]`	`list`	Die Liste der verwalteten Properties.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]`	`list`	Die Liste der Hotel-Bundles. 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`	Ganzzahlwert: Dieser Wert ist nur vorhanden, wenn der Typ der Eigenschaft eine Ganzzahl ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueString`	`string`	Stringwert: Dieser ist nur vorhanden, wenn der Typ der Eigenschaft „String“, „Auswahl“ oder „Ausgeblendet“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	Die Liste der Stringwerte. Diese ist nur vorhanden, wenn der Typ des Attributs „Mehrfachauswahl“ ist.
`policy.productPolicy[].managedConfiguration.productId`	`string`	Die ID des Produkts, für das die verwaltete Konfiguration vorgesehen ist, 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 die Gerätesichtbarkeit für die angegebenen Produkt-Release-Tracks, identifiziert durch `trackIds`. Die Liste der Release-Tracks eines Produkts kann durch Aufrufen von „Products.Get“ abgerufen werden.
`policy.productPolicy[].tracks[]`	`list`	Veraltet. Verwenden Sie stattdessen `trackIds`.
`product`	`string`	Der Produktname des Geräts. Diese stammt von `android.os.Build.PRODUCT`.
`report`	`nested object`	Der Gerätebericht mit dem aktuellen App-Status wurde 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 verschlüsselten App-Status. Dieses Feld ist immer vorhanden.
`report.appState[].keyedAppState[].data`	`string`	Zusätzliches Feld für maschinenlesbare Daten. Beispiel: eine Zahl oder ein JSON-Objekt. Zur Vermeidung von XSS empfehlen wir, HTML-Code vor der Anzeige aus den Daten zu entfernen.
`report.appState[].keyedAppState[].key`	`string`	Schlüssel, der angibt, wofür die App einen Status bereitstellt. Der Inhalt des Schlüssels wird vom App-Entwickler festgelegt. Um XSS zu verhindern, empfehlen wir, HTML-Code aus dem Schlüssel zu entfernen, bevor er angezeigt wird. Dieses Feld ist immer vorhanden.
`report.appState[].keyedAppState[].message`	`string`	Für Menschen lesbare Nachricht im freien Format, die den App-Status beschreibt. Zum Beispiel eine Fehlermeldung. Zur Vermeidung von XSS empfehlen wir, HTML-Code aus der Nachricht vor dem Anzeigen zu entfernen.
`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, der angibt, wann die Anwendung den Status in Millisekunden seit Epoche festgelegt hat. 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 Berichtsaktualisierung 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: Lädt einen Bericht hoch, der alle Änderungen des App-Status auf dem Gerät seit der letzten Erstellung des Berichts enthält. Sie können diese Methode für ein bestimmtes Gerät bis zu 3-mal alle 24 Stunden aufrufen.
Erhalten: 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 wird nur wirksam, wenn die Erzwingung von EMM-Richtlinien auf Android-Geräten in der Google Admin-Konsole aktiviert ist. Andernfalls wird der Gerätestatus ignoriert und alle Geräte haben Zugriff auf Google-Dienste. Diese Option 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 wird nur wirksam, wenn die Erzwingung von EMM-Richtlinien auf Android-Geräten in der Google Admin-Konsole aktiviert ist. Andernfalls wird der Gerätestatus ignoriert und alle Geräte haben Zugriff auf Google-Dienste. Diese Option wird nur für von Google verwaltete Nutzer unterstützt.
aktualisieren: Aktualisiert die Geräterichtlinie.

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