Devices

ดูรายการเมธอดสำหรับแหล่งข้อมูลนี้ได้ที่ส่วนท้ายของหน้านี้

การนำเสนอทรัพยากร

ทรัพยากรของอุปกรณ์หมายถึงอุปกรณ์เคลื่อนที่ที่จัดการโดย 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 ควบคุมอุปกรณ์ในการกำหนดค่าการติดตั้งใช้งานต่างๆ ค่าที่เป็นไปได้ ได้แก่ "managedDevice" อุปกรณ์ที่มีตัวควบคุมนโยบายด้านอุปกรณ์ (DPC) ของ EMM เป็นเจ้าของอุปกรณ์ "managedProfile" คืออุปกรณ์ที่มีโปรไฟล์ที่จัดการโดย DPC (DPC เป็นเจ้าของโปรไฟล์) นอกเหนือจากโปรไฟล์ส่วนตัวแยกต่างหากซึ่ง DPC เข้าถึงไม่ได้ "containerApp" ไม่ใช้แล้ว (เลิกใช้งานแล้ว) "unmanagedProfile" อุปกรณ์ที่ได้รับอนุญาต (จากผู้ดูแลระบบของโดเมน โดยใช้คอนโซลผู้ดูแลระบบเพื่อเปิดใช้สิทธิ์) ให้ใช้ Managed Google Play แต่ DPC ไม่ได้เป็นเจ้าของโปรไฟล์ดังกล่าว ค่าที่ยอมรับมีดังนี้ "containerApp" "managedDevice" "managedProfile" "unmanagedProfile"
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 ค่าที่ยอมรับมีดังนี้ "always" "choiceToTheUser" "never" "wifiOnly"
policy.deviceReportPolicy	string	ระบุว่าอุปกรณ์รายงานสถานะแอปไปยัง EMM หรือไม่ ค่าเริ่มต้นคือ "deviceReportDisabled" ค่าที่ยอมรับมีดังนี้ "deviceReportDisabled" "deviceReportEnabled"
policy.maintenanceWindow	nested object	ช่วงเวลาบำรุงรักษาที่กำหนดเวลาที่แอปที่ทำงานอยู่เบื้องหน้าควรได้รับการอัปเดต
policy.maintenanceWindow.durationMs	long	ระยะเวลาของช่วงเวลาบำรุงรักษาเป็นมิลลิวินาที ระยะเวลาต้องอยู่ระหว่าง 30 นาทีถึง 24 ชั่วโมง (รวม)
policy.maintenanceWindow.startTimeAfterMidnightMs	long	เวลาเริ่มต้นของช่วงเวลาบำรุงรักษาในอุปกรณ์เป็นมิลลิวินาทีหลังเที่ยงคืน หน้าต่างอาจครอบคลุมเวลาเที่ยงคืน
policy.productAvailabilityPolicy	string	ความพร้อมใช้งานที่ให้กับอุปกรณ์สำหรับผลิตภัณฑ์ที่ระบุ "ทั้งหมด" จะให้สิทธิ์แก่อุปกรณ์ในการเข้าถึงผลิตภัณฑ์ทั้งหมด โดยไม่คำนึงถึงสถานะการอนุมัติ "all" ไม่เปิดใช้งานการมองเห็นแทร็ก "อัลฟ่า" หรือ "เบต้า" โดยอัตโนมัติ "รายการที่อนุญาตพิเศษ" จะให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ที่ระบุใน productPolicy[] เฉพาะผลิตภัณฑ์ที่ได้รับอนุมัติหรือผลิตภัณฑ์ที่ได้รับอนุมัติก่อนหน้านี้ (ผลิตภัณฑ์ที่มีการอนุมัติที่ยกเลิก) โดยองค์กรเท่านั้นที่ได้รับอนุญาตให้อยู่ในรายการที่อนุญาตพิเศษ หากไม่ได้ระบุค่า ระบบจะใช้ความพร้อมจำหน่ายสินค้าที่ตั้งไว้ในระดับผู้ใช้โดยค่าเริ่มต้น ค่าที่ยอมรับมีดังนี้ "all" "whitelist"
policy.productPolicy[]	list	รายการนโยบายผลิตภัณฑ์ ต้องตั้งค่า productAvailabilityPolicy เป็น WHITELIST หรือ ALL เพื่อให้นโยบายผลิตภัณฑ์มีผล
policy.productPolicy[].autoInstallPolicy	nested object	นโยบายการติดตั้งอัตโนมัติสำหรับผลิตภัณฑ์
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]	list	ข้อจำกัดสำหรับการติดตั้งแอปโดยอัตโนมัติ คุณสามารถระบุข้อจำกัดได้ไม่เกิน 1 รายการ
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint	string	ข้อจำกัดสถานะการชาร์จ ค่าที่ยอมรับมีดังนี้ "chargingNotRequired" "chargingRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint	string	ข้อจำกัดสถานะไม่มีการใช้งานอุปกรณ์ ค่าที่ยอมรับมีดังนี้ "deviceIdleNotRequired" "deviceIdleRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint	string	ข้อจำกัดประเภทเครือข่าย ค่าที่ยอมรับมีดังนี้ "anyNetwork" "unmeteredNetwork"
policy.productPolicy[].autoInstallPolicy.autoInstallMode	string	โหมดการติดตั้งอัตโนมัติ หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็น "doNotAutoInstall" ระบบจะติดตั้งแอปโดยอัตโนมัติโดยไม่คำนึงถึงช่วงเวลาบำรุงรักษาที่ตั้งไว้ ค่าที่ยอมรับมีดังนี้ "autoInstallOnce" "doNotAutoInstall" "forceAutoInstall"
policy.productPolicy[].autoInstallPolicy.autoInstallPriority	integer	ลำดับความสำคัญของการติดตั้ง โดยเป็นจำนวนเต็มที่ไม่มีเครื่องหมาย ตัวเลขต่ำกว่าหมายถึงลำดับความสำคัญสูงกว่า
policy.productPolicy[].autoInstallPolicy.minimumVersionCode	integer	เวอร์ชันต่ำสุดของแอป หากติดตั้งแอปเวอร์ชันต่ำกว่า แอปจะได้รับการอัปเดตอัตโนมัติตามข้อจำกัดการติดตั้งอัตโนมัติแทนที่จะรออัปเดตอัตโนมัติตามปกติ คุณตั้งค่ารหัสเวอร์ชันขั้นต่ำสำหรับแอปได้สูงสุด 20 แอปต่ออุปกรณ์ 1 เครื่อง
policy.productPolicy[].autoUpdateMode	string	โหมดอัปเดตอัตโนมัติสำหรับผลิตภัณฑ์ เมื่อใช้ autoUpdateMode จะมีลำดับความสำคัญเหนือกว่าตัวเลือกของผู้ใช้เสมอ ดังนั้นเมื่อผู้ใช้เปลี่ยนการตั้งค่าอุปกรณ์ด้วยตนเอง ระบบจะไม่ดำเนินการใดๆ กับการเปลี่ยนแปลงเหล่านี้ ค่าที่ยอมรับมีดังนี้ "autoUpdateDefault" "autoUpdateHighPriority" "autoUpdatePostponed"
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	ความรุนแรงของสถานะแอป ช่องนี้จะปรากฏอยู่เสมอ ค่าที่ยอมรับมีดังนี้ "severityError" "severityInfo"
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