Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play.
En savoir plus
Devices: setState
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Détermine si l'accès d'un appareil aux services Google est activé ou désactivé.
L'état de l'appareil ne prend effet que si l'application des règles EMM sur les appareils Android est activée dans la console d'administration Google.
Sinon, l'état de l'appareil est ignoré et tous les appareils sont autorisés à accéder aux services Google.
Cette option n'est disponible que pour les utilisateurs gérés par Google.
Requête
Requête HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Paramètres
| Nom du paramètre |
Valeur |
Description |
| Paramètres de chemin d'accès |
deviceId |
string |
Identifiant de l'appareil.
|
enterpriseId |
string |
ID de l'entreprise.
|
userId |
string |
ID de l'utilisateur.
|
Autorisation
Cette requête nécessite une autorisation ayant le champ d'application suivant:
| Champ d'application |
|---|
https://www.googleapis.com/auth/androidenterprise |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Dans le corps de la requête, fournissez les données selon la structure suivante:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nom de propriété |
Valeur |
Description |
Remarques |
accountState |
string |
État du compte Google sur l'appareil. "activé" indique que le compte Google sur l'appareil peut être utilisé pour accéder aux services Google (y compris Google Play), alors qu'il est "désactivé" signifie que cela n'est pas possible. Un nouvel appareil est initialement dans l'état "Désactivé" de l'état.
Les valeurs possibles sont les suivantes:
|
|
kind |
string |
|
|
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Nom de propriété |
Valeur |
Description |
Remarques |
accountState |
string |
État du compte Google sur l'appareil. "activé" indique que le compte Google sur l'appareil peut être utilisé pour accéder aux services Google (y compris Google Play), alors qu'il est "désactivé" signifie que cela n'est pas possible. Un nouvel appareil est initialement dans l'état "Désactivé" de l'état.
Les valeurs possibles sont les suivantes:
|
|
kind |
string |
|
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/09/12 (UTC).
[null,null,["Dernière mise à jour le 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` | | |"]]
