مهم: ما دیگر ثبت نام های جدید برای Play EMM API را نمی پذیریم.
بیشتر بدانید .
Devices: setState
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
تنظیم می کند که آیا دسترسی دستگاه به خدمات Google فعال یا غیرفعال باشد. وضعیت دستگاه تنها در صورتی اعمال می‌شود که اجرای خط‌مشی‌های EMM در دستگاه‌های Android در کنسول مدیریت 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خط‌مشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-15 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-15 بهوقت ساعت هماهنگ جهانی."],[[["\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` | | |"]]
