ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้
การนำเสนอแหล่งข้อมูล
ทรัพยากรของอุปกรณ์แสดงถึงอุปกรณ์เคลื่อนที่ที่จัดการโดย EMM และเป็นของผู้ใช้ระดับองค์กรที่เจาะจง
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
androidId |
string |
รหัส Android ของบริการ Google Play สำหรับอุปกรณ์ที่เข้ารหัสเป็นสตริงเลขฐาน 16 ตัวพิมพ์เล็ก เช่น "123456789abcdef0" |
|
device |
string |
ชื่อรหัสฮาร์ดแวร์ภายในของอุปกรณ์ ข้อความนี้มาจาก android.os.Build.DEVICE (ฟิลด์ชื่อ "device" ต่อไฟล์บันทึก/wireless/android/android_checkin.protocol) |
|
kind |
string |
||
latestBuildFingerprint |
string |
รหัสเฉพาะของบิลด์ของอุปกรณ์ หากทราบ | |
maker |
string |
ผู้ผลิตอุปกรณ์ ข้อความนี้มาจาก android.os.Build.MANUFACTURER |
|
managementType |
string |
ระบุขอบเขตที่อุปกรณ์ควบคุมโดย Managed Google Play EMM ในการกำหนดค่าการติดตั้งใช้งานต่างๆ ค่าที่เป็นไปได้ ได้แก่
ค่าที่ยอมรับได้ มีดังนี้
|
|
model |
string |
ชื่อรุ่นของอุปกรณ์ ข้อความนี้มาจาก android.os.Build.MODEL |
|
policy |
nested object |
นโยบายที่บังคับใช้ในอุปกรณ์ | |
policy.autoUpdatePolicy |
string |
ควบคุมว่าจะใช้การอัปเดตแอปอัตโนมัติในอุปกรณ์ได้เมื่อใด ทางเลือกที่แนะนำ: autoUpdateMode ที่ตั้งไว้สำหรับแต่ละแอปจะช่วยให้มีความยืดหยุ่นมากขึ้นสำหรับความถี่ในการอัปเดต เมื่อตั้งค่า autoUpdateMode เป็น AUTO_UPDATE_POSTPONED หรือ AUTO_UPDATE_HIGH_PRIORITY autoUpdatePolicy จะไม่มีผล "choiceToTheUser" อนุญาตให้ผู้ใช้อุปกรณ์กำหนดค่านโยบายการอัปเดตแอปได้ "เสมอ" เปิดใช้การอัปเดตอัตโนมัติ "ไม่เคย" จะปิดใช้การอัปเดตอัตโนมัติ "Wi-Fi เท่านั้น" เปิดใช้การอัปเดตอัตโนมัติเฉพาะเมื่ออุปกรณ์เชื่อมต่อกับ Wi-Fi ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.deviceReportPolicy |
string |
ระบุว่าอุปกรณ์รายงานสถานะของแอปไปยัง EMM หรือไม่ ค่าเริ่มต้นคือ "deviceReportDisabled"
ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.maintenanceWindow |
nested object |
ช่วงเวลาบำรุงรักษาซึ่งกำหนดเวลาที่ควรอัปเดตแอปที่ทำงานในเบื้องหน้า | |
policy.maintenanceWindow.durationMs |
long |
ระยะเวลาของช่วงเวลาบำรุงรักษาเป็นมิลลิวินาที ระยะเวลาต้องอยู่ระหว่าง 30 นาทีถึง 24 ชั่วโมง (รวม) | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
เวลาเริ่มต้นของช่วงเวลาบำรุงรักษาเป็นมิลลิวินาทีหลังเที่ยงคืนในอุปกรณ์ หน้าต่างอาจขยายไปจนถึงเที่ยงคืน | |
policy.productAvailabilityPolicy |
string |
ความพร้อมใช้งานที่มอบให้แก่อุปกรณ์สำหรับผลิตภัณฑ์ที่ระบุ "ทั้งหมด" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ทั้งหมด โดยไม่คำนึงถึงสถานะการอนุมัติ "ทั้งหมด" ไม่ได้เปิดใช้งานการเปิดเผย "อัลฟา" โดยอัตโนมัติ หรือ "เบต้า" "รายการที่อนุญาตพิเศษ" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ที่ระบุใน productPolicy[] เฉพาะผลิตภัณฑ์ที่ได้รับอนุมัติหรือผลิตภัณฑ์ที่เคยได้รับการอนุมัติก่อนหน้านี้ (ผลิตภัณฑ์ที่องค์กรเพิกถอน) เท่านั้นที่จะได้รับอนุญาตเป็นพิเศษได้ หากไม่ได้ระบุค่าไว้ ระบบจะใช้ความพร้อมใช้งานที่กำหนดไว้ที่ระดับผู้ใช้โดยค่าเริ่มต้น
ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.productPolicy[] |
list |
รายการนโยบายผลิตภัณฑ์ ต้องตั้งค่า productAvailabilityPolicy เป็น WHITELIST หรือ ALL เพื่อให้นโยบายผลิตภัณฑ์มีผล |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
นโยบายการติดตั้งอัตโนมัติสำหรับผลิตภัณฑ์ | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
ข้อจำกัดสำหรับการติดตั้งแอปโดยอัตโนมัติ คุณสามารถระบุข้อจำกัดได้สูงสุด 1 ข้อ |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
ข้อจำกัดด้านสถานะการชาร์จ
ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
ข้อจำกัดสถานะไม่มีการใช้งานอุปกรณ์
ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
ข้อจำกัดประเภทเครือข่าย
ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
โหมดติดตั้งอัตโนมัติ หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้นเป็น "doNotAutoInstall" แอปจะติดตั้งโดยอัตโนมัติโดยไม่คำนึงถึงช่วงเวลาบำรุงรักษาที่กำหนดไว้
ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
ลำดับความสำคัญของการติดตั้ง เป็นจำนวนเต็มที่ไม่มีเครื่องหมาย จำนวนที่ต่ำกว่าหมายถึงลำดับความสำคัญที่สูงกว่า | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
เวอร์ชันต่ำสุดของแอป หากติดตั้งแอปเวอร์ชันต่ำกว่า แอปจะอัปเดตอัตโนมัติตามข้อจำกัดการติดตั้งอัตโนมัติ แทนที่จะต้องรอการอัปเดตอัตโนมัติตามปกติ คุณจะตั้งรหัสเวอร์ชันขั้นต่ำสำหรับแอปได้สูงสุด 20 แอปต่ออุปกรณ์ | |
policy.productPolicy[].autoUpdateMode |
string |
โหมดการอัปเดตอัตโนมัติสำหรับผลิตภัณฑ์ เมื่อใช้ autoUpdateMode ระบบจะให้ความสำคัญกับตัวเลือกของผู้ใช้มากกว่าตัวเลือกของผู้ใช้ ดังนั้นเมื่อผู้ใช้เปลี่ยนแปลงการตั้งค่าอุปกรณ์ด้วยตนเอง ระบบจะไม่สนใจการเปลี่ยนแปลงเหล่านี้
ค่าที่ยอมรับได้ มีดังนี้
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
การกำหนดค่า URL การตรวจสอบสิทธิ์สำหรับแอป Authenticator ของผู้ให้บริการข้อมูลประจำตัว วิธีนี้จะช่วยในการเปิดแอป Authenticator ของผู้ให้บริการข้อมูลประจำตัวในระหว่างการตรวจสอบสิทธิ์ในแอปส่วนตัวโดยใช้ Android WebView แอป Authenticator ควรเป็น เครื่องจัดการเริ่มต้นสำหรับ URL การตรวจสอบสิทธิ์ในอุปกรณ์อยู่แล้ว | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
URL การตรวจสอบสิทธิ์ | |
policy.productPolicy[].managedConfiguration |
nested object |
การกำหนดค่าที่มีการจัดการสำหรับผลิตภัณฑ์ | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
ประกอบด้วยรหัสของโปรไฟล์การกำหนดค่าที่มีการจัดการและชุดตัวแปรการกำหนดค่า (หากมี) ที่กำหนดไว้สำหรับผู้ใช้ | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
รหัสของการตั้งค่าการกำหนดค่าที่มีการจัดการ | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
ชุดตัวแปรที่มีการระบุแหล่งที่มาของผู้ใช้ | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
สตริงตัวยึดตำแหน่ง กำหนดโดย EMM | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
ค่าของตัวยึดตำแหน่งที่เจาะจงสำหรับผู้ใช้ | |
policy.productPolicy[].managedConfiguration.kind |
string |
เลิกใช้งานแล้ว |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
ชุดของพร็อพเพอร์ตี้ที่มีการจัดการสำหรับการกำหนดค่านี้ | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
คีย์ที่ไม่ซ้ำกันที่ระบุพร็อพเพอร์ตี้ | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
ค่าบูลีน - ค่านี้จะแสดงก็ต่อเมื่อประเภทของพร็อพเพอร์ตี้เป็นบูลีนเท่านั้น | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
กลุ่มพร็อพเพอร์ตี้ที่มีการจัดการ - จะแสดงต่อเมื่อประเภทของพร็อพเพอร์ตี้เป็นกลุ่มเท่านั้น | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
รายการพร็อพเพอร์ตี้ที่มีการจัดการ | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
รายการแพ็กเกจพร็อพเพอร์ตี้ - จะแสดงต่อเมื่อประเภทของพร็อพเพอร์ตี้คือbundle_array | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
รายการพร็อพเพอร์ตี้ที่มีการจัดการ | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
ค่าจำนวนเต็ม - ค่านี้จะปรากฏก็ต่อเมื่อประเภทของพร็อพเพอร์ตี้เป็นจำนวนเต็ม | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
ค่าสตริง - ค่านี้จะแสดงก็ต่อเมื่อประเภทของพร็อพเพอร์ตี้เป็นสตริง ตัวเลือก หรือ ซ่อน | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
รายการค่าสตริง - จะปรากฏต่อเมื่อประเภทของพร็อพเพอร์ตี้เป็นแบบเลือกหลายรายการเท่านั้น | |
policy.productPolicy[].managedConfiguration.productId |
string |
รหัสของผลิตภัณฑ์ที่ใช้การกำหนดค่าที่มีการจัดการ เช่น "app:com.google.android.gm" | |
policy.productPolicy[].productId |
string |
รหัสของผลิตภัณฑ์ เช่น "app:com.google.android.gm" |
|
policy.productPolicy[].trackIds[] |
list |
ให้ระดับการเข้าถึงอุปกรณ์แก่แทร็กการเผยแพร่ผลิตภัณฑ์ที่ระบุ ซึ่งระบุโดย trackIds คุณดูรายการการติดตามการเผยแพร่ของผลิตภัณฑ์ได้โดยการโทรหา Products.Get |
|
policy.productPolicy[].tracks[] |
list |
เลิกใช้งานแล้ว โปรดใช้ trackIds แทน |
|
product |
string |
ชื่อผลิตภัณฑ์ของอุปกรณ์ ข้อความนี้มาจาก android.os.Build.PRODUCT |
|
report |
nested object |
รายงานอุปกรณ์มีการอัปเดตสถานะแอปล่าสุด | |
report.appState[] |
list |
รายการสถานะของแอปที่แอปที่มีการจัดการในอุปกรณ์กำหนด นักพัฒนาแอปเป็นผู้กำหนดสถานะแอป ช่องนี้จะปรากฏเสมอ | |
report.appState[].keyedAppState[] |
list |
รายการสถานะของแอปคีย์ ช่องนี้จะปรากฏเสมอ | |
report.appState[].keyedAppState[].data |
string |
ช่องเพิ่มเติมสำหรับข้อมูลที่เครื่องอ่านได้ เช่น ตัวเลขหรือออบเจ็กต์ JSON เราขอแนะนำให้นำ HTML ออกจากข้อมูลก่อนแสดงผลเพื่อป้องกัน XSS | |
report.appState[].keyedAppState[].key |
string |
คีย์ที่ระบุสถานะของแอป นักพัฒนาแอปเป็นผู้กำหนดเนื้อหาของคีย์ เราขอแนะนำให้นำ HTML ออกจากคีย์ก่อนแสดง XSS ช่องนี้จะปรากฏเสมอ | |
report.appState[].keyedAppState[].message |
string |
ข้อความรูปแบบอิสระที่มนุษย์อ่านได้ซึ่งอธิบายถึงสถานะของแอป เช่น ข้อความแสดงข้อผิดพลาด เราขอแนะนำให้นำ HTML ออกจากข้อความก่อนแสดงเพื่อป้องกัน XSS | |
report.appState[].keyedAppState[].severity |
string |
ความรุนแรงของสถานะแอป ช่องนี้จะปรากฏเสมอ
ค่าที่ยอมรับได้ มีดังนี้
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
การประทับเวลาที่แอปตั้งค่าสถานะเป็นมิลลิวินาทีตั้งแต่ Epoch ช่องนี้จะปรากฏเสมอ | |
report.appState[].packageName |
string |
ชื่อแพ็กเกจของแอป ช่องนี้จะปรากฏเสมอ | |
report.lastUpdatedTimestampMillis |
long |
การประทับเวลาของการอัปเดตรายงานล่าสุดเป็นมิลลิวินาทีนับตั้งแต่ Epoch ช่องนี้จะปรากฏเสมอ | |
retailBrand |
string |
แบรนด์ค้าปลีกของอุปกรณ์ (หากมี) โปรดดู android.os.Build.BRAND |
|
sdkVersion |
integer |
เวอร์ชันความเข้ากันได้กับ API |
เมธอด
- forceReportUpload
- อัปโหลดรายงานที่มีการเปลี่ยนแปลงสถานะของแอปในอุปกรณ์ตั้งแต่ มีการสร้างรายงานล่าสุดขึ้น คุณเรียกใช้วิธีการนี้ได้สูงสุด 3 ครั้งทุก 24 ชั่วโมงสำหรับอุปกรณ์แต่ละชิ้น
- รับ
- เรียกดูรายละเอียดของอุปกรณ์
- getState
- เรียกข้อมูลว่าการเข้าถึงบริการของ Google ของอุปกรณ์เปิดอยู่หรือ ปิดใช้อยู่ สถานะของอุปกรณ์จะมีผลก็ต่อเมื่อบังคับใช้นโยบาย EMM ใน Android เท่านั้น มีการเปิดใช้งานในคอนโซลผู้ดูแลระบบของ Google มิเช่นนั้น ระบบจะไม่สนใจสถานะของอุปกรณ์และอนุญาตให้เข้าถึงอุปกรณ์ทั้งหมดได้ บริการของ Google การดำเนินการนี้รองรับเฉพาะผู้ใช้ที่จัดการโดย Google
- list
- เรียกข้อมูลรหัสของอุปกรณ์ทั้งหมดของผู้ใช้
- setState
- ตั้งค่าว่าจะเปิดหรือปิดใช้บริการต่างๆ ของ Google สำหรับอุปกรณ์ สถานะของอุปกรณ์จะมีผลก็ต่อเมื่อบังคับใช้นโยบาย EMM ใน Android เท่านั้น มีการเปิดใช้งานในคอนโซลผู้ดูแลระบบของ Google มิเช่นนั้น ระบบจะไม่สนใจสถานะของอุปกรณ์และอนุญาตให้เข้าถึงอุปกรณ์ทั้งหมดได้ บริการของ Google การดำเนินการนี้รองรับเฉพาะผู้ใช้ที่จัดการโดย Google
- อัปเดต
- อัปเดตนโยบายด้านอุปกรณ์
คุณต้องป้องกันไม่ให้ไม่มีการจัดการ ไม่สามารถเข้าถึง Google Play โดยตั้งค่าallowed_accounts
ในการกำหนดค่าที่มีการจัดการสำหรับ แพ็กเกจ Play ดูการจำกัด บัญชีใน Google Play