Devices: setState
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menetapkan apakah akses perangkat ke layanan Google diaktifkan atau dinonaktifkan.
Status perangkat hanya berlaku jika penerapan kebijakan EMM di perangkat
Android diaktifkan di Konsol Google Admin.
Jika tidak, status perangkat akan diabaikan dan semua perangkat akan mendapatkan akses yang diizinkan
ke layanan Google.
Fitur ini hanya didukung untuk pengguna yang dikelola Google.
Permintaan
Permintaan HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Parameter
| Nama parameter |
Nilai |
Deskripsi |
| Parameter jalur |
deviceId |
string |
ID perangkat.
|
enterpriseId |
string |
ID perusahaan.
|
userId |
string |
ID pengguna.
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
| Cakupan |
|---|
https://www.googleapis.com/auth/androidenterprise |
Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Dalam isi permintaan, berikan data dengan struktur berikut:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nama properti |
Nilai |
Deskripsi |
Catatan |
accountState |
string |
Status Akun Google di perangkat. "diaktifkan" menunjukkan bahwa Akun Google di perangkat dapat digunakan untuk mengakses layanan Google (termasuk Google Play), meskipun "dinonaktifkan" berarti tidak dapat dilakukan. Perangkat baru awalnya akan berada dalam status "dinonaktifkan" status.
Nilai yang dapat diterima adalah:
|
|
kind |
string |
|
|
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nama properti |
Nilai |
Deskripsi |
Catatan |
accountState |
string |
Status Akun Google di perangkat. "diaktifkan" menunjukkan bahwa Akun Google di perangkat dapat digunakan untuk mengakses layanan Google (termasuk Google Play), meskipun "dinonaktifkan" berarti tidak dapat dilakukan. Perangkat baru awalnya akan berada dalam status "dinonaktifkan" status.
Nilai yang dapat diterima adalah:
|
|
kind |
string |
|
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-09-12 UTC.
[null,null,["Terakhir diperbarui pada 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` | | |"]]
