Method: enterprises.devices.issueCommand

string

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

{
  "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.
}

enum (CommandType)

Der Typ des Befehls.

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 einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

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 keine Angabe gemacht wird, beträgt die Standarddauer zehn Minuten. Es gibt keine maximale Dauer.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string

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

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.

string

Gibt für Befehle vom Typ RESET_PASSWORD das neue Passwort (optional) an. Hinweis: Bei Geräten mit Android 14 muss das neue Passwort mindestens 6 Zeichen lang sein, wenn es numerisch ist. Andernfalls schlägt der Befehl mit INVALID_VALUE fehl.

enum (ResetPasswordFlag)

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

object (ClearAppsDataParams)

Parameter für den Befehl CLEAR_APP_DATA, mit dem die Daten bestimmter Apps vom Gerät gelöscht werden. ClearAppsDataParams ansehen. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird der Wert vom Server automatisch auf CLEAR_APP_DATA gesetzt. Es ist auch akzeptabel, type explizit auf CLEAR_APP_DATA festzulegen.

object (StartLostModeParams)

Parameter für den Befehl START_LOST_MODE, mit dem das Gerät in den Verloren-Modus versetzt wird. StartLostModeParams ansehen. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird der Wert vom Server automatisch auf START_LOST_MODE gesetzt. Es ist auch akzeptabel, type explizit auf START_LOST_MODE festzulegen.

object (StopLostModeParams)

Parameter für den Befehl STOP_LOST_MODE, mit dem das Gerät aus dem Verloren-Modus beendet wird. StopLostModeParams ansehen. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird der Wert vom Server automatisch auf STOP_LOST_MODE gesetzt. Es ist auch akzeptabel, type explizit auf STOP_LOST_MODE festzulegen.

object (ClearAppsDataStatus)

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

object (StartLostModeStatus)

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

object (StopLostModeStatus)

Nur Ausgabe. Status des Befehls STOP_LOST_MODE, mit dem der Verloren-Modus für das Gerät beendet wird. StopLostModeStatus ansehen.

{
  "packageNames": [
    string
  ]
}

string

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

{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}

object (UserFacingMessage)

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

object (UserFacingMessage)

Die Telefonnummer, die gewählt wird, wenn sich das Gerät im Verloren-Modus befindet und auf die Schaltfläche zum Anrufen des Eigentümers getippt wird.

string

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

object (UserFacingMessage)

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

object (UserFacingMessage)

Der Name der Organisation, der dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet.

{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}

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

Die Ergebnisse pro App – eine Zuordnung der Paketnamen zum jeweiligen Löschen-Ergebnis.

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

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

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

{
  "status": enum (Status)
}

enum (Status)

Der Status. StartLostModeStatus ansehen.

{
  "status": enum (Status)
}

enum (Status)

Der Status. StopLostModeStatus ansehen.