Method: enterprises.devices.issueCommand

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

string

Der Name des Geräts im Format enterprises/{enterpriseId}/devices/{deviceId}.

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 (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  }
  // End of list of possible types for union field status.
}
Felder
type

enum (CommandType)

Der Typ des Befehls.
createTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
duration

string (Duration format)

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 „s“ endet. Beispiel: "3.5s".
userName

string

Der Ressourcenname des Nutzers, dem das Gerät gehört, im Format enterprises/{enterpriseId}/users/{userId}. Sie wird automatisch vom Server generiert und richtet sich nach dem Gerät, an das der Befehl gesendet wird.
errorCode

enum (CommandErrorCode)

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

string

Für Befehle vom Typ RESET_PASSWORD wird optional das neue Passwort angegeben. Hinweis: Bei Android 14-Geräten muss das neue Passwort mindestens 6 Zeichen lang sein, wenn es sich um ein numerisches Passwort handelt. Andernfalls schlägt der Befehl mit INVALID_VALUE fehl.
resetPasswordFlags[]

enum (ResetPasswordFlag)

Für Befehle vom Typ RESET_PASSWORD werden optional Flags angegeben.

Union-Feld params. Parameter, die für den Befehl spezifisch sind. Beachten Sie, dass es von einigen Befehlen nicht verwendet wird, insbesondere LOCK, RESET_PASSWORD, REBOOT und RELINQUISH_OWNERSHIP. In Zukunft könnte dies auch für diese Befehle verwendet werden.

Wenn dies festgelegt ist, dürfen die Felder new_password und reset_password_flags nicht festgelegt werden. Für params ist nur einer der folgenden Werte zulässig:
clearAppsDataParams

object (ClearAppsDataParams)

Parameter für den Befehl CLEAR_APP_DATA, mit denen die Daten bestimmter Apps vom Gerät gelöscht werden. ClearAppsDataParams ansehen. Wenn diese Richtlinie festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall legt der Server ihn automatisch auf CLEAR_APP_DATA fest. Es ist auch möglich, type explizit auf CLEAR_APP_DATA festzulegen.
startLostModeParams

object (StartLostModeParams)

Parameter für den Befehl START_LOST_MODE, mit dem das Gerät in den Verloren-Modus versetzt wird. StartLostModeParams ansehen. Wenn diese Richtlinie festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall legt der Server ihn automatisch auf START_LOST_MODE fest. Es ist auch möglich, type explizit auf START_LOST_MODE festzulegen.
stopLostModeParams

object (StopLostModeParams)

Parameter für den Befehl STOP_LOST_MODE, mit dem das Gerät den Verloren-Modus beendet wird. StopLostModeParams ansehen. Wenn diese Richtlinie festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall legt der Server ihn automatisch auf STOP_LOST_MODE fest. Es ist auch möglich, type explizit auf STOP_LOST_MODE festzulegen.
Union-Feld status. Status speziell für den Befehl. Beachten Sie, dass es von einigen Befehlen nicht verwendet wird, insbesondere LOCK, RESET_PASSWORD, REBOOT und RELINQUISH_OWNERSHIP. In Zukunft könnte dies auch für diese Befehle verwendet werden. Für status ist nur einer der folgenden Werte zulässig:
clearAppsDataStatus

object (ClearAppsDataStatus)

Nur Ausgabe Status des Befehls CLEAR_APP_DATA zum Löschen der Daten bestimmter Apps vom Gerät. ClearAppsDataStatus ansehen.
startLostModeStatus

object (StartLostModeStatus)

Nur Ausgabe Status des Befehls START_LOST_MODE, mit dem das Gerät in den Verloren-Modus versetzt wird. StartLostModeStatus ansehen.
stopLostModeStatus

object (StopLostModeStatus)

Nur Ausgabe Status des Befehls STOP_LOST_MODE zum Beenden des Verloren-Modus. StopLostModeStatus ansehen.

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 clearAppsDataParams.
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 startLostModeParams.
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 stopLostModeParams.

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 CLEAR_APP_DATA verknüpft sind, um die Daten bestimmter Apps vom Gerät zu löschen.

JSON-Darstellung 
{
  "packageNames": [
    string
  ]
}
Felder
packageNames[]

string

Die Paketnamen der Apps, deren Daten beim Ausführen des Befehls gelöscht werden.

StartLostModeParams

Parameter, die dem Befehl START_LOST_MODE 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.

JSON-Darstellung 
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
Felder
lostMessage

object (UserFacingMessage)

Die Nachricht, die dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet.
lostPhoneNumber

object (UserFacingMessage)

Die Telefonnummer, die angerufen wird, wenn sich das Gerät im Verloren-Modus befindet und auf die Schaltfläche „Inhaber anrufen“ getippt wird.
lostEmailAddress

string

Die E-Mail-Adresse, die dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet.
lostStreetAddress

object (UserFacingMessage)

Die Adresse, die der Nutzer sieht, wenn sich das Gerät im Verloren-Modus befindet.
lostOrganization

object (UserFacingMessage)

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 STOP_LOST_MODE zugeordnet sind, um das Gerät aus dem Verloren-Modus zu entfernen.

ClearAppsDataStatus

Status des Befehls CLEAR_APP_DATA zum Löschen der Daten bestimmter Apps vom Gerät.

JSON-Darstellung 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
Felder
results

map (key: string, value: object (PerAppResult))

Die Ergebnisse pro App, eine Zuordnung der Paketnamen zum jeweiligen Löschvorgang.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

PerAppResult

Das Ergebnis des Versuchs, die Daten einer einzelnen App zu löschen.

JSON-Darstellung 
{
  "clearingResult": enum (ClearingResult)
}
Felder
clearingResult

enum (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 START_LOST_MODE, mit dem das Gerät in den Verloren-Modus versetzt wird.

JSON-Darstellung 
{
  "status": enum (Status)
}
Felder
status

enum (Status)

Der Status. StartLostModeStatus ansehen.

Status

Der Status. StartLostModeStatus ansehen.

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 STOP_LOST_MODE zum Beenden des Verloren-Modus.

JSON-Darstellung 
{
  "status": enum (Status)
}
Felder
status

enum (Status)

Der Status. StopLostModeStatus ansehen.

Status

Der Status. StopLostModeStatus ansehen.

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.