- 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
Envoie 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 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. |
createTime |
Horodatage de la création de la commande. Le code temporel est généré automatiquement par le serveur. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
duration |
Durée de validité de la commande. La commande expirera si elle n'est pas exécutée par l'appareil pendant cette période. Si aucune valeur n'est spécifiée, la durée par défaut est de dix minutes. Il n'y a pas de durée maximale. Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
userName |
Nom de ressource de l'utilisateur propriétaire de l'appareil, au format |
errorCode |
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. |
newPassword |
Pour les commandes de type |
resetPasswordFlags[] |
Pour les commandes de type |
Champ d'union Si cette option est définie, les champs |
|
clearAppsDataParams |
Paramètres de la commande |
startLostModeParams |
Paramètres de la commande |
stopLostModeParams |
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 pourront également l'utiliser. status ne peut être que l'un des éléments suivants: |
|
clearAppsDataStatus |
Uniquement en sortie. État de la commande |
startLostModeStatus |
Uniquement en sortie. État de la commande |
stopLostModeStatus |
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. Uniquement disponible 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) appartenant à l'entreprise. L'appareil est alors destiné à un usage personnel. Les applications et les données associées aux profils personnels sont conservées. L'appareil sera supprimé du serveur une fois la commande confirmée. |
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 aussi . |
START_LOST_MODE |
Passe l'appareil en mode Perdu. Uniquement disponible sur les appareils entièrement gérés ou sur les appareils appartenant à l'organisation dotés d'un profil géré. Voir aussi . |
STOP_LOST_MODE |
Permet de sortir l'appareil du mode Perdu. Uniquement disponible sur les appareils entièrement gérés ou sur les appareils appartenant à l'organisation dotés d'un profil géré. Voir aussi . |
CommandErrorCode
Code d'erreur de commande. Il s'agit d'un champ en lecture seule 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 ne prend pas en charge la commande. La mise à jour d'Android Device Policy peut résoudre le problème. |
ResetPasswordFlag
Indicateurs pouvant être utilisés pour le type de commande RESET_PASSWORD
.
Enums | |
---|---|
RESET_PASSWORD_FLAG_UNSPECIFIED |
Cette valeur est ignorée. |
REQUIRE_ENTRY |
Ne pas autoriser les autres administrateurs à modifier à nouveau le mot de passe tant que l'utilisateur ne l'a pas saisi. |
DO_NOT_ASK_CREDENTIALS_ON_BOOT |
Ne demandez pas les identifiants de l'utilisateur au démarrage de l'appareil. |
LOCK_NOW |
Verrouiller l'appareil après la réinitialisation du mot de passe |
ClearAppsDataParams
Paramètres associés à la commande
permettant d'effacer de l'appareil les données des applications spécifiées.CLEAR_APP_DATA
Représentation JSON |
---|
{ "packageNames": [ string ] } |
Champs | |
---|---|
packageNames[] |
Noms de package des applications dont les données seront effacées lors de l'exécution de la commande. |
StartLostModeParams
Paramètres associés à la commande
permettant de faire passer l'appareil en mode Perdu. Vous devez fournir au moins l'un des paramètres, à l'exception du nom de l'organisation, pour que l'appareil passe en mode Perdu.START_LOST_MODE
Représentation JSON |
---|
{ "lostMessage": { object ( |
Champs | |
---|---|
lostMessage |
Message affiché lorsque l'appareil est en mode Perdu. |
lostPhoneNumber |
Numéro de téléphone qui est composé lorsque l'appareil est en mode Perdu et que l'utilisateur appuie sur le bouton du propriétaire de l'appel. |
lostEmailAddress |
Adresse e-mail présentée à l'utilisateur lorsque l'appareil est en mode Perdu. |
lostStreetAddress |
Adresse postale présentée à l'utilisateur lorsque l'appareil est en mode Perdu. |
lostOrganization |
Nom de l'organisation présenté à 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
permettant d'effacer de l'appareil les données des applications spécifiées.CLEAR_APP_DATA
Représentation JSON |
---|
{
"results": {
string: {
object ( |
Champs | |
---|---|
results |
Résultats par application, à savoir le mappage entre les noms de package et le 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 | |
---|---|
clearingResult |
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 appli, car elle est protégée. Cela peut s'appliquer, par exemple, aux applications essentielles au fonctionnement de l'appareil, telles que le Google Play Store. |
API_LEVEL |
Impossible d'effacer les données de cette application, 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 |
URL indéterminée. 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é le mode Perdu. |
ALREADY_IN_LOST_MODE |
L'appareil est déjà en mode Perdu. |
StopLostModeStatus
État de la commande
permettant de sortir l'appareil du mode Perdu.STOP_LOST_MODE
Représentation JSON |
---|
{
"status": enum ( |
Champs | |
---|---|
status |
État. Consultez les |
État
État. Consultez les
.StopLostModeStatus
Enums | |
---|---|
STATUS_UNSPECIFIED |
URL indéterminée. Cette valeur n'est pas utilisée. |
SUCCESS |
L'appareil a été retiré du mode Perdu. |
NOT_IN_LOST_MODE |
L'appareil n'est pas en mode Perdu. |