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
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
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 เท่านั้น
รับ
ดึงรายละเอียดของผู้ใช้
รับชุดผลิตภัณฑ์
ดึงข้อมูลชุดผลิตภัณฑ์ที่ผู้ใช้มีสิทธิ์เข้าถึง หมายเหตุ: รายการนี้เลิกใช้งานแล้ว การผสานรวมใหม่ต้องไม่ใช้วิธีนี้ และสามารถดูคําแนะนําใหม่ของเรา
แทรก
สร้างผู้ใช้ที่จัดการโดย EMM ใหม่

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

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

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

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

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