Devices: setState
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir cihazın Google hizmetlerine erişiminin etkin mi yoksa devre dışı mı olduğunu belirler.
Cihaz durumu yalnızca Android'de EMM politikaları zorunlu kılındığında geçerli olur
cihazlarınızın Google Yönetici Konsolu'ndan etkinleştirilmiş olduğundan emin olun.
Aksi takdirde, cihaz durumu yoksayılır ve tüm cihazların erişmesine izin verilir
Google hizmetlerine.
Bu özellik yalnızca Google tarafından yönetilen kullanıcılar için desteklenir.
İstek
HTTP isteği
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Parametreler
| Parametre adı |
Değer |
Açıklama |
| Yol parametreleri |
deviceId |
string |
Cihazın kimliği.
|
enterpriseId |
string |
Kuruluşun kimliği.
|
userId |
string |
Kullanıcının kimliği.
|
Yetkilendirme
Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:
| Kapsam |
|---|
https://www.googleapis.com/auth/androidenterprise |
Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.
İstek içeriği
İstek gövdesinde, verileri aşağıdaki yapıyla sağlayın:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Mülk adı |
Değer |
Açıklama |
Notlar |
accountState |
string |
Cihazdaki Google hesabının durumu. "etkin" cihazdaki Google hesabının "devre dışı" durumdayken Google hizmetlerine (Google Play dahil) erişmek için kullanılabileceğini belirtir bu mümkün değildir. Yeni bir cihaz başlangıçta "devre dışı" durumundaysa durumu.
Kabul edilen değerler şunlardır:
|
|
kind |
string |
|
|
Yanıt
Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Mülk adı |
Değer |
Açıklama |
Notlar |
accountState |
string |
Cihazdaki Google hesabının durumu. "etkin" cihazdaki Google hesabının "devre dışı" durumdayken Google hizmetlerine (Google Play dahil) erişmek için kullanılabileceğini belirtir bu mümkün değildir. Yeni bir cihaz başlangıçta "devre dışı" durumundaysa durumu.
Kabul edilen değerler şunlardır:
|
|
kind |
string |
|
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-09-12 UTC.
[null,null,["Son güncelleme tarihi: 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` | | |"]]
