สร้างพื้นที่ทำงานและเพิ่มผู้ใช้ที่ระบุไปยังพื้นที่ทำงาน ระบบจะเพิ่มผู้ใช้ที่โทรออกไปยังพื้นที่ทำงานโดยอัตโนมัติ และไม่ควรระบุว่าเป็นสมาชิกในคำขอ โปรดดูตัวอย่างที่หัวข้อตั้งค่าพื้นที่ทำงานที่มีสมาชิกเริ่มต้น
หากต้องการระบุสมาชิกที่จะเพิ่ม ให้เพิ่มการเป็นสมาชิกด้วย member.name
ที่เหมาะสมใน SetUpSpaceRequest
หากต้องการเพิ่มผู้ใช้ที่เป็นมนุษย์ ให้ใช้ 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
สำหรับพื้นที่ทำงานหรือแชทเป็นกลุ่ม หากผู้โทรบล็อกหรือถูกบล็อกโดยสมาชิกบางคน ระบบจะไม่เพิ่มสมาชิกเหล่านั้นไปยังพื้นที่ทำงานที่สร้างขึ้น
หากต้องการสร้างข้อความส่วนตัว (DM) ระหว่างผู้ใช้ที่โทรกับผู้ใช้ที่เป็นมนุษย์อีกคนหนึ่ง ให้ระบุการเป็นสมาชิกเพียง 1 รายการเพื่อแสดงถึงผู้ใช้ที่เป็นมนุษย์ หากมีผู้ใช้รายหนึ่งบล็อกผู้ใช้อีกรายหนึ่ง คำขอจะล้มเหลวและจะไม่มีการสร้าง DM
หากต้องการสร้าง DM ระหว่างผู้ใช้ที่โทรกับแอปโทร ให้ตั้งค่า Space.singleUserBotDm
เป็น true
และไม่ระบุการเป็นสมาชิก คุณใช้วิธีการนี้เพื่อตั้งค่า DM กับแอปการโทรได้เท่านั้น หากต้องการเพิ่มแอปการโทรเป็นสมาชิกของพื้นที่ทำงาน หรือ DM ที่มีอยู่ระหว่างผู้ใช้ที่เป็นมนุษย์ 2 คน โปรดดูหัวข้อเชิญหรือเพิ่มผู้ใช้หรือแอปไปยังพื้นที่ทำงาน
หากมี DM ระหว่างผู้ใช้ 2 คนอยู่แล้ว แม้ว่าผู้ใช้คนหนึ่งจะบล็อกผู้ใช้อีกคนในขณะที่ส่งคำขอ ระบบก็จะแสดงผล DM ที่มีอยู่
ไม่รองรับพื้นที่ทำงานที่มีการตอบกลับแบบแยกชุดข้อความ หากได้รับข้อความแสดงข้อผิดพลาด ALREADY_EXISTS
เมื่อตั้งค่าพื้นที่ทำงาน ให้ลองใช้ displayName
อื่น พื้นที่ทำงานที่มีอยู่ภายในองค์กร Google Workspace อาจใช้ชื่อที่แสดงนี้อยู่แล้ว
ต้องมีการตรวจสอบสิทธิ์ผู้ใช้
คำขอ HTTP
POST https://chat.googleapis.com/v1/spaces:setup
URL ใช้ไวยากรณ์การแปลง gRPC
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "space": { object ( |
ช่อง | |
---|---|
space |
ต้องระบุ ต้องกรอกข้อมูลในช่อง หากต้องการสร้างพื้นที่ทำงาน ให้ตั้งค่า หากต้องการสร้างแชทเป็นกลุ่ม ให้ตั้งค่า หากต้องการสร้างการสนทนาแบบ 1:1 ระหว่างมนุษย์ ให้ตั้งค่า หากต้องการสร้างการสนทนาแบบ 1:1 ระหว่างเจ้าหน้าที่กับแอป Chat ที่โทร ให้ตั้งค่า หากมีพื้นที่ทำงาน |
requestId |
ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับคำขอนี้ ขอแนะนำให้ใช้ UUID แบบสุ่ม การระบุรหัสคำขอที่มีอยู่จะแสดงผลพื้นที่ทำงานที่สร้างขึ้นด้วยรหัสนั้นแทนการสร้างพื้นที่ทำงานใหม่ การระบุรหัสคำขอที่มีอยู่จากแอป Chat เดียวกันที่มีผู้ใช้ที่ตรวจสอบสิทธิ์แล้วรายอื่นจะแสดงข้อผิดพลาด |
memberships[] |
ไม่บังคับ ผู้ใช้ Google Chat ที่จะเชิญให้เข้าร่วมพื้นที่ทำงาน ละเว้นผู้ใช้ที่โทร เนื่องจากระบบจะเพิ่มผู้ใช้ที่โทรโดยอัตโนมัติ ขณะนี้ชุดการเป็นสมาชิกอนุญาตให้มีการเป็นสมาชิกสูงสุด 20 รายการ (นอกเหนือจากผู้โทร) ช่อง ไม่บังคับเมื่อตั้งค่า ต้องระบุเมื่อตั้งค่า ต้องระบุเมื่อตั้งค่า ต้องเว้นว่างไว้เมื่อสร้างการสนทนาแบบ 1:1 ระหว่างผู้ใช้กับแอป Chat ที่โทร (เมื่อตั้งค่า |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Space
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์