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 Hinweise
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 namens „device“ in 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 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“ ist ein Gerät mit einem vom DPC verwalteten Profil (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 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 Informationen stammen von 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.

Mit „choiceToTheUser“ kann der Nutzer des Geräts die Richtlinie für App-Updates 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 liegen.
policy.maintenanceWindow.startTimeAfterMidnightMs long Beginn des Wartungsfensters auf dem Gerät in Millisekunden nach Mitternacht. Zeitfenster können Mitternacht umfassen.
policy.policyId string Eine Kennung für die Richtlinie, die mit dem vom Play Store gesendeten Feedback zur App-Installation übergeben 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. „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 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 Netzwerktypeinschränkung.

Zulässige Werte sind:
  • anyNetwork
  • unmeteredNetwork
policy.productPolicy[].autoInstallPolicy.autoInstallMode string Der Modus „Automatische Installation“. Wenn nicht festgelegt, ist der Standardwert „doNotAutoInstall“. 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 eine positive 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 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 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 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 Authentifizierungs-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 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 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. Dieser ist nur vorhanden, wenn der Typ der Property „bool“ ist.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle nested object Das Bundle verwalteter Properties. Dieses 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 Ganzzahlwert. Dieser Wert ist nur vorhanden, wenn der Typ der Property „integer“ 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 Meldung stammt von 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 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
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
Gibt zurück, ob der Zugriff eines Geräts auf Google-Dienste aktiviert oder deaktiviert ist. Der Gerätestatus tritt nur in Kraft, wenn die Erzwingung von EMM-Richtlinien auf Android-Geräten in der Admin-Konsole aktiviert ist. Andernfalls wird der Gerätestatus ignoriert und alle Geräte haben Zugriff zu Google-Diensten. 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 wird nur wirksam, wenn EMM-Richtlinien unter Android erzwungen werden Geräte in der Admin-Konsole aktiviert. 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.
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.