重要: Play EMM API の新しい登録受け付けは終了しました。
詳細
Devices: setState
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
デバイスの Google サービスへのアクセスを有効にするか無効にするかを設定します。
デバイスの状態は、Android で EMM ポリシーを適用した場合にのみ有効になります
Google 管理コンソールで有効にできます。
それ以外の場合、デバイスの状態は無視され、すべてのデバイスにアクセス権が付与されます
Google サービスに接続できます
これは、Google が管理するユーザーに対してのみサポートされます。
リクエスト
HTTP リクエスト
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
パラメータ
| パラメータ名 |
値 |
説明 |
| パスパラメータ |
deviceId |
string |
デバイスの ID。
|
enterpriseId |
string |
企業の ID。
|
userId |
string |
ユーザーの ID。
|
承認
このリクエストには、次のスコープによる認証が必要です。
| スコープ |
|---|
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 |
|
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 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` | | |"]]
