Users

ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้

การนำเสนอแหล่งข้อมูล

ทรัพยากรผู้ใช้แสดงถึงบัญชีที่เชื่อมโยงกับองค์กร โดยบัญชีอาจเจาะจงเฉพาะอุปกรณ์หรือผู้ใช้แต่ละคน (ซึ่งใช้บัญชีดังกล่าวในอุปกรณ์หลายเครื่องได้) บัญชีอาจให้สิทธิ์เข้าถึง Managed Google Play เท่านั้น หรือบริการอื่นๆ ของ Google โดยขึ้นอยู่กับโมเดลข้อมูลประจำตัว ดังนี้

  • โมเดลข้อมูลประจำตัวของโดเมนที่มีการจัดการของ Google กำหนดให้ซิงค์กับแหล่งที่มาของบัญชี Google (ผ่าน primaryEmail)
  • โมเดลข้อมูลประจำตัวของบัญชี Managed Google Play มอบวิธีการแบบไดนามิกสำหรับองค์กรในการสร้างบัญชีผู้ใช้หรืออุปกรณ์ของผู้ใช้ตามความจำเป็น บัญชีเหล่านี้ให้สิทธิ์เข้าถึง Managed Google Play

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
accountIdentifier string ตัวระบุที่ไม่ซ้ำกันซึ่งคุณสร้างให้ผู้ใช้รายนี้ เช่น "user342" หรือ "asset#44418" อย่าใช้ข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) สำหรับพร็อพเพอร์ตี้นี้ ต้องตั้งค่าสำหรับผู้ใช้ที่จัดการโดย EMM เสมอ ไม่ได้ตั้งค่าให้กับผู้ใช้ที่จัดการโดย Google
accountType string ประเภทของบัญชีที่ผู้ใช้รายนี้เป็นตัวแทน userAccount สามารถติดตั้งได้ในอุปกรณ์หลายเครื่อง แต่ deviceAccount จะใช้กับอุปกรณ์เครื่องเดียวโดยเฉพาะ ผู้ใช้ที่จัดการโดย EMM (emmManaged) อาจเป็นประเภทใดก็ได้ (userAccount, deviceAccount) แต่ผู้ใช้ที่จัดการโดย Google (googleManaged) จะเป็น userAccount เสมอ

ค่าที่ยอมรับได้ มีดังนี้
  • "deviceAccount"
  • "userAccount"
displayName string ชื่อที่จะปรากฏในอินเทอร์เฟซผู้ใช้ การตั้งค่านี้เป็นตัวเลือกเมื่อสร้างผู้ใช้ที่จัดการโดย EMM หากคุณตั้งค่าพร็อพเพอร์ตี้นี้ไว้ โปรดใช้ชื่อทั่วไปเกี่ยวกับองค์กร (เช่น "Example, Inc.") หรือชื่อของคุณ (ในฐานะ EMM) ไม่ใช้สำหรับบัญชีผู้ใช้ที่จัดการโดย Google เขียนได้
id string รหัสที่ไม่ซ้ำกันสำหรับผู้ใช้

kind string
managementType string เอนทิตีที่จัดการผู้ใช้ เมื่อใช้ผู้ใช้ googleManaged แหล่งข้อมูลที่ถูกต้องคือ Google ดังนั้น EMM จึงต้องตรวจสอบว่าผู้ใช้ดังกล่าวมีบัญชี Google อยู่ หากมีผู้ใช้ emmManaged คน EMM จะเป็นผู้ดูแลจัดการ

ค่าที่ยอมรับได้ มีดังนี้
  • "emmManaged"
  • "googleManaged"
primaryEmail string อีเมลหลักของผู้ใช้ เช่น "jsmith@example.com" ระบบจะตั้งค่าให้กับผู้ใช้ที่มีการจัดการของ Google เสมอและไม่ตั้งค่าไว้สำหรับผู้ใช้ที่มีการจัดการของ EMM

วิธีการ

ลบ
ลบผู้ใช้ที่จัดการโดย EMM แล้ว
generateAuthenticationToken
สร้างโทเค็นการตรวจสอบสิทธิ์ที่ไคลเอ็นต์นโยบายด้านอุปกรณ์จะใช้เพื่อจัดสรรบัญชีผู้ใช้ที่จัดการโดย EMM ที่ระบุในอุปกรณ์ได้ โทเค็นที่สร้างขึ้นเป็นแบบใช้ครั้งเดียวและจะหมดอายุหลังจากผ่านไป 2-3 นาที

คุณจะจัดสรรอุปกรณ์ได้สูงสุด 10 เครื่องต่อผู้ใช้

การโทรนี้ใช้ได้กับบัญชีที่จัดการโดย EMM เท่านั้น
รับ
เรียกข้อมูลรายละเอียดของผู้ใช้
getAvailableProductSet
เรียกดูชุดผลิตภัณฑ์ที่ผู้ใช้มีสิทธิ์เข้าถึง
แทรก
สร้างผู้ใช้ที่จัดการโดย EMM ใหม่

ทรัพยากรผู้ใช้ที่ส่งผ่านเนื้อหาของคำขอควรมี accountIdentifier และ accountType

หากมีผู้ใช้ที่เกี่ยวข้องซึ่งมีตัวระบุบัญชีเดียวกันอยู่แล้ว ระบบจะอัปเดตผู้ใช้ดังกล่าวด้วยทรัพยากรดังกล่าว ในกรณีนี้ มีเพียงช่อง displayName เท่านั้นที่เปลี่ยนแปลงได้

list
ค้นหาผู้ใช้ตามอีเมลหลัก การดำเนินการนี้รองรับเฉพาะผู้ใช้ที่จัดการโดย Google ผู้ใช้ที่จัดการโดย EMM ไม่จำเป็นต้องใช้การค้นหารหัส เพราะรหัสจะแสดงขึ้นมาในผลลัพธ์ของการเรียก Users.insert
revokeDeviceAccess
เพิกถอนสิทธิ์เข้าถึงอุปกรณ์ทั้งหมดที่จัดสรรให้กับผู้ใช้ในปัจจุบัน ผู้ใช้จะไม่สามารถใช้ Managed Play Store ในอุปกรณ์ที่มีการจัดการได้อีกต่อไป

การโทรนี้ใช้ได้กับบัญชีที่จัดการโดย EMM เท่านั้น
setAvailableProductSet
แก้ไขชุดผลิตภัณฑ์ที่ผู้ใช้มีสิทธิ์เข้าถึง (หรือที่เรียกว่าผลิตภัณฑ์ที่whitelisted) เฉพาะผลิตภัณฑ์ที่ได้รับอนุมัติหรือผลิตภัณฑ์ที่เคยได้รับการอนุมัติก่อนหน้านี้ (ผลิตภัณฑ์ที่ถูกยกเลิกการอนุมัติ) เท่านั้นที่จะได้รับอนุญาตเป็นพิเศษได้
อัปเดต
อัปเดตรายละเอียดผู้ใช้ที่จัดการโดย EMM

ใช้ได้กับผู้ใช้ที่จัดการโดย EMM เท่านั้น (ไม่ใช่ผู้ใช้ที่จัดการโดย Google) ส่งรายละเอียดใหม่ในทรัพยากรผู้ใช้ในเนื้อหาคำขอ มีเพียงช่อง displayName เท่านั้นที่เปลี่ยนแปลงได้ ช่องอื่นๆ ต้องไม่ได้ตั้งค่าหรือมีค่าที่ใช้งานอยู่ในปัจจุบัน