חשוב: אנחנו לא מקבלים יותר רישומים חדשים עבור Play EMM API.
מידע נוסף
Devices: setState
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
המדיניות הזו מגדירה אם הגישה של המכשיר לשירותי Google מופעלת או מושבתת.
מצב המכשיר תקף רק אם אוכפים מדיניות EMM ב-Android
מופעלים במסוף Google Admin.
אחרת, מצב המכשיר לא יילקח בחשבון וכל המכשירים יקבלו גישה לשירותי Google.
האפשרות הזו נתמכת רק עבור משתמשים שמנוהלים על ידי Google.
בקשה
בקשת HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
פרמטרים
| שם הפרמטר |
ערך |
תיאור |
| פרמטרים של נתיב |
deviceId |
string |
המזהה של המכשיר.
|
enterpriseId |
string |
המזהה של הארגון.
|
userId |
string |
המזהה של המשתמש.
|
אישור
הבקשה הזו מחייבת הרשאה עם ההיקף הבא:
| היקף |
|---|
https://www.googleapis.com/auth/androidenterprise |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מספקים נתונים במבנה הבא:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| שם הנכס |
ערך |
תיאור |
הערות |
accountState |
string |
המצב של חשבון Google במכשיר. 'מופעל' מציין שניתן להשתמש בחשבון Google במכשיר כדי לגשת לשירותי Google (כולל Google Play), בזמן שהוא 'מושבת' פירושו שהוא לא יכול. מכשיר חדש נמצא בהתחלה במצב 'מושבת' .
הערכים הקבילים הם:
|
|
kind |
string |
|
|
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה גוף תגובה עם המבנה הבא:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| שם הנכס |
ערך |
תיאור |
הערות |
accountState |
string |
המצב של חשבון Google במכשיר. 'מופעל' מציין שניתן להשתמש בחשבון Google במכשיר כדי לגשת לשירותי Google (כולל Google Play), בזמן שהוא 'מושבת' פירושו שהוא לא יכול. מכשיר חדש נמצא בהתחלה במצב 'מושבת' .
הערכים הקבילים הם:
|
|
kind |
string |
|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-12 (שעון UTC).
[null,null,["עדכון אחרון: 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` | | |"]]
