Importante:non accettiamo più nuove registrazioni per l'API Play EMM.
Scopri di più.
Devices: getState
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Recupera se l'accesso di un dispositivo ai servizi Google è attivo o
disattivata.
Lo stato del dispositivo viene applicato solo se l'applicazione dei criteri EMM sui dispositivi Android è attivata nella Console di amministrazione Google.
In caso contrario, lo stato del dispositivo viene ignorato e l'accesso è consentito a tutti i dispositivi
ai servizi Google.
Questo attributo è supportato solo per gli utenti gestiti da Google.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Parametri
| Nome del parametro |
Valore |
Descrizione |
| Parametri percorso |
deviceId |
string |
L'ID del dispositivo.
|
enterpriseId |
string |
L'ID dell'azienda.
|
userId |
string |
L'ID dell'utente.
|
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito:
| Ambito |
|---|
https://www.googleapis.com/auth/androidenterprise |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Non fornire un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nome proprietà |
Valore |
Descrizione |
Note |
accountState |
string |
Lo stato dell'Account Google sul dispositivo. "Attivato" indica che l'Account Google sul dispositivo può essere utilizzato per accedere ai servizi Google (incluso Google Play), mentre "Disattivato" indica che non può. Un nuovo dispositivo si trova inizialmente nello stato "disattivato" stato.
I valori accettati sono:
|
|
kind |
string |
|
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-09-12 UTC.
[null,null,["Ultimo aggiornamento 2024-09-12 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` | | |"]]
