Method: enterprises.devices.issueCommand

string

שם המכשיר בפורמט 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)

סוג הפקודה.

string (Timestamp format)

חותמת הזמן שבה נוצרה הפקודה. חותמת הזמן נוצרת באופן אוטומטי על ידי השרת.

חותמת זמן בפורמט UTC "Zulu" של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Duration format)

משך הזמן שבו הפקודה תקפה. אם הפקודה לא תבוצע במכשיר במהלך פרק הזמן הזה, תוקפה יפוג. אם לא צוין משך זמן, ברירת המחדל היא 10 דקות. אין משך זמן מקסימלי.

משך זמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".

string

שם המשאב של המשתמש שבבעלותו המכשיר, בפורמט enterprises/{enterpriseId}/users/{userId}. השרת יוצר אותו באופן אוטומטי על סמך המכשיר שאליו נשלחת הפקודה.

enum (CommandErrorCode)

אם הפקודה נכשלה, קוד שגיאה עם הסבר על הכשל. הערך הזה לא מוגדר כשהמבצע מבטל את הפקודה.

string

בפקודות מסוג RESET_PASSWORD, אפשר לציין את הסיסמה החדשה. הערה: אם הסיסמה החדשה היא מספרית, היא צריכה להיות באורך 6 תווים לפחות במכשירי Android 14. אחרת, הפקודה תיכשל עם INVALID_VALUE.

enum (ResetPasswordFlag)

בפקודות מסוג RESET_PASSWORD, אפשר לציין דגלים.

object (ClearAppsDataParams)

פרמטרים לפקודה CLEAR_APP_DATA לניקוי הנתונים של אפליקציות ספציפיות מהמכשיר. ClearAppsDataParams. אם ההגדרה הזו מוגדרת, מומלץ לא להגדיר את type. במקרה כזה, השרת מגדיר אותו באופן אוטומטי ל-CLEAR_APP_DATA. אפשר גם להגדיר את type ל-CLEAR_APP_DATA באופן מפורש.

object (StartLostModeParams)

פרמטרים לפקודה START_LOST_MODE להעברת המכשיר למצב אבוד. StartLostModeParams. אם ההגדרה הזו מוגדרת, מומלץ לא להגדיר את type. במקרה כזה, השרת מגדיר אותו באופן אוטומטי ל-START_LOST_MODE. אפשר גם להגדיר את type ל-START_LOST_MODE באופן מפורש.

object (StopLostModeParams)

פרמטרים לפקודה STOP_LOST_MODE כדי להוציא את המכשיר ממצב אובדן. StopLostModeParams. אם ההגדרה הזו מוגדרת, מומלץ לא להגדיר את type. במקרה כזה, השרת מגדיר אותו באופן אוטומטי ל-STOP_LOST_MODE. אפשר גם להגדיר את type ל-STOP_LOST_MODE באופן מפורש.

object (ClearAppsDataStatus)

פלט בלבד. סטטוס הפקודה CLEAR_APP_DATA לניקוי הנתונים של אפליקציות מסוימות מהמכשיר. ClearAppsDataStatus.

object (StartLostModeStatus)

פלט בלבד. סטטוס הפקודה START_LOST_MODE להעברת המכשיר למצב אבוד. StartLostModeStatus.

object (StopLostModeStatus)

פלט בלבד. סטטוס הפקודה STOP_LOST_MODE להוצאת המכשיר ממצב אובדן. StopLostModeStatus.

{
  "packageNames": [
    string
  ]
}

string

שמות החבילות של האפליקציות שהנתונים שלהן יימחקו כשהפקודה תבוצע.

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

object (UserFacingMessage)

ההודעה שתוצג למשתמש כשהמכשיר נמצא במצב אובדן.

object (UserFacingMessage)

מספר הטלפון שאליו תבוצע שיחה כשהמכשיר במצב אבוד ותלחצו על הלחצן 'בעל המכשיר'.

string

כתובת האימייל שמוצגת למשתמש כשהמכשיר נמצא במצב אובדן.

object (UserFacingMessage)

הרחוב ומספר הבית שיוצגו למשתמש כשהמכשיר נמצא במצב אובדן.

object (UserFacingMessage)

שם הארגון שמוצג למשתמש כשהמכשיר נמצא במצב אובדן.

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

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

התוצאות לפי אפליקציה, מיפוי של שמות חבילות לתוצאת הניקוי המתאימה.

אובייקט שמכיל רשימה של זוגות "key": value. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

התוצאה של ניסיון לנקות את הנתונים של אפליקציה אחת.

{
  "status": enum (Status)
}

enum (Status)

הסטטוס. StartLostModeStatus.

{
  "status": enum (Status)
}

enum (Status)

הסטטוס. StopLostModeStatus.