Devices: setState
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hiermit wird festgelegt, 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.
Anfrage
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 mit folgendem Bereich 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
}
| Name der Eigenschaft |
Wert |
Beschreibung |
Hinweise |
accountState |
string |
Der Status des Google-Kontos auf dem Gerät. "aktiviert" gibt an, dass das Google-Konto auf dem Gerät für den Zugriff auf Google-Dienste (einschließlich Google Play) verwendet werden kann, während es „deaktiviert“ ist bedeutet, dass dies nicht möglich ist. Ein neues Gerät befindet sich anfangs „deaktiviert“ Bundesstaat.
Zulässige Werte sind:
|
|
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 das Google-Konto auf dem Gerät für den Zugriff auf Google-Dienste (einschließlich Google Play) verwendet werden kann, während es „deaktiviert“ ist bedeutet, dass dies nicht möglich ist. Ein neues Gerät befindet sich anfangs „deaktiviert“ Bundesstaat.
Zulässige Werte sind:
|
|
kind |
string |
|
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-09-12 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-09-12 (UTC)."],[[["\u003cp\u003eEnables or disables a device's access to Google services for Google-managed users.\u003c/p\u003e\n"],["\u003cp\u003eDevice state enforcement requires enabling EMM policies in the Google Admin Console.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a PUT request to update the device state to either "enabled" or "disabled".\u003c/p\u003e\n"]]],[],null,["# Devices: setState\n\n| **Note:** Requires [authorization](#auth).\n\nSets whether a device's access to Google services is enabled or disabled.\nThe device state takes effect only if enforcing EMM policies on Android\ndevices is enabled in the Google Admin Console.\nOtherwise, the device state is ignored and all devices are allowed access\nto Google services.\nThis is only supported for Google-managed users.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `deviceId` | `string` | The ID of the device. |\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| `userId` | `string` | The ID of the user. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#deviceState\",\n \"accountState\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `accountState` | `string` | The state of the Google account on the device. \"enabled\" indicates that the Google account on the device can be used to access Google services (including Google Play), while \"disabled\" means that it cannot. A new device is initially in the \"disabled\" state. \u003cbr /\u003e Acceptable values are: - \"`disabled`\" - \"`enabled`\" | |\n| `kind` | `string` | | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#deviceState\",\n \"accountState\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `accountState` | `string` | The state of the Google account on the device. \"enabled\" indicates that the Google account on the device can be used to access Google services (including Google Play), while \"disabled\" means that it cannot. A new device is initially in the \"disabled\" state. \u003cbr /\u003e Acceptable values are: - \"`disabled`\" - \"`enabled`\" | |\n| `kind` | `string` | | |"]]
