Method: spaces.members.create

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

หากต้องการระบุสมาชิกที่จะเพิ่ม ให้ตั้งค่า membership.member.name สำหรับสมาชิกที่เป็นมนุษย์หรือแอป หรือตั้งค่า membership.group_member.name สำหรับสมาชิกกลุ่ม

  • หากต้องการเพิ่มแอปการโทรไปยังพื้นที่ทำงานหรือข้อความส่วนตัวระหว่างผู้ใช้ที่เป็นมนุษย์ 2 คน ให้ใช้ users/app ไม่สามารถเพิ่มแอปอื่นๆ ไปยังพื้นที่ทำงานได้

  • หากต้องการเพิ่มผู้ใช้ที่เป็นมนุษย์ ให้ใช้ users/{user} โดย {user} สามารถเป็นอีเมลของผู้ใช้ได้ สำหรับผู้ใช้ในองค์กร Workspace เดียวกัน {user} สามารถเป็น id สำหรับบุคคลจาก People API หรือ id สำหรับผู้ใช้ใน Directory API ได้ด้วย ตัวอย่างเช่น หากรหัสโปรไฟล์บุคคลของ People API สำหรับ user@example.com คือ 123456789 คุณสามารถเพิ่มผู้ใช้ไปยังพื้นที่ทำงานได้โดยตั้งค่า membership.member.name เป็น users/user@example.com หรือ users/123456789

  • หากต้องการเพิ่มหรือเชิญกลุ่ม Google ในพื้นที่ทำงานที่ตั้งชื่อ ให้ใช้ groups/{group} โดยที่ {group} คือ id ของกลุ่มจาก Cloud Identity Groups API ตัวอย่างเช่น คุณสามารถใช้ API การค้นหากลุ่ม Cloud Identity เพื่อเรียกข้อมูลรหัส 123456789 สำหรับอีเมลกลุ่ม group@example.com จากนั้นจึงเพิ่มหรือเชิญกลุ่มไปยังพื้นที่ทำงานที่ระบุชื่อ โดยตั้งค่า membership.group_member.name เป็น groups/123456789 ไม่รองรับอีเมลกลุ่ม และเพิ่ม Google Groups เป็นสมาชิกได้เฉพาะในพื้นที่ทำงานที่ตั้งชื่อเท่านั้น

คำขอ HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

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

พารามิเตอร์เส้นทาง

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

string

ต้องระบุ ชื่อทรัพยากรของพื้นที่ทำงานที่จะสร้างการเป็นสมาชิก

รูปแบบ: workspace/{space}

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

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

boolean

เมื่อใช้ true เมธอดจะทำงานโดยใช้สิทธิ์ของผู้ดูแลระบบ Google Workspace ของผู้ใช้

ผู้ใช้ที่โทรต้องเป็นผู้ดูแลระบบ Google Workspace ที่มีสิทธิ์จัดการแชทและการสนทนาในพื้นที่ทำงาน

ต้องใช้ขอบเขต OAuth 2.0 ของ chat.admin.memberships

ระบบไม่รองรับการสร้างการเป็นสมาชิกของแอปหรือสร้างการเป็นสมาชิกสำหรับผู้ใช้ภายนอกองค์กร Google Workspace ของผู้ดูแลระบบโดยใช้สิทธิ์การเข้าถึงระดับผู้ดูแลระบบ

เนื้อหาของคำขอ

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

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

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

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

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