- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Commande
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- État
- StopLostModeStatus
- État
- Essayer
Émet une commande à un appareil. La ressource Operation
renvoyée contient un Command
dans son champ metadata
. Utilisez la méthode d'opération get pour obtenir l'état de la commande.
Requête HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
name |
Nom de l'appareil au format |
Corps de la requête
Le corps de la requête contient une instance de Command
.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Operation
.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/androidmanagement
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
Commande
Une commande
Représentation JSON |
---|
{ "type": enum ( |
Champs | |
---|---|
type |
Type de la commande. |
create |
Code temporel de création de la commande. Le code temporel est généré automatiquement par le serveur. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
duration |
Durée de validité de la commande. La commande expirera si elle n'est pas exécutée par l'appareil pendant ce laps de temps. Si aucune valeur n'est spécifiée, la durée par défaut est de 10 minutes. Il n'y a pas de durée maximale. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
user |
Nom de la ressource de l'utilisateur propriétaire de l'appareil au format |
error |
Si la commande a échoué, un code d'erreur expliquant l'échec. Ce paramètre n'est pas défini lorsque la commande est annulée par l'appelant. |
new |
Pour les commandes de type |
reset |
Pour les commandes de type |
Champ d'union Si cette valeur est définie, les champs |
|
clear |
Paramètres de la commande |
start |
Paramètres de la commande |
stop |
Paramètres de la commande |
Champ d'union status . État spécifique à la commande. Notez que certaines commandes ne l'utilisent pas, en particulier , , et . À l'avenir, ces commandes pourraient également l'utiliser. status ne peut être que l'un des éléments suivants: |
|
clear |
Uniquement en sortie. État de la commande |
start |
Uniquement en sortie. État de la commande |
stop |
Uniquement en sortie. État de la commande |
CommandType
Types de commandes
Enums | |
---|---|
COMMAND_TYPE_UNSPECIFIED |
Cette valeur n'est pas autorisée. |
LOCK |
Verrouillez l'appareil comme si le délai de verrouillage de l'écran avait expiré. |
RESET_PASSWORD |
Réinitialisez le mot de passe de l'utilisateur. |
REBOOT |
Redémarrez l'appareil. Disponible uniquement sur les appareils entièrement gérés équipés d'Android 7.0 (niveau d'API 24) ou version ultérieure. |
RELINQUISH_OWNERSHIP |
Supprime le profil professionnel et toutes les règles d'un appareil Android 8.0 (ou version ultérieure) détenu par l'entreprise, ce qui permet à l'appareil d'être utilisé à des fins personnelles. Les applications et les données associées au ou aux profils personnels sont conservées. L'appareil sera supprimé du serveur après avoir pris connaissance de la commande. |
CLEAR_APP_DATA |
Efface les données des applications spécifiées. Cette fonctionnalité est compatible avec Android 9 ou version ultérieure. Notez qu'une application peut stocker des données en dehors de ses données d'application, par exemple dans un espace de stockage externe ou dans un dictionnaire utilisateur. Voir également . |
START_LOST_MODE |
Passe l'appareil en mode Perdu. Compatible uniquement avec les appareils entièrement gérés ou les appareils appartenant à l'entreprise avec un profil géré. Voir également . |
STOP_LOST_MODE |
Désactive le mode Perdu de l'appareil. Compatible uniquement avec les appareils entièrement gérés ou les appareils détenus par l'organisation disposant d'un profil géré. Voir également . |
CommandErrorCode
Code d'erreur de la commande. Ce champ en lecture seule est renseigné par le serveur.
Enums | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED |
Aucune erreur ne s'est produite. |
UNKNOWN |
Une erreur inconnue s'est produite. |
API_LEVEL |
Le niveau d'API de l'appareil n'est pas compatible avec cette commande. |
MANAGEMENT_MODE |
Le mode de gestion (propriétaire du profil, propriétaire de l'appareil, etc.) n'est pas compatible avec la commande. |
INVALID_VALUE |
La commande comporte une valeur de paramètre non valide. |
UNSUPPORTED |
L'appareil n'est pas compatible avec la commande. La mise à jour de la dernière version d'Android Device Policy peut résoudre le problème. |
ResetPasswordFlag
Indicateurs disponibles pour le type de commande RESET_PASSWORD
.
Enums | |
---|---|
RESET_PASSWORD_FLAG_UNSPECIFIED |
Cette valeur est ignorée. |
REQUIRE_ENTRY |
Ne permettez pas aux autres administrateurs de modifier à nouveau le mot de passe tant que l'utilisateur ne l'a pas saisi. |
DO_NOT_ASK_CREDENTIALS_ON_BOOT |
Ne demandez pas d'identifiants utilisateur au démarrage de l'appareil. |
LOCK_NOW |
Verrouillez l'appareil après la réinitialisation du mot de passe. |
ClearAppsDataParams
Paramètres associés à la commande
pour effacer de l'appareil les données des applications spécifiées.CLEAR_APP_DATA
Représentation JSON |
---|
{ "packageNames": [ string ] } |
Champs | |
---|---|
package |
Noms des packages des applications dont les données seront effacées lors de l'exécution de la commande. |
StartLostModeParams
Paramètres associés à la commande
pour activer le mode Perdu sur l'appareil. Vous devez fournir au moins l'un des paramètres, à l'exception du nom de l'organisation, pour que l'appareil soit mis en mode Perdu.START_LOST_MODE
Représentation JSON |
---|
{ "lostMessage": { object ( |
Champs | |
---|---|
lost |
Message affiché à l'utilisateur lorsque l'appareil est en mode Perdu. |
lost |
Numéro de téléphone à appeler lorsque l'appareil est en mode Perdu et que le bouton "Appeler le propriétaire" est enfoncé. |
lost |
Adresse e-mail affichée à l'utilisateur lorsque l'appareil est en mode Perdu. |
lost |
Adresse postale affichée à l'utilisateur lorsque l'appareil est en mode Perdu. |
lost |
Nom de l'organisation affiché pour l'utilisateur lorsque l'appareil est en mode Perdu. |
StopLostModeParams
Ce type ne comporte aucun champ.
Paramètres associés à la commande
pour sortir l'appareil du mode Perdu.STOP_LOST_MODE
ClearAppsDataStatus
État de la commande
pour effacer les données des applications spécifiées de l'appareil.CLEAR_APP_DATA
Représentation JSON |
---|
{
"results": {
string: {
object ( |
Champs | |
---|---|
results |
Résultats par application, mappage des noms des packages au résultat d'effacement correspondant. Objet contenant une liste de paires |
PerAppResult
Résultat d'une tentative d'effacement des données d'une seule application.
Représentation JSON |
---|
{
"clearingResult": enum ( |
Champs | |
---|---|
clearing |
Résultat d'une tentative d'effacement des données d'une seule application. |
ClearingResult
Résultat d'une tentative d'effacement des données d'une seule application.
Enums | |
---|---|
CLEARING_RESULT_UNSPECIFIED |
Résultat non spécifié. |
SUCCESS |
Les données de cette application ont bien été effacées. |
APP_NOT_FOUND |
Impossible d'effacer les données de cette application, car elle est introuvable. |
APP_PROTECTED |
Impossible d'effacer les données de cette application, car elle est protégée. Par exemple, cela peut s'appliquer à des applications essentielles au fonctionnement de l'appareil, telles que le Google Play Store. |
API_LEVEL |
Les données de cette application n'ont pas pu être effacées, car le niveau d'API de l'appareil n'est pas compatible avec cette commande. |
StartLostModeStatus
État de la commande
permettant de mettre l'appareil en mode Perdu.START_LOST_MODE
Représentation JSON |
---|
{
"status": enum ( |
Champs | |
---|---|
status |
État. Consultez les |
État
État. Consultez les
.StartLostModeStatus
Enums | |
---|---|
STATUS_UNSPECIFIED |
Non spécifié. Cette valeur n'est pas utilisée. |
SUCCESS |
L'appareil a été mis en mode Perdu. |
RESET_PASSWORD_RECENTLY |
Impossible de mettre l'appareil en mode Perdu, car l'administrateur a récemment réinitialisé son mot de passe. |
USER_EXIT_LOST_MODE_RECENTLY |
Impossible de mettre l'appareil en mode Perdu, car l'utilisateur a récemment quitté ce mode. |
ALREADY_IN_LOST_MODE |
L'appareil est déjà en mode Perdu. |
StopLostModeStatus
État de la commande
pour désactiver le mode Perdu de l'appareil.STOP_LOST_MODE
Représentation JSON |
---|
{
"status": enum ( |
Champs | |
---|---|
status |
État. Consultez les |
État
État. Consultez les
.StopLostModeStatus
Enums | |
---|---|
STATUS_UNSPECIFIED |
Non spécifié. Cette valeur n'est pas utilisée. |
SUCCESS |
L'appareil a été désactivé du mode Perdu. |
NOT_IN_LOST_MODE |
L'appareil n'est pas en mode Perdu. |