Devices: setState

Legt fest, ob der Zugriff eines Geräts auf Google-Dienste aktiviert oder deaktiviert ist. Der Gerätestatus wird nur dann wirksam, wenn in der Admin-Konsole EMM-Richtlinien auf Android-Geräten erzwungen werden. Andernfalls wird der Gerätestatus ignoriert und alle Geräte haben Zugriff auf Google-Dienste. Dies wird nur für von Google verwaltete Nutzer unterstützt.

Anfragen

HTTP-Anfrage

PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state

Parameter

Parametername Wert Beschreibung
Pfadparameter
deviceId string Die ID des Geräts.
enterpriseId string Die ID des Unternehmens.
userId string Die ID des Nutzers.

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Umfang erforderlich:

Umfang
https://www.googleapis.com/auth/androidenterprise

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext Daten mit der folgenden Struktur ein:

{
  "kind": "androidenterprise#deviceState",
  "accountState": string
}
Attributname Wert Beschreibung Hinweise
accountState string Der Status des Google-Kontos auf dem Gerät. „aktiviert“ gibt an, dass mit dem Google-Konto auf dem Gerät auf Google-Dienste (einschließlich Google Play) zugegriffen werden kann. „Deaktiviert“ bedeutet, dass dies nicht möglich ist. Ein neues Gerät ist anfangs deaktiviert.

Folgende Werte sind zulässig:
  • disabled
  • enabled
kind string

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "androidenterprise#deviceState",
  "accountState": string
}
Name der Eigenschaft Wert Beschreibung Hinweise
accountState string Der Status des Google-Kontos auf dem Gerät. „aktiviert“ gibt an, dass mit dem Google-Konto auf dem Gerät auf Google-Dienste (einschließlich Google Play) zugegriffen werden kann. „Deaktiviert“ bedeutet, dass dies nicht möglich ist. Ein neues Gerät ist anfangs deaktiviert.

Folgende Werte sind zulässig:
  • disabled
  • enabled
kind string