Method: users.insert

สร้างผู้ใช้

การเรียกใช้ Mutate ทันทีหลังจากสร้างผู้ใช้อาจล้มเหลวในบางครั้งเนื่องจากระบบยังสร้างผู้ใช้ไม่เสร็จสมบูรณ์อันเนื่องมาจากความล่าช้าในการเผยแพร่ในแบ็กเอนด์ของเรา โปรดดูรายละเอียดข้อผิดพลาดของข้อความ "User creation is not complete" เพื่อดูว่าเกิดกรณีนี้หรือไม่ การลองโทรอีกครั้งหลังจากผ่านไปสักระยะอาจช่วยได้ในกรณีนี้

หากตั้งค่า resolveConflictAccount เป็น true ตัวเลือกที่เลือกสำหรับค้นหาและเพิ่มผู้ใช้ที่ไม่มีการจัดการจะมีผลในการแก้ไขบัญชีที่ทับซ้อนกัน

  • โค้ดตอบกลับ 200 แสดงว่ามีการสร้างผู้ใช้ (หรือแทนที่บัญชี Google ส่วนบุคคลที่ไม่มีการจัดการที่มีอยู่)
  • โค้ดตอบกลับ 202 หมายความว่ามีบัญชีส่วนตัวที่ไม่มีการจัดการซึ่งขัดแย้งกันและได้รับเชิญให้เข้าร่วมองค์กร
  • 409 โค้ดตอบกลับหมายความว่ามีบัญชีที่ทับซ้อนกัน จึงไม่ได้สร้างผู้ใช้ (เช่น ตามตัวเลือกที่เลือกเพื่อเก็บรักษาบัญชี หรือหากอีเมลทับซ้อนกับบัญชีงานที่ไม่มีการจัดการหรือผู้ใช้ที่มีการจัดการอยู่แล้ว)

โปรดดูรายละเอียดเกี่ยวกับการแก้ปัญหาข้อผิดพลาดของบัญชีที่ซ้ำกันที่หัวข้อแก้ปัญหาข้อผิดพลาดของบัญชีที่ซ้ำกันและโอนบัญชีงานที่ไม่มีการจัดการ

คำขอ HTTP

POST https://admin.googleapis.com/admin/directory/v1/users

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
resolveConflictAccount

boolean

ไม่บังคับ ใช้ตัวเลือกที่เลือกสำหรับค้นหาและเพิ่มผู้ใช้ที่ไม่มีการจัดการเพื่อแก้ไขบัญชีที่ทับซ้อนกันเมื่อตั้งค่าเป็น true ค่าเริ่มต้น: false

เนื้อความของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ User

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ User ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/admin.directory.user

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์