Importante: Ya no aceptamos registros nuevos para la API de EMM de Play.
Más información
Devices: setState
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Establece si el acceso de un dispositivo a los servicios de Google está habilitado o inhabilitado.
El estado del dispositivo se aplica solo si se habilita la aplicación forzosa de las políticas de EMM en dispositivos Android en la Consola del administrador de Google.
De lo contrario, se ignorará el estado del dispositivo y todos los dispositivos podrán acceder.
a los servicios de Google.
Esta opción solo es compatible con los usuarios administrados por Google.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Parámetros
| Nombre del parámetro |
Valor |
Descripción |
| Parámetros de ruta de acceso |
deviceId |
string |
Es el ID del dispositivo.
|
enterpriseId |
string |
El ID de la empresa.
|
userId |
string |
El ID del usuario
|
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
| Alcance |
|---|
https://www.googleapis.com/auth/androidenterprise |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona los datos con la siguiente estructura:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
accountState |
string |
El estado de la Cuenta de Google en el dispositivo. "habilitado" indica que la cuenta de Google en el dispositivo se puede utilizar para acceder a los servicios de Google (incluido Google Play), mientras está "inhabilitada". significa que no puede. Un dispositivo nuevo se encuentra inicialmente en el estado "incapacitado".
Los valores aceptables son los siguientes:
|
|
kind |
string |
|
|
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
accountState |
string |
El estado de la Cuenta de Google en el dispositivo. "habilitado" indica que la cuenta de Google en el dispositivo se puede utilizar para acceder a los servicios de Google (incluido Google Play), mientras está "inhabilitada". significa que no puede. Un dispositivo nuevo se encuentra inicialmente en el estado "incapacitado".
Los valores aceptables son los siguientes:
|
|
kind |
string |
|
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-12 (UTC)
[null,null,["Última actualización: 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` | | |"]]
