สําคัญ: เราไม่ยอมรับการลงทะเบียนใหม่สําหรับ Play EMM API อีกต่อไป ดูข้อมูลเพิ่มเติม

หน้านี้ได้รับการแปลโดย Cloud Translation API

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" หรือ "เบต้า" "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`	การประทับเวลาของการอัปเดตรายงานครั้งล่าสุดเป็นมิลลิวินาทีนับตั้งแต่เริ่มต้น ช่องนี้จะแสดงอยู่เสมอ
`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