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