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

คุณต้องป้องกันไม่ให้ไม่มีการจัดการ ไม่สามารถเข้าถึง Google Play โดยตั้งค่า allowed_accounts ในการกำหนดค่าที่มีการจัดการสำหรับ แพ็กเกจ Play ดูการจำกัด บัญชีใน Google Play