Importante:non accettiamo più nuove registrazioni per l'API Play EMM.
Scopri di più.
Devices: setState
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Consente di impostare l'attivazione o la disattivazione dell'accesso di un dispositivo ai servizi Google.
Lo stato del dispositivo ha effetto solo se vengono applicati i criteri EMM su Android
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
PUT 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
Nel corpo della richiesta, fornisci i dati 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), quando è "disattivato" ma non è in grado di farlo. Un nuovo dispositivo si trova inizialmente nello stato "disattivato" stato.
I valori accettati sono:
|
|
kind |
string |
|
|
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), quando è "disattivato" ma non è in grado di farlo. 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-10 UTC.
[null,null,["Ultimo aggiornamento 2024-09-10 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` | | |"]]
