ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้
การนําเสนอทรัพยากร
ทรัพยากรของอุปกรณ์แสดงถึงอุปกรณ์เคลื่อนที่ที่จัดการโดย 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 จะไม่มีผล "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.policyId |
string |
ตัวระบุของนโยบายที่จะส่งพร้อมกับความคิดเห็นเรื่องการติดตั้งแอปที่ส่งจาก Play Store | |
policy.productAvailabilityPolicy |
string |
ความพร้อมจำหน่ายที่อนุญาตให้อุปกรณ์สำหรับผลิตภัณฑ์ที่ระบุ "ทั้งหมด" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ทั้งหมด โดยไม่คำนึงถึงสถานะการอนุมัติ "all" จะไม่เปิดใช้การแสดงผลอัตโนมัติของแทร็ก "alpha" หรือ "เบต้า" "whitelist" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ที่ระบุใน 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 เพื่อป้องกัน XSS เราขอแนะนําให้นํา HTML ออกจากข้อมูลก่อนที่จะแสดง | |
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 ชั่วโมงสำหรับอุปกรณ์แต่ละชิ้น
- get
- เรียกดูรายละเอียดของอุปกรณ์
- getState
- ดึงข้อมูลว่าอุปกรณ์เปิดหรือปิดใช้สิทธิ์เข้าถึงบริการของ Google อยู่ สถานะของอุปกรณ์จะมีผลก็ต่อเมื่อบังคับใช้นโยบาย EMM ใน Android เท่านั้น มีการเปิดใช้งานในคอนโซลผู้ดูแลระบบของ Google มิเช่นนั้น ระบบจะไม่สนใจสถานะของอุปกรณ์และอนุญาตให้เข้าถึงอุปกรณ์ทั้งหมดได้ บริการของ Google การดำเนินการนี้ใช้ได้กับผู้ใช้ที่ Google จัดการเท่านั้น
- list
- ดึงข้อมูลรหัสของอุปกรณ์ทั้งหมดของผู้ใช้
- setState
- ตั้งค่าว่าจะเปิดหรือปิดใช้สิทธิ์เข้าถึงบริการของ Google ในอุปกรณ์ สถานะอุปกรณ์จะมีผลเฉพาะในกรณีที่เปิดใช้การบังคับใช้นโยบาย EMM ในอุปกรณ์ Android ในคอนโซลผู้ดูแลระบบของ Google มิเช่นนั้น ระบบจะไม่สนใจสถานะของอุปกรณ์และอนุญาตให้เข้าถึงอุปกรณ์ทั้งหมดได้ บริการของ Google การดำเนินการนี้รองรับเฉพาะผู้ใช้ที่จัดการโดย Google
- อัปเดต
- อัปเดตนโยบายด้านอุปกรณ์
คุณต้องป้องกันไม่ให้ไม่มีการจัดการ ไม่สามารถเข้าถึง Google Play โดยตั้งค่าallowed_accounts
ในการกำหนดค่าที่มีการจัดการสำหรับ แพ็กเกจ Play ดูการจำกัด บัญชีใน Google Play