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 ให้ระบุ Flag (ไม่บังคับ)

ฟิลด์สหภาพ 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 เป็นเวอร์ชันล่าสุดอาจช่วยแก้ปัญหานี้ได้

ResetPasswordFlag

Flag ที่ใช้กับคำสั่งประเภท 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 อุปกรณ์ไม่ได้อยู่ในโหมดสูญหาย