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
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
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 ในการกำหนดค่าการติดตั้งใช้งานต่างๆ

ค่าที่เป็นไปได้ ได้แก่
  • "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" อนุญาตให้ผู้ใช้อุปกรณ์กำหนดค่านโยบายการอัปเดตแอปได้ "เสมอ" เปิดใช้การอัปเดตอัตโนมัติ "ไม่เคย" จะปิดใช้การอัปเดตอัตโนมัติ "Wi-Fi เท่านั้น" เปิดใช้การอัปเดตอัตโนมัติเฉพาะเมื่ออุปกรณ์เชื่อมต่อกับ 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 ความพร้อมใช้งานที่มอบให้แก่อุปกรณ์สำหรับผลิตภัณฑ์ที่ระบุ "ทั้งหมด" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ทั้งหมด โดยไม่คำนึงถึงสถานะการอนุมัติ "ทั้งหมด" ไม่ได้เปิดใช้งานการเปิดเผย "อัลฟา" โดยอัตโนมัติ หรือ "เบต้า" "รายการที่อนุญาตพิเศษ" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ที่ระบุใน 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 แอปต่ออุปกรณ์
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_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 ความรุนแรงของสถานะแอป ช่องนี้จะปรากฏเสมอ

ค่าที่ยอมรับได้ มีดังนี้
  • "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 ในการกำหนดค่าที่มีการจัดการสำหรับ แพ็กเกจ Play ดูการจำกัด บัญชีใน Google Play