Ważne: nie przyjmujemy już nowych rejestracji w interfejsie Play EMM API.
Więcej informacji
Devices: setState
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Określa, czy dostęp urządzenia do usług Google jest włączony czy wyłączony.
Stan urządzenia zacznie obowiązywać tylko wtedy, gdy w konsoli administracyjnej Google włączone jest egzekwowanie zasad EMM na urządzeniach z Androidem.
W przeciwnym razie stan urządzenia będzie ignorowany, a wszystkie urządzenia będą mogły uzyskać dostęp.
do usług Google.
Ta funkcja jest obsługiwana tylko w przypadku użytkowników zarządzanych przez Google.
Żądanie
Żądanie HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Parametry
| Nazwa parametru |
Wartość |
Opis |
| Parametry ścieżki |
deviceId |
string |
Identyfikator urządzenia.
|
enterpriseId |
string |
Identyfikator firmy.
|
userId |
string |
Identyfikator użytkownika.
|
Autoryzacja
To żądanie wymaga autoryzacji z tym zakresem:
| Zakres |
|---|
https://www.googleapis.com/auth/androidenterprise |
Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.
Treść żądania
Dane w treści żądania podaj w następującej strukturze:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nazwa usługi |
Wartość |
Opis |
Uwagi |
accountState |
string |
Stan konta Google na urządzeniu. „włączone” wskazuje, że konta Google na urządzeniu można używać do uzyskiwania dostępu do usług Google (w tym Google Play), gdy są wyłączone. to znaczy, że nie może. Nowe urządzenie jest początkowo „wyłączone” stanu.
Akceptowane wartości to:
|
|
kind |
string |
|
|
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nazwa usługi |
Wartość |
Opis |
Uwagi |
accountState |
string |
Stan konta Google na urządzeniu. „włączone” wskazuje, że konta Google na urządzeniu można używać do uzyskiwania dostępu do usług Google (w tym Google Play), gdy są wyłączone. to znaczy, że nie może. Nowe urządzenie jest początkowo „wyłączone” stanu.
Akceptowane wartości to:
|
|
kind |
string |
|
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-09-12 UTC.
[null,null,["Ostatnia aktualizacja: 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` | | |"]]
