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,
    "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 ในการกำหนดค่าต่างๆ ของการใช้งาน

ค่าที่เป็นไปได้ ได้แก่
  • "managedDevice" ซึ่งเป็นอุปกรณ์ที่มีเครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC) ของ EMM เป็นเจ้าของอุปกรณ์
  • "managedProfile" เป็นอุปกรณ์ที่มีโปรไฟล์ที่จัดการโดย DPC (DPC คือเจ้าของโปรไฟล์) นอกเหนือจากโปรไฟล์ส่วนตัวแยกต่างหากที่ DPC ไม่สามารถเข้าถึงได้
  • "containerApp" ไม่ใช้งานแล้ว (เลิกใช้งานแล้ว)
  • "unmanagedProfile" เป็นอุปกรณ์ที่ได้รับอนุญาตให้ใช้ (โดยผู้ดูแลระบบของโดเมนที่ใช้คอนโซลผู้ดูแลระบบเพื่อเปิดใช้สิทธิ์) 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.policyId string ตัวระบุนโยบายที่จะส่งพร้อมกับความคิดเห็นเกี่ยวกับการติดตั้งแอปที่ส่งจาก Play Store
policy.productAvailabilityPolicy string ความพร้อมจำหน่ายที่อนุญาตให้อุปกรณ์สำหรับผลิตภัณฑ์ที่ระบุ "all" ให้สิทธิ์เข้าถึงผลิตภัณฑ์ทั้งหมดแก่อุปกรณ์ โดยไม่คำนึงถึงสถานะการอนุมัติ "all" จะไม่เปิดใช้การแสดงผลอัตโนมัติของแทร็ก "alpha" หรือ "เบต้า" "รายการที่อนุญาตพิเศษ" ให้สิทธิ์อุปกรณ์เข้าถึงผลิตภัณฑ์ที่ระบุใน 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 การประทับเวลาของการอัปเดตรายงานครั้งล่าสุดเป็นมิลลิวินาทีนับตั้งแต่เริ่มต้น ช่องนี้จะแสดงอยู่เสมอ
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