- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Befehl
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- Status
- StopLostModeStatus (Verloren-Modus-Status)
- Status
- Testen!
Gibt einen Befehl an ein Gerät aus. Die zurückgegebene Operation
-Ressource enthält ein Command
-Objekt im Feld metadata
. Verwenden Sie die get-Vorgangsmethode, um den Status des Befehls abzurufen.
HTTP-Anfrage
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
name |
Der Name des Geräts im Format |
Anfragetext
Der Anfragetext enthält eine Instanz von Command
.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation
.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidmanagement
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Befehl
Ein Befehl.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type |
Der Typ des Befehls. |
createTime |
Der Zeitstempel, zu dem der Befehl erstellt wurde. Der Zeitstempel wird automatisch vom Server generiert. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
duration |
Die Dauer, für die der Befehl gültig ist. Der Befehl läuft ab, wenn er während dieser Zeit nicht vom Gerät ausgeführt wird. Wenn nicht angegeben, beträgt die Standarddauer zehn Minuten. Es gibt keine maximale Dauer. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
userName |
Der Ressourcenname des Nutzers, dem das Gerät gehört, im Format |
errorCode |
Wenn der Befehl fehlgeschlagen ist, wird ein Fehlercode angezeigt, der den Fehler erklärt. Dies ist nicht festgelegt, wenn der Befehl vom Aufrufer abgebrochen wird. |
newPassword |
Für Befehle vom Typ |
resetPasswordFlags[] |
Für Befehle vom Typ |
Union-Feld Wenn dies festgelegt ist, dürfen die Felder |
|
clearAppsDataParams |
Parameter für den Befehl |
startLostModeParams |
Parameter für den Befehl |
stopLostModeParams |
Parameter für den Befehl |
Union-Feld status . Status speziell für den Befehl. Beachten Sie, dass es von einigen Befehlen nicht verwendet wird, insbesondere , , und . In Zukunft könnte dies auch für diese Befehle verwendet werden. Für status ist nur einer der folgenden Werte zulässig: |
|
clearAppsDataStatus |
Nur Ausgabe Status des Befehls |
startLostModeStatus |
Nur Ausgabe Status des Befehls |
stopLostModeStatus |
Nur Ausgabe Status des Befehls |
CommandType
Arten von Befehlen.
Enums | |
---|---|
COMMAND_TYPE_UNSPECIFIED |
Dieser Wert ist nicht zulässig. |
LOCK |
Sie können das Gerät so sperren, als wäre das Zeitlimit für den Sperrbildschirm abgelaufen. |
RESET_PASSWORD |
Setzen Sie das Passwort des Nutzers zurück. |
REBOOT |
Starten Sie das Gerät neu. Wird nur auf vollständig verwalteten Geräten mit Android 7.0 (API-Level 24) oder höher unterstützt. |
RELINQUISH_OWNERSHIP |
Das Arbeitsprofil und alle Richtlinien werden von einem unternehmenseigenen Gerät mit Android 8.0 oder höher entfernt, sodass das Gerät nicht mehr privat genutzt werden kann. Mit den privaten Profilen verknüpfte Apps und Daten bleiben erhalten. Das Gerät wird vom Server gelöscht, nachdem der Befehl bestätigt wurde. |
CLEAR_APP_DATA |
Löscht die Anwendungsdaten der angegebenen Apps. Diese Funktion wird ab Android 9 unterstützt. Beachten Sie, dass eine App Daten außerhalb ihrer App-Daten speichern kann, zum Beispiel in einem externen Speicher oder in einem Nutzerwörterbuch. Siehe auch . |
START_LOST_MODE |
Versetzt das Gerät in den Verloren-Modus Diese Option wird nur auf vollständig verwalteten Geräten oder auf organisationseigenen Geräten mit einem verwalteten Profil unterstützt. Siehe auch . |
STOP_LOST_MODE |
Dadurch wird der Verloren-Modus des Geräts beendet. Diese Option wird nur auf vollständig verwalteten Geräten oder auf organisationseigenen Geräten mit einem verwalteten Profil unterstützt. Siehe auch . |
CommandErrorCode
Ein Befehlsfehlercode. Dies ist ein schreibgeschütztes Feld, das vom Server ausgefüllt wird.
Enums | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED |
Es ist kein Fehler aufgetreten. |
UNKNOWN |
Ein unbekannter Fehler ist aufgetreten. |
API_LEVEL |
Dieser Befehl wird von der API-Ebene des Geräts nicht unterstützt. |
MANAGEMENT_MODE |
Der Verwaltungsmodus (Profilinhaber, Geräteinhaber usw.) unterstützt den Befehl nicht. |
INVALID_VALUE |
Der Befehl enthält einen ungültigen Parameterwert. |
UNSUPPORTED |
Das Gerät unterstützt den Befehl nicht. Das Problem kann möglicherweise behoben werden, wenn Sie die Android Device Policy auf die neueste Version aktualisieren. |
ResetPasswordFlag
Flags, die für den Befehlstyp RESET_PASSWORD
verwendet werden können.
Enums | |
---|---|
RESET_PASSWORD_FLAG_UNSPECIFIED |
Dieser Wert wird ignoriert. |
REQUIRE_ENTRY |
Andere Administratoren dürfen das Passwort erst dann wieder ändern, wenn der Nutzer es eingegeben hat. |
DO_NOT_ASK_CREDENTIALS_ON_BOOT |
Beim Starten des Geräts nicht nach Nutzeranmeldedaten fragen. |
LOCK_NOW |
Sperren Sie das Gerät nach dem Zurücksetzen des Passworts. |
ClearAppsDataParams
Parameter, die mit dem Befehl
verknüpft sind, um die Daten bestimmter Apps vom Gerät zu löschen.CLEAR_APP_DATA
JSON-Darstellung |
---|
{ "packageNames": [ string ] } |
Felder | |
---|---|
packageNames[] |
Die Paketnamen der Apps, deren Daten beim Ausführen des Befehls gelöscht werden. |
StartLostModeParams
Parameter, die dem Befehl
zugeordnet sind, um das Gerät in den Verloren-Modus zu versetzen. Es muss mindestens einer der Parameter angegeben werden, ausgenommen der Organisationsname, damit das Gerät in den Verloren-Modus versetzt werden kann.START_LOST_MODE
JSON-Darstellung |
---|
{ "lostMessage": { object ( |
Felder | |
---|---|
lostMessage |
Die Nachricht, die dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet. |
lostPhoneNumber |
Die Telefonnummer, die angerufen wird, wenn sich das Gerät im Verloren-Modus befindet und auf die Schaltfläche „Inhaber anrufen“ getippt wird. |
lostEmailAddress |
Die E-Mail-Adresse, die dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet. |
lostStreetAddress |
Die Adresse, die der Nutzer sieht, wenn sich das Gerät im Verloren-Modus befindet. |
lostOrganization |
Der Name der Organisation, der dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet. |
StopLostModeParams
Dieser Typ hat keine Felder.
Parameter, die dem Befehl
zugeordnet sind, um das Gerät aus dem Verloren-Modus zu entfernen.STOP_LOST_MODE
ClearAppsDataStatus
Status des Befehls
zum Löschen der Daten bestimmter Apps vom Gerät.CLEAR_APP_DATA
JSON-Darstellung |
---|
{
"results": {
string: {
object ( |
Felder | |
---|---|
results |
Die Ergebnisse pro App, eine Zuordnung der Paketnamen zum jeweiligen Löschvorgang. Ein Objekt, das eine Liste von |
PerAppResult
Das Ergebnis des Versuchs, die Daten einer einzelnen App zu löschen.
JSON-Darstellung |
---|
{
"clearingResult": enum ( |
Felder | |
---|---|
clearingResult |
Das Ergebnis des Versuchs, die Daten einer einzelnen App zu löschen. |
ClearingResult
Das Ergebnis des Versuchs, die Daten einer einzelnen App zu löschen.
Enums | |
---|---|
CLEARING_RESULT_UNSPECIFIED |
Nicht angegebenes Ergebnis. |
SUCCESS |
Die Daten dieser App wurden gelöscht. |
APP_NOT_FOUND |
Die Daten dieser App konnten nicht gelöscht werden, weil sie nicht gefunden wurde. |
APP_PROTECTED |
Die Daten dieser App konnten nicht gelöscht werden, da sie geschützt ist. Dies kann beispielsweise für Apps gelten, die für das Funktionieren des Geräts wichtig sind, wie der Google Play Store. |
API_LEVEL |
Die Daten dieser App konnten nicht gelöscht werden, da das API-Level des Geräts diesen Befehl nicht unterstützt. |
StartLostModeStatus
Status des Befehls
, mit dem das Gerät in den Verloren-Modus versetzt wird.START_LOST_MODE
JSON-Darstellung |
---|
{
"status": enum ( |
Felder | |
---|---|
status |
Der Status. |
Status
Der Status.
ansehen.StartLostModeStatus
Enums | |
---|---|
STATUS_UNSPECIFIED |
Nicht angegeben Dieser Wert wird nicht verwendet. |
SUCCESS |
Das Gerät wurde in den Verloren-Modus versetzt. |
RESET_PASSWORD_RECENTLY |
Das Gerät konnte nicht in den Verloren-Modus versetzt werden, da der Administrator das Gerätepasswort kürzlich zurückgesetzt hat. |
USER_EXIT_LOST_MODE_RECENTLY |
Das Gerät konnte nicht in den Verloren-Modus versetzt werden, da der Nutzer den Verloren-Modus vor Kurzem beendet hat. |
ALREADY_IN_LOST_MODE |
Das Gerät befindet sich bereits im Verloren-Modus. |
StopLostModeStatus
Status des Befehls
zum Beenden des Verloren-Modus.STOP_LOST_MODE
JSON-Darstellung |
---|
{
"status": enum ( |
Felder | |
---|---|
status |
Der Status. |
Status
Der Status.
ansehen.StopLostModeStatus
Enums | |
---|---|
STATUS_UNSPECIFIED |
Nicht angegeben Dieser Wert wird nicht verwendet. |
SUCCESS |
Das Gerät wurde aus dem Verloren-Modus genommen. |
NOT_IN_LOST_MODE |
Das Gerät befindet sich nicht im Verloren-Modus. |