ดูรายการวิธีการสำหรับแหล่งข้อมูลนี้ได้ที่ท้ายหน้า
การนำเสนอแหล่งข้อมูล
ทรัพยากรของอุปกรณ์แสดงถึงอุปกรณ์เคลื่อนที่ที่จัดการโดย 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, "policyId": 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" ตาม logs/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
ลายนิ้วมือของบิลด์ของอุปกรณ์ หากทราบ | |
maker |
string |
ผู้ผลิตอุปกรณ์ ข้อความนี้มาจาก android.os.Build.MANUFACTURER |
|
managementType |
string |
ระบุระดับที่อุปกรณ์ได้รับการควบคุมโดย EMM ของ Managed Google Play ในการกำหนดค่าต่างๆ ของการใช้งาน ค่าที่เป็นไปได้ ได้แก่
ค่าที่ยอมรับมีดังนี้
|
|
model |
string |
ชื่อรุ่นของอุปกรณ์ ข้อความนี้มาจาก android.os.Build.MODEL |
|
policy |
nested object |
นโยบายที่บังคับใช้ในอุปกรณ์ | |
policy.autoUpdatePolicy |
string |
ควบคุมเวลาที่ต้องการให้ใช้การอัปเดตแอปอัตโนมัติในอุปกรณ์ ทางเลือกที่แนะนำ: autoUpdateMode ซึ่งตั้งค่าต่อแอปจะมีความยืดหยุ่นมากขึ้นเกี่ยวกับความถี่ในการอัปเดต เมื่อตั้งค่า autoUpdateMode เป็น AUTO_UPDATE_POSTPONED หรือ AUTO_UPDATE_HIGH_PRIORITY autoUpdatePolicy จะไม่มีผล
ค่าที่ยอมรับมีดังนี้
|
|
policy.deviceReportPolicy |
string |
อุปกรณ์จะรายงานสถานะแอปไปยัง EMM หรือไม่ ค่าเริ่มต้นคือ "deviceReportDisabled"
ค่าที่ยอมรับมีดังนี้
|
|
policy.maintenanceWindow |
nested object |
ช่วงเวลาบำรุงรักษาที่กำหนดว่าควรอัปเดตแอปที่ทำงานอยู่เบื้องหน้าเมื่อใด | |
policy.maintenanceWindow.durationMs |
long |
ระยะเวลาของช่วงเวลาบำรุงรักษาเป็นมิลลิวินาที ระยะเวลาต้องอยู่ระหว่าง 30 นาทีถึง 24 ชั่วโมง (รวม) | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
เวลาเริ่มต้นของช่วงเวลาบำรุงรักษาเป็นมิลลิวินาทีหลังเที่ยงคืนในอุปกรณ์ หน้าต่างอาจขยายไปจนถึงเที่ยงคืน | |
policy.policyId |
string |
ตัวระบุนโยบายที่จะส่งพร้อมกับความคิดเห็นเกี่ยวกับการติดตั้งแอปที่ส่งจาก Play Store | |
policy.productAvailabilityPolicy |
string |
ความพร้อมจำหน่ายที่อนุญาตให้อุปกรณ์สำหรับผลิตภัณฑ์ที่ระบุ "all" ให้สิทธิ์เข้าถึงผลิตภัณฑ์ทั้งหมดแก่อุปกรณ์ โดยไม่คำนึงถึงสถานะการอนุมัติ "all" จะไม่เปิดใช้การแสดงผลอัตโนมัติของแทร็ก "alpha" หรือ "เบต้า" "รายการที่อนุญาตพิเศษ" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ที่ระบุใน 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 |
การประทับเวลาของการอัปเดตรายงานครั้งล่าสุดเป็นมิลลิวินาทีนับตั้งแต่เริ่มต้น ช่องนี้จะแสดงอยู่เสมอ | |
retailBrand |
string |
แบรนด์ค้าปลีกของอุปกรณ์ (หากมี) โปรดดู android.os.Build.BRAND |
|
sdkVersion |
integer |
เวอร์ชันความเข้ากันได้ของ API |
เมธอด
- forceReportUpload
- อัปโหลดรายงานที่มีการเปลี่ยนแปลงสถานะแอปในอุปกรณ์นับตั้งแต่สร้างรายงานครั้งล่าสุด คุณสามารถเรียกใช้เมธอดนี้ได้สูงสุด 3 ครั้งทุก 24 ชั่วโมงสําหรับอุปกรณ์หนึ่งๆ
- get
- เรียกดูรายละเอียดของอุปกรณ์
- getState
- ดึงข้อมูลว่าอุปกรณ์เปิดหรือปิดใช้สิทธิ์เข้าถึงบริการของ Google อยู่ สถานะอุปกรณ์จะมีผลเฉพาะในกรณีที่เปิดใช้การบังคับใช้นโยบาย EMM ในอุปกรณ์ Android ในคอนโซลผู้ดูแลระบบของ Google มิเช่นนั้น ระบบจะไม่สนใจสถานะของอุปกรณ์ และอนุญาตให้อุปกรณ์ทุกเครื่องเข้าถึงบริการของ Google การดำเนินการนี้ใช้ได้กับผู้ใช้ที่ Google จัดการเท่านั้น
- list
- ดึงข้อมูลรหัสของอุปกรณ์ทั้งหมดของผู้ใช้
- setState
- ตั้งค่าว่าจะเปิดหรือปิดใช้สิทธิ์เข้าถึงบริการของ Google ในอุปกรณ์ สถานะอุปกรณ์จะมีผลเฉพาะในกรณีที่เปิดใช้การบังคับใช้นโยบาย EMM ในอุปกรณ์ Android ในคอนโซลผู้ดูแลระบบของ Google มิเช่นนั้น ระบบจะไม่สนใจสถานะของอุปกรณ์และอนุญาตให้อุปกรณ์ทั้งหมดเข้าถึงบริการของ Google ได้ การดำเนินการนี้ใช้ได้กับผู้ใช้ที่ Google จัดการเท่านั้น
- update
- อัปเดตนโยบายด้านอุปกรณ์
คุณต้องป้องกันไม่ให้บัญชีที่ไม่ได้รับการจัดการเข้าถึง Google Play โดยการตั้งค่าallowed_accounts
ในการกำหนดค่าที่มีการจัดการสำหรับแพ็กเกจ Google Play เพื่อให้แน่ใจว่านโยบายได้รับการบังคับใช้อย่างถูกต้อง ดูจํากัดบัญชีใน Google Play