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 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 interne Hardware-Codename des Geräts. Diese Quelle ist `android.os.Build.DEVICE`. (Feld namens „device“ in Logs/wireless/android/android_checkin.proto)
`kind`	`string`
`latestBuildFingerprint`	`string`	Build-Fingerabdruck des Geräts, falls bekannt.
`maker`	`string`	Der Hersteller des Geräts. Diese Quelle ist `android.os.Build.MANUFACTURER`.
`managementType`	`string`	Gibt an, in welchem Umfang das Gerät von einem Managed Google Play-EMM in verschiedenen Bereitstellungskonfigurationen gesteuert wird. Mögliche Werte sind: „`managedDevice`“, ein Gerät, auf dem der Device Policy Controller (DPC) des EMM als Geräteeigentümer festgelegt ist. „`managedProfile`“, ein Gerät mit einem vom DPC verwalteten Profil (DPC ist der Profilinhaber) und zusätzlich zu einem separaten, persönlichen Profil, das für den DPC nicht verfügbar ist. „`containerApp`“ wird nicht mehr verwendet (eingestellt). „`unmanagedProfile`“, ein Gerät, das Managed Google Play verwenden darf, das jedoch keinem DPC gehört, wurde vom Administrator der Domain über die Admin-Konsole aktiviert. Zulässige Werte sind: „`containerApp`“ „`managedDevice`“ „`managedProfile`“ „`unmanagedProfile`“
`model`	`string`	Der Modellname des Geräts. Diese Quelle ist `android.os.Build.MODEL`.
`policy`	`nested object`	Die auf dem Gerät erzwungene Richtlinie.
`policy.autoUpdatePolicy`	`string`	Damit wird festgelegt, wann automatische App-Updates auf dem Gerät installiert 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` gesetzt ist, hat `autoUpdatePolicy` keine Auswirkungen. "choiceToTheUser" ermöglicht es dem Gerätenutzer, die Richtlinie für App-Updates zu konfigurieren. „immer“ aktiviert automatische Updates. „Nie“ deaktiviert automatische Updates. „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 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 (einschließlich) liegen.
`policy.maintenanceWindow.startTimeAfterMidnightMs`	`long`	Beginn des Wartungsfensters auf dem Gerät in Millisekunden nach Mitternacht. Fenster können sich über Mitternacht erstrecken.
`policy.productAvailabilityPolicy`	`string`	Die Verfügbarkeit, die dem Gerät für die angegebenen Produkte gewährt wurde. "alle" gewährt dem Gerät unabhängig vom Genehmigungsstatus Zugriff auf alle Produkte. "alle" aktiviert die automatische Sichtbarkeit von „Alpha“ nicht oder „Beta“ Titel. „weiße Liste“ gewährt dem Gerät Zugriff auf die in der productPolicy[] angegebenen Produkte. Nur Produkte, die vom Unternehmen genehmigt wurden oder die zuvor vom Unternehmen genehmigt wurden (also Produkte mit aufgehobener Genehmigung), können auf die weiße Liste gesetzt werden. Wenn Sie keinen Wert angeben, wird standardmäßig die auf Nutzerebene festgelegte Verfügbarkeit angewendet. Zulässige Werte sind: „`all`“ „`whitelist`“
`policy.productPolicy[]`	`list`	Die Liste der Produktrichtlinien. Die `productAvailabilityPolicy` muss auf `WHITELIST` oder `ALL` festgelegt 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`	Beschränkung für den Ladestatus. Zulässige Werte sind: „`chargingNotRequired`“ „`chargingRequired`“
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint`	`string`	Beschrä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 automatische Installationsmodus. Wenn nichts 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. Eine niedrigere Zahl bedeutet eine höhere Priorität.
`policy.productPolicy[].autoInstallPolicy.minimumVersionCode`	`integer`	Die Mindestversion der App. Wenn eine niedrigere Version der App installiert wird, wird die App gemäß den Einschränkungen für die automatische Installation automatisch aktualisiert, anstatt auf die reguläre automatische Aktualisierung 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 automatische Updatemodus 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-Anwendung eines Identitätsanbieters. So kann die Authentifizierungs-App des Identitätsanbieters während der Authentifizierung in einer privaten App mit Android WebView gestartet werden. 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 wird.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder`	`string`	den Platzhalterstring von EMM definiert wurde.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue`	`string`	Der nutzerspezifische Wert des Platzhalters.
`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 die Eigenschaft identifiziert.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBool`	`boolean`	Der boolesche Wert. Er ist nur vorhanden, wenn der Typ der Eigenschaft "bool" ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle`	`nested object`	Das Bundle verwalteter Properties. Dies ist nur vorhanden, wenn der Property-Typ „Bundle“ ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]`	`list`	Die Liste der verwalteten Properties.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]`	`list`	Die Liste der Eigenschaften-Sets. Diese ist nur vorhanden, wenn der Typ der Eigenschaft Bundle_array ist.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]`	`list`	Die Liste der verwalteten Properties.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger`	`integer`	Der ganzzahlige Wert. Dieser 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 der Eigenschaft die Mehrfachauswahl ist.
`policy.productPolicy[].managedConfiguration.productId`	`string`	Die ID des Produkts, für das die verwaltete Konfiguration bestimmt 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(mit `trackIds` identifiziert). 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 verschlüsselten App-Status. 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, wofür die App einen Status bereitstellt. Der Inhalt des Schlüssels wird vom App-Entwickler 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`	Freies Format, für Menschen lesbare Nachricht, die den App-Status beschreibt. Dies kann beispielsweise eine Fehlermeldung sein. Entfernen Sie zur Vermeidung von XSS jeglichen HTML-Code aus der Nachricht, bevor Sie sie anzeigen.
`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 in Millisekunden für den Zeitpunkt, zu dem die App den Status seit der 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 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: Lädt einen Bericht mit allen Änderungen am App-Status auf dem Gerät hoch der letzte Bericht generiert wurde. Sie können diese Methode bis zu dreimal pro 24 Stunden für ein bestimmtes Gerät.
get: Ruft die Details eines Geräts ab.
getState: Ruft ab, ob der Zugriff eines Geräts auf Google-Dienste aktiviert ist deaktiviert. Der Gerätestatus wird nur wirksam, wenn EMM-Richtlinien unter Android erzwungen werden Geräte in der Admin-Konsole aktiviert. Andernfalls wird der Gerätestatus ignoriert und alle Geräte haben Zugriff zu Google-Diensten. Diese Option wird nur für Nutzer unterstützt, die von Google verwaltet werden.
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 EMM-Richtlinien unter Android erzwungen werden Geräte in der Admin-Konsole aktiviert. Andernfalls wird der Gerätestatus ignoriert und alle Geräte haben Zugriff zu Google-Diensten. Diese Option wird nur für Nutzer unterstützt, die von Google verwaltet werden.
Update: Aktualisiert die Geräterichtlinie.

Damit die Richtlinie korrekt erzwungen wird, müssen Sie verhindern, dass nicht verwaltete auf Google Play zugreifen können, indem Sie die allowed_accounts in der verwalteten Konfiguration für das Google Play-Paket Siehe restricte Konten bei Google Play.