Method: enterprises.devices.issueCommand

ออกคำสั่งไปยังอุปกรณ์ ทรัพยากร Operation ที่แสดงผลมี Command ในช่อง metadata ใช้เมธอดการดำเนินการ get เพื่อดูสถานะของคำสั่ง

คำขอ HTTP

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ชื่ออุปกรณ์ในรูปแบบ enterprises/{enterpriseId}/devices/{deviceId}

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ Command

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/androidmanagement

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

คำสั่ง

คำสั่ง

การแสดง JSON 
{
  "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.
}
ช่อง
type

enum (CommandType)

ประเภทของคำสั่ง
createTime

string (Timestamp format)

การประทับเวลาที่สร้างคำสั่ง เซิร์ฟเวอร์จะสร้างการประทับเวลาโดยอัตโนมัติ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
duration

string (Duration format)

ระยะเวลาที่คําสั่งใช้งานได้ คําสั่งนี้จะหมดอายุหากอุปกรณ์ไม่ได้เรียกใช้ในช่วงเวลานี้ ระยะเวลาเริ่มต้นหากไม่ได้ระบุคือ 10 นาที ไม่มีระยะเวลาสูงสุด

ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" เช่น "3.5s"
userName

string

ชื่อทรัพยากรของผู้ใช้ที่เป็นเจ้าของอุปกรณ์ในรูปแบบ enterprises/{enterpriseId}/users/{userId} ซึ่งเซิร์ฟเวอร์จะสร้างขึ้นมาโดยอัตโนมัติตามอุปกรณ์ที่ใช้ส่งคำสั่ง
errorCode

enum (CommandErrorCode)

หากคำสั่งล้มเหลว จะมีรหัสข้อผิดพลาดที่อธิบายการทำงานดังกล่าว การตั้งค่านี้ไม่ได้ตั้งค่าไว้เมื่อผู้โทรยกเลิกคำสั่ง
newPassword

string

สำหรับคำสั่งประเภท RESET_PASSWORD คุณจะระบุรหัสผ่านใหม่หรือไม่ก็ได้ หมายเหตุ: รหัสผ่านใหม่ต้องมีความยาวอย่างน้อย 6 อักขระหากเป็นตัวเลขในกรณีสำหรับอุปกรณ์ Android 14 มิฉะนั้นคำสั่งจะล้มเหลวเมื่อใช้ INVALID_VALUE
resetPasswordFlags[]

enum (ResetPasswordFlag)

สำหรับคำสั่งประเภท RESET_PASSWORD คุณจะระบุแฟล็กหรือไม่ก็ได้

ฟิลด์สหภาพ params พารามิเตอร์เฉพาะสำหรับคำสั่ง โปรดทราบว่าบางคำสั่งจะไม่ใช้ตัวเลือกนี้ โดยเฉพาะ LOCK, RESET_PASSWORD, REBOOT และ RELINQUISH_OWNERSHIP ในอนาคต คำสั่งเหล่านี้อาจใช้ได้เช่นกัน

หากตั้งค่านี้ ก็ไม่ต้องตั้งค่าช่อง new_password และ reset_password_flags params ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
clearAppsDataParams

object (ClearAppsDataParams)

พารามิเตอร์สำหรับคำสั่ง CLEAR_APP_DATA เพื่อล้างข้อมูลของแอปที่ระบุออกจากอุปกรณ์ ดู ClearAppsDataParams หากตั้งค่านี้ไว้ ขอแนะนำว่าไม่ควรตั้งค่า type ในกรณีนี้ เซิร์ฟเวอร์จะตั้งค่าเป็น CLEAR_APP_DATA โดยอัตโนมัติ นอกจากนี้คุณยังตั้งค่า type เป็น CLEAR_APP_DATA อย่างชัดแจ้งได้อีกด้วย
startLostModeParams

object (StartLostModeParams)

พารามิเตอร์สําหรับคําสั่ง START_LOST_MODE เพื่อทำให้อุปกรณ์เข้าสู่โหมดสูญหาย ดู StartLostModeParams หากตั้งค่านี้ไว้ ขอแนะนำว่าไม่ควรตั้งค่า type ในกรณีนี้ เซิร์ฟเวอร์จะตั้งค่าเป็น START_LOST_MODE โดยอัตโนมัติ นอกจากนี้คุณยังตั้งค่า type เป็น START_LOST_MODE อย่างชัดแจ้งได้อีกด้วย
stopLostModeParams

object (StopLostModeParams)

พารามิเตอร์สำหรับคำสั่ง STOP_LOST_MODE เพื่อนำอุปกรณ์ออกจากโหมดสูญหาย ดู StopLostModeParams หากตั้งค่านี้ไว้ ขอแนะนำว่าไม่ควรตั้งค่า type ในกรณีนี้ เซิร์ฟเวอร์จะตั้งค่าเป็น STOP_LOST_MODE โดยอัตโนมัติ นอกจากนี้คุณยังตั้งค่า type เป็น STOP_LOST_MODE อย่างชัดแจ้งได้อีกด้วย
ฟิลด์สหภาพ status สถานะเฉพาะของคำสั่ง โปรดทราบว่าบางคำสั่งจะไม่ใช้ตัวเลือกนี้ โดยเฉพาะ LOCK, RESET_PASSWORD, REBOOT และ RELINQUISH_OWNERSHIP ในอนาคต คำสั่งเหล่านี้อาจใช้ได้เช่นกัน status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
clearAppsDataStatus

object (ClearAppsDataStatus)

เอาต์พุตเท่านั้น สถานะของคำสั่ง CLEAR_APP_DATA สำหรับล้างข้อมูลของแอปที่ระบุออกจากอุปกรณ์ ดู ClearAppsDataStatus
startLostModeStatus

object (StartLostModeStatus)

เอาต์พุตเท่านั้น สถานะของคำสั่ง START_LOST_MODE เพื่อให้อุปกรณ์เข้าสู่โหมดสูญหาย ดู StartLostModeStatus
stopLostModeStatus

object (StopLostModeStatus)

เอาต์พุตเท่านั้น สถานะของคำสั่ง STOP_LOST_MODE เพื่อนำอุปกรณ์ออกจากโหมดสูญหาย ดู StopLostModeStatus

CommandType

ประเภทของคำสั่ง

Enum
COMMAND_TYPE_UNSPECIFIED ค่านี้ไม่ได้รับอนุญาต
LOCK ล็อกอุปกรณ์เหมือนว่าระยะหมดเวลาของหน้าจอล็อกได้หมดอายุแล้ว
RESET_PASSWORD รีเซ็ตรหัสผ่านของผู้ใช้
REBOOT รีบูตอุปกรณ์ รองรับเฉพาะในอุปกรณ์ที่มีการจัดการครบวงจรซึ่งใช้ Android 7.0 (API ระดับ 24) ขึ้นไปเท่านั้น
RELINQUISH_OWNERSHIP นำโปรไฟล์งานและนโยบายทั้งหมดออกจากอุปกรณ์ Android 8.0 ขึ้นไปที่เป็นของบริษัท และจะเลิกใช้อุปกรณ์เพื่อการใช้งานส่วนตัว ส่วนแอปและข้อมูลที่เชื่อมโยงกับโปรไฟล์ส่วนตัวจะยังคงอยู่ ระบบจะลบอุปกรณ์ออกจากเซิร์ฟเวอร์หลังจากรับทราบคำสั่ง
CLEAR_APP_DATA ล้างข้อมูลแอปพลิเคชันของแอปที่ระบุ การตั้งค่านี้ใช้ได้ใน Android 9 ขึ้นไป โปรดทราบว่าแอปพลิเคชันสามารถจัดเก็บข้อมูลไว้นอกข้อมูลแอปพลิเคชันได้ เช่น ในที่จัดเก็บข้อมูลภายนอกหรือในพจนานุกรมผู้ใช้ ดู clearAppsDataParams เพิ่มเติม
START_LOST_MODE ทำให้อุปกรณ์เข้าสู่โหมดสูญหาย รองรับเฉพาะในอุปกรณ์ที่มีการจัดการครบวงจรหรืออุปกรณ์ขององค์กรที่มีโปรไฟล์ที่มีการจัดการเท่านั้น ดู startLostModeParams เพิ่มเติม
STOP_LOST_MODE นำอุปกรณ์ออกจากโหมดสูญหาย รองรับเฉพาะในอุปกรณ์ที่มีการจัดการครบวงจรหรืออุปกรณ์ขององค์กรที่มีโปรไฟล์ที่มีการจัดการเท่านั้น ดู stopLostModeParams เพิ่มเติม

CommandErrorCode

รหัสข้อผิดพลาดของคำสั่ง นี่คือฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น

Enum
COMMAND_ERROR_CODE_UNSPECIFIED ไม่มีข้อผิดพลาด
UNKNOWN เกิดข้อผิดพลาดที่ไม่รู้จัก
API_LEVEL ระดับ API ของอุปกรณ์ไม่รองรับคําสั่งนี้
MANAGEMENT_MODE โหมดการจัดการ (เจ้าของโปรไฟล์ เจ้าของอุปกรณ์ ฯลฯ) ไม่รองรับคําสั่งนี้
INVALID_VALUE คำสั่งมีค่าพารามิเตอร์ที่ไม่ถูกต้อง
UNSUPPORTED อุปกรณ์ไม่รองรับคําสั่งนี้ การอัปเดต Android Device Policy เป็นเวอร์ชันล่าสุดอาจแก้ปัญหาได้

ResetPasswordFlag

แฟล็กที่ใช้ได้สำหรับประเภทคำสั่ง RESET_PASSWORD

Enum
RESET_PASSWORD_FLAG_UNSPECIFIED ระบบจะละเว้นค่านี้
REQUIRE_ENTRY ไม่อนุญาตให้ผู้ดูแลระบบคนอื่นๆ เปลี่ยนรหัสผ่านอีกจนกว่าผู้ใช้จะป้อนรหัสผ่านดังกล่าว
DO_NOT_ASK_CREDENTIALS_ON_BOOT อย่าขอข้อมูลเข้าสู่ระบบของผู้ใช้เมื่อเปิดอุปกรณ์
LOCK_NOW ล็อกอุปกรณ์หลังจากรีเซ็ตรหัสผ่าน

ClearAppsDataParams

พารามิเตอร์ที่เชื่อมโยงกับคำสั่ง CLEAR_APP_DATA เพื่อล้างข้อมูลของแอปที่ระบุออกจากอุปกรณ์

การแสดง JSON 
{
  "packageNames": [
    string
  ]
}
ช่อง
packageNames[]

string

ชื่อแพ็กเกจของแอปที่จะล้างข้อมูลเมื่อเรียกใช้คำสั่ง

StartLostModeParams

พารามิเตอร์ที่เชื่อมโยงกับคำสั่ง START_LOST_MODE เพื่อให้อุปกรณ์เข้าสู่โหมดสูญหาย ต้องระบุพารามิเตอร์อย่างน้อย 1 รายการ (ไม่รวมชื่อองค์กร) เพื่อให้อุปกรณ์เข้าสู่โหมดสูญหาย

การแสดง JSON 
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
ช่อง
lostMessage

object (UserFacingMessage)

ข้อความที่แสดงต่อผู้ใช้เมื่ออุปกรณ์อยู่ในโหมดสูญหาย
lostPhoneNumber

object (UserFacingMessage)

หมายเลขโทรศัพท์ที่จะใช้โทรเมื่ออุปกรณ์อยู่ในโหมดสูญหายและแตะปุ่มโทรหาเจ้าของ
lostEmailAddress

string

อีเมลที่แสดงต่อผู้ใช้เมื่ออุปกรณ์อยู่ในโหมดสูญหาย
lostStreetAddress

object (UserFacingMessage)

ที่อยู่ที่แสดงต่อผู้ใช้เมื่ออุปกรณ์อยู่ในโหมดสูญหาย
lostOrganization

object (UserFacingMessage)

ชื่อองค์กรที่แสดงต่อผู้ใช้เมื่ออุปกรณ์อยู่ในโหมดสูญหาย

StopLostModeParams

ประเภทนี้ไม่มีช่อง

พารามิเตอร์ที่เชื่อมโยงกับคำสั่ง STOP_LOST_MODE เพื่อนำอุปกรณ์ออกจากโหมดสูญหาย

ClearAppsDataStatus

สถานะของคำสั่ง CLEAR_APP_DATA สำหรับล้างข้อมูลของแอปที่ระบุออกจากอุปกรณ์

การแสดง JSON 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
ช่อง
results

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

ผลลัพธ์ต่อแอป ซึ่งเป็นการแมปจากชื่อแพ็กเกจไปยังผลลัพธ์การล้างที่เกี่ยวข้อง

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

PerAppResult

ผลลัพธ์จากการพยายามล้างข้อมูลของแอปเดียว

การแสดง JSON 
{
  "clearingResult": enum (ClearingResult)
}
ช่อง
clearingResult

enum (ClearingResult)

ผลลัพธ์จากการพยายามล้างข้อมูลของแอปเดียว

ClearingResult

ผลลัพธ์จากการพยายามล้างข้อมูลของแอปเดียว

Enum
CLEARING_RESULT_UNSPECIFIED ผลลัพธ์ที่ไม่ระบุ
SUCCESS ล้างข้อมูลของแอปนี้เรียบร้อยแล้ว
APP_NOT_FOUND ล้างข้อมูลของแอปนี้ไม่ได้เนื่องจากไม่พบแอป
APP_PROTECTED ล้างข้อมูลของแอปนี้ไม่ได้ เนื่องจากแอปได้รับการปกป้อง ตัวอย่างเช่น นโยบายนี้อาจนำไปใช้กับแอปที่สำคัญต่อการทำงานของอุปกรณ์ เช่น Google Play Store
API_LEVEL ล้างข้อมูลของแอปนี้ไม่ได้เนื่องจากระดับ API ของอุปกรณ์ไม่รองรับคำสั่งนี้

StartLostModeStatus

สถานะของคำสั่ง START_LOST_MODE เพื่อให้อุปกรณ์เข้าสู่โหมดสูญหาย

การแสดง JSON 
{
  "status": enum (Status)
}
ช่อง
status

enum (Status)

สถานะ ดูStartLostModeStatus

สถานะ

สถานะ ดูStartLostModeStatus

Enum
STATUS_UNSPECIFIED ไม่ระบุ โดยไม่ได้ใช้ค่านี้
SUCCESS อุปกรณ์อยู่ในโหมดสูญหาย
RESET_PASSWORD_RECENTLY ทำให้อุปกรณ์อยู่ในโหมดสูญหายไม่ได้ เนื่องจากผู้ดูแลระบบรีเซ็ตรหัสผ่านของอุปกรณ์เมื่อเร็วๆ นี้
USER_EXIT_LOST_MODE_RECENTLY อุปกรณ์ไม่สามารถเข้าสู่โหมดสูญหายได้เนื่องจากผู้ใช้ออกจากโหมดสูญหายไปเมื่อเร็วๆ นี้
ALREADY_IN_LOST_MODE อุปกรณ์อยู่ในโหมดสูญหายอยู่แล้ว

StopLostModeStatus

สถานะของคำสั่ง STOP_LOST_MODE เพื่อนำอุปกรณ์ออกจากโหมดสูญหาย

การแสดง JSON 
{
  "status": enum (Status)
}
ช่อง
status

enum (Status)

สถานะ ดูStopLostModeStatus

สถานะ

สถานะ ดูStopLostModeStatus

Enum
STATUS_UNSPECIFIED ไม่ระบุ โดยไม่ได้ใช้ค่านี้
SUCCESS นำอุปกรณ์ออกจากโหมดสูญหายแล้ว
NOT_IN_LOST_MODE อุปกรณ์ไม่ได้อยู่ในโหมดสูญหาย