重要: Play EMM API の新しい登録受け付けは終了しました。
詳細
Devices: getState
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
デバイスの Google サービスへのアクセスが有効かどうかを取得します。
無効です。
デバイスの状態が有効になるのは、Google 管理コンソールで Android デバイスに対する EMM ポリシーの適用が有効になっている場合のみです。それ以外の場合、デバイスの状態は無視され、すべてのデバイスにアクセス権が付与されます
Google サービスに接続できます
これは、Google が管理するユーザーに対してのみサポートされます。
リクエスト
HTTP リクエスト
GET 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 |
|
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-09-13 UTC。
[null,null,["最終更新日 2024-09-13 UTC。"],[[["\u003cp\u003eRetrieves a device's access status to Google services (enabled or disabled) for Google-managed users.\u003c/p\u003e\n"],["\u003cp\u003eDevice state is enforced only if EMM policies are enabled in the Google Admin Console, otherwise all devices are allowed access.\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\u003eResponse indicates the Google account state on the device as either "enabled" or "disabled".\u003c/p\u003e\n"]]],[],null,["# Devices: getState\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves whether a device's access to Google services is enabled or\ndisabled.\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```\nGET 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\nDo not supply a request body with this method.\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` | | |"]]
