Importante: não aceitamos mais novos registros para a API Play EMM.
Saiba mais.
Devices: getState
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recupera se o acesso de um dispositivo aos serviços do Google está ativado ou
desativado.
O estado do dispositivo só entra em vigor se as políticas de EMM forem aplicadas no Android
está ativada no Google Admin Console.
Caso contrário, o estado do dispositivo será ignorado, e todos os dispositivos terão acesso permitido
aos serviços do Google.
Isso só é compatível com usuários gerenciados pelo Google.
Solicitação
Solicitação HTTP
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| Parâmetros de caminho |
deviceId |
string |
O ID do dispositivo.
|
enterpriseId |
string |
O ID da empresa.
|
userId |
string |
O ID do usuário.
|
Autorização
Esta solicitação requer autorização com o seguinte escopo:
| Escopo |
|---|
https://www.googleapis.com/auth/androidenterprise |
Para mais informações, consulte a página de autenticação e autorização.
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nome da propriedade |
Valor |
Descrição |
Observações |
accountState |
string |
O estado da Conta do Google no dispositivo. "ativado" indica que a Conta do Google no dispositivo pode ser usada para acessar serviços do Google (incluindo o Google Play), enquanto estiver "desativada". significa que ela não pode. Um novo dispositivo está inicialmente no modo "desativado" estado.
Os valores aceitáveis são:
|
|
kind |
string |
|
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-13 UTC.
[null,null,["Última atualização 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` | | |"]]
