ดูรายการเมธอดสำหรับแหล่งข้อมูลนี้ได้ที่ส่วนท้ายของหน้านี้
การนำเสนอทรัพยากร
ทรัพยากรของอุปกรณ์หมายถึงอุปกรณ์เคลื่อนที่ที่จัดการโดย 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 }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
androidId |
string |
รหัส Android ของบริการ Google Play สำหรับอุปกรณ์ที่เข้ารหัสเป็นสตริงเลขฐานสิบหกตัวพิมพ์เล็ก เช่น "123456789abcdef0" |
|
device |
string |
ชื่อรหัสฮาร์ดแวร์ภายในของอุปกรณ์ ข้อมูลนี้มาจาก android.os.Build.DEVICE (ฟิลด์ชื่อ "device" ต่อบันทึก/wireless/android/android_checkin.proto) |
|
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" ช่วยให้ผู้ใช้อุปกรณ์กำหนดค่านโยบายการอัปเดตแอปได้ "always" เปิดใช้การอัปเดตอัตโนมัติ "never" จะปิดอัปเดตอัตโนมัติ "wifiOnly" เปิดใช้การอัปเดตอัตโนมัติเฉพาะเมื่ออุปกรณ์เชื่อมต่อกับ Wi-Fi ค่าที่ยอมรับมีดังนี้
|
|
policy.deviceReportPolicy |
string |
ระบุว่าอุปกรณ์รายงานสถานะแอปไปยัง EMM หรือไม่ ค่าเริ่มต้นคือ "deviceReportDisabled"
ค่าที่ยอมรับมีดังนี้
|
|
policy.maintenanceWindow |
nested object |
ช่วงเวลาบำรุงรักษาที่กำหนดเวลาที่แอปที่ทำงานอยู่เบื้องหน้าควรได้รับการอัปเดต | |
policy.maintenanceWindow.durationMs |
long |
ระยะเวลาของช่วงเวลาบำรุงรักษาเป็นมิลลิวินาที ระยะเวลาต้องอยู่ระหว่าง 30 นาทีถึง 24 ชั่วโมง (รวม) | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
เวลาเริ่มต้นของช่วงเวลาบำรุงรักษาในอุปกรณ์เป็นมิลลิวินาทีหลังเที่ยงคืน หน้าต่างอาจครอบคลุมเวลาเที่ยงคืน | |
policy.productAvailabilityPolicy |
string |
ความพร้อมใช้งานที่ให้กับอุปกรณ์สำหรับผลิตภัณฑ์ที่ระบุ "ทั้งหมด" จะให้สิทธิ์แก่อุปกรณ์ในการเข้าถึงผลิตภัณฑ์ทั้งหมด โดยไม่คำนึงถึงสถานะการอนุมัติ "all" ไม่เปิดใช้งานการมองเห็นแทร็ก "อัลฟ่า" หรือ "เบต้า" โดยอัตโนมัติ "รายการที่อนุญาตพิเศษ" จะให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ที่ระบุใน 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 แอปต่ออุปกรณ์ 1 เครื่อง | |
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 ของพร็อพเพอร์ตี้ - จะปรากฏก็ต่อเมื่อประเภทของพร็อพเพอร์ตี้เป็น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 เพื่อป้องกัน XSS เราขอแนะนำให้คุณลบ HTML ออกจากข้อมูลก่อนแสดง | |
report.appState[].keyedAppState[].key |
string |
คีย์ที่บ่งบอกสถานะที่แอประบุ นักพัฒนาแอปจะเป็นผู้กำหนดเนื้อหาของคีย์ เพื่อป้องกัน XSS เราขอแนะนำให้คุณนำ HTML ออกจากคีย์ก่อนแสดง ช่องนี้จะปรากฏอยู่เสมอ | |
report.appState[].keyedAppState[].message |
string |
ข้อความรูปแบบอิสระที่มนุษย์อ่านได้ซึ่งอธิบายถึงสถานะของแอป เช่น ข้อความแสดงข้อผิดพลาด เพื่อป้องกัน XSS เราขอแนะนำให้คุณนำ HTML ออกจากข้อความก่อนแสดง | |
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
ในการกำหนดค่าที่มีการจัดการสำหรับแพ็กเกจ Google Play เพื่อบังคับใช้นโยบายอย่างถูกต้อง ดูจำกัดบัญชีใน Google Play