- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- คำสั่ง
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- สถานะ
- StopLostModeStatus
- สถานะ
- ลองใช้งาน
ออกคำสั่งให้กับอุปกรณ์ ทรัพยากร Operation
ที่แสดงผลมี Command
ในช่อง metadata
ใช้ get Operations Method เพื่อรับสถานะของคำสั่ง
คำขอ HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
name |
ชื่อของอุปกรณ์ในรูปแบบ |
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ Command
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/androidmanagement
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
คำสั่ง
คำสั่ง
การแสดง JSON |
---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ประเภทของคำสั่ง |
create |
การประทับเวลาที่สร้างคําสั่ง เซิร์ฟเวอร์จะสร้างการประทับเวลาโดยอัตโนมัติ การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: |
duration |
ระยะเวลาที่คำสั่งใช้งานได้ คำสั่งจะหมดอายุหากอุปกรณ์ไม่ดำเนินการในระหว่างนี้ ระยะเวลาเริ่มต้นหากไม่ระบุคือ 10 นาที ไม่มีระยะเวลาสูงสุด ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย " |
user |
ชื่อทรัพยากรของผู้ใช้ที่เป็นเจ้าของอุปกรณ์ในรูปแบบ |
error |
หากคำสั่งไม่สำเร็จ จะมีรหัสข้อผิดพลาดที่อธิบายการทำงานล้มเหลว ระบบจะไม่ตั้งค่านี้เมื่อผู้โทรยกเลิกคำสั่ง |
new |
สําหรับคําสั่งประเภท |
reset |
สำหรับคำสั่งประเภท |
ช่องการรวม หากตั้งค่านี้ไว้ จะต้องไม่ตั้งค่าช่อง |
|
clear |
พารามิเตอร์สำหรับคำสั่ง |
start |
พารามิเตอร์สำหรับคำสั่ง |
stop |
พารามิเตอร์สำหรับคำสั่ง |
ฟิลด์สหภาพ status สถานะที่เฉพาะเจาะจงสำหรับคำสั่ง โปรดทราบว่าคําสั่งบางรายการไม่ได้ใช้รูปแบบนี้ โดยเฉพาะ , , และ ในอนาคตคำสั่งเหล่านี้อาจใช้รูปแบบนี้ด้วย status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
clear |
เอาต์พุตเท่านั้น สถานะของคําสั่ง |
start |
เอาต์พุตเท่านั้น สถานะของคำสั่ง |
stop |
เอาต์พุตเท่านั้น สถานะของคำสั่ง |
CommandType
ประเภทของคำสั่ง
Enum | |
---|---|
COMMAND_TYPE_UNSPECIFIED |
ระบบไม่อนุญาตค่านี้ |
LOCK |
ล็อกอุปกรณ์ ราวกับว่าหน้าจอล็อกหมดเวลา |
RESET_PASSWORD |
รีเซ็ตรหัสผ่านของผู้ใช้ |
REBOOT |
รีบูตอุปกรณ์ รองรับเฉพาะในอุปกรณ์ที่มีการจัดการครบวงจรซึ่งใช้ Android 7.0 (API ระดับ 24) ขึ้นไปเท่านั้น |
RELINQUISH_OWNERSHIP |
นำโปรไฟล์งานและนโยบายทั้งหมดออกจากอุปกรณ์ Android 8.0 ขึ้นไปของบริษัท ทำให้เลิกใช้อุปกรณ์เพื่อการใช้งานส่วนตัว แอปและข้อมูลที่เชื่อมโยงกับโปรไฟล์ส่วนตัวดังกล่าวจะยังคงอยู่ ระบบจะลบอุปกรณ์ออกจากเซิร์ฟเวอร์หลังจากรับทราบคำสั่งแล้ว |
CLEAR_APP_DATA |
ล้างข้อมูลแอปพลิเคชันของแอปที่ระบุ ฟีเจอร์นี้ใช้ได้ใน Android 9 ขึ้นไป โปรดทราบว่าแอปพลิเคชันสามารถจัดเก็บข้อมูลนอกข้อมูลแอปพลิเคชัน เช่น ในที่จัดเก็บข้อมูลภายนอกหรือในพจนานุกรมของผู้ใช้ ดู เพิ่มเติม |
START_LOST_MODE |
ทำให้อุปกรณ์เข้าสู่โหมดสูญหาย รองรับเฉพาะในอุปกรณ์ที่มีการจัดการครบวงจรหรืออุปกรณ์ขององค์กรซึ่งมีโปรไฟล์ที่มีการจัดการเท่านั้น ดู เพิ่มเติม |
STOP_LOST_MODE |
นำอุปกรณ์ออกจากโหมดสูญหาย ใช้ได้เฉพาะในอุปกรณ์ที่มีการจัดการครบวงจรหรืออุปกรณ์ของบริษัทที่มีโปรไฟล์ที่มีการจัดการ ดู เพิ่มเติม |
CommandErrorCode
รหัสข้อผิดพลาดของคำสั่ง ฟิลด์นี้เป็นฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น
Enum | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED |
ไม่มีข้อผิดพลาด |
UNKNOWN |
เกิดข้อผิดพลาดที่ไม่รู้จัก |
API_LEVEL |
ระดับ API ของอุปกรณ์ไม่รองรับคําสั่งนี้ |
MANAGEMENT_MODE |
โหมดการจัดการ (เจ้าของโปรไฟล์ เจ้าของอุปกรณ์ ฯลฯ) ไม่สนับสนุนคำสั่งนี้ |
INVALID_VALUE |
คำสั่งมีค่าพารามิเตอร์ที่ไม่ถูกต้อง |
UNSUPPORTED |
อุปกรณ์ไม่รองรับคำสั่งนี้ การอัปเดตนโยบายอุปกรณ์ Android เป็นเวอร์ชันล่าสุดอาจช่วยแก้ปัญหานี้ได้ |
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 ] } |
ช่อง | |
---|---|
package |
ชื่อแพ็กเกจของแอปที่จะล้างข้อมูลเมื่อเรียกใช้คําสั่ง |
StartLostModeParams
พารามิเตอร์ที่เชื่อมโยงกับคำสั่ง
เพื่อทำให้อุปกรณ์เข้าสู่โหมดสูญหาย คุณต้องระบุพารามิเตอร์อย่างน้อย 1 รายการ (ไม่รวมชื่อองค์กร) เพื่อให้อุปกรณ์เข้าสู่โหมดสูญหายSTART_LOST_MODE
การแสดง JSON |
---|
{ "lostMessage": { object ( |
ช่อง | |
---|---|
lost |
ข้อความที่แสดงต่อผู้ใช้เมื่ออุปกรณ์อยู่ในโหมดสูญหาย |
lost |
หมายเลขโทรศัพท์ที่จะใช้โทรเมื่ออุปกรณ์อยู่ในโหมดสูญหายและมีการแตะปุ่มเจ้าของการโทร |
lost |
อีเมลที่แสดงต่อผู้ใช้เมื่ออุปกรณ์อยู่ในโหมดสูญหาย |
lost |
ที่อยู่ที่แสดงให้ผู้ใช้เห็นเมื่ออุปกรณ์อยู่ในโหมดสูญหาย |
lost |
ชื่อองค์กรที่แสดงต่อผู้ใช้เมื่ออุปกรณ์อยู่ในโหมดสูญหาย |
StopLostModeParams
ประเภทนี้ไม่มีช่อง
พารามิเตอร์ที่เชื่อมโยงกับคำสั่ง
เพื่อนำอุปกรณ์ออกจากโหมดสูญหายSTOP_LOST_MODE
ClearAppsDataStatus
สถานะของคำสั่ง
เพื่อล้างข้อมูลของแอปที่ระบุออกจากอุปกรณ์CLEAR_APP_DATA
การแสดง JSON |
---|
{
"results": {
string: {
object ( |
ช่อง | |
---|---|
results |
ผลลัพธ์ต่อแอป ซึ่งเป็นการแมปจากชื่อแพ็กเกจไปยังผลลัพธ์การล้างข้อมูลที่เกี่ยวข้อง ออบเจ็กต์ที่มีรายการคู่ |
PerAppResult
ผลลัพธ์ของการพยายามล้างข้อมูลของแอปเดียว
การแสดง JSON |
---|
{
"clearingResult": enum ( |
ช่อง | |
---|---|
clearing |
ผลลัพธ์จากการพยายามล้างข้อมูลของแอปเดียว |
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 |
สถานะ ดู |
สถานะ
สถานะ ดู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 |
สถานะ ดู |
สถานะ
สถานะ ดูStopLostModeStatus
Enum | |
---|---|
STATUS_UNSPECIFIED |
ไม่ระบุ ไม่ได้ใช้ค่านี้ |
SUCCESS |
นำอุปกรณ์ออกจากโหมดสูญหายแล้ว |
NOT_IN_LOST_MODE |
อุปกรณ์ไม่ได้อยู่ในโหมดสูญหาย |