Method: spaces.create

สร้างพื้นที่ทำงาน ซึ่งใช้สร้างพื้นที่ทำงานที่มีชื่อหรือแชทเป็นกลุ่มในImport modeได้ ดูตัวอย่างได้ที่ สร้างพื้นที่ทำงาน

รองรับการตรวจสอบสิทธิ์ประเภทต่อไปนี้:

เมื่อตรวจสอบสิทธิ์ในฐานะแอป คุณต้องตั้งค่าช่อง space.customer ในคำขอ

เมื่อตรวจสอบสิทธิ์ในฐานะแอป ระบบจะเพิ่มแอป Chat เป็นสมาชิกของพื้นที่ทำงาน อย่างไรก็ตาม แอป Chat จะไม่ได้รับการเพิ่มเป็นผู้จัดการพื้นที่ทำงาน ซึ่งแตกต่างจากการตรวจสอบสิทธิ์ผู้ใช้ โดยค่าเริ่มต้น สมาชิกทุกคนในพื้นที่ทำงานสามารถนำแอป Chat ออกจากพื้นที่ทำงานได้ หากต้องการอนุญาตให้เฉพาะผู้จัดการพื้นที่ทำงานนำแอปออกจากพื้นที่ทำงานได้ ให้ตั้งค่า space.permission_settings.manage_apps เป็น managersAllowed

การเป็นสมาชิกพื้นที่ทำงานเมื่อสร้างขึ้นจะขึ้นอยู่กับว่าพื้นที่ทำงานนั้นสร้างขึ้นใน Import mode หรือไม่

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

หากได้รับข้อความแสดงข้อผิดพลาด ALREADY_EXISTS เมื่อสร้างพื้นที่ทำงาน ให้ลองใช้ displayName อื่น เนื่องจากพื้นที่ทำงานที่มีอยู่ภายในองค์กร Google Workspace อาจใช้ชื่อที่แสดงนี้อยู่แล้ว

คำขอ HTTP

POST https://chat.googleapis.com/v1/spaces

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

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

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

string

ไม่บังคับ รหัสที่ไม่ซ้ำกันสำหรับคำขอนี้ เราขอแนะนำให้ใช้ UUID แบบสุ่ม การระบุรหัสคำขอจะทำให้คำขอเป็นแบบ Idempotent ซึ่งช่วยให้มั่นใจได้ว่าคำขอที่เหมือนกันหลายรายการที่มีรหัสคำขอเดียวกันจะส่งผลให้มีการสร้างพื้นที่ทำงานเพียงรายการเดียว คำขอที่ตามมาซึ่งมีรหัสคำขอเดียวกันจะแสดงพื้นที่ทำงานที่มีอยู่และจะไม่ปรับปรุงพื้นที่ทำงาน แม้ว่ารายละเอียดที่ขอจะแตกต่างจากสถานะปัจจุบันก็ตาม

วิธีใช้ช่องนี้อย่างมีประสิทธิภาพ

  • ตรวจสอบว่าคำขอที่ตามมาเหมือนกันและใช้ข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์เดียวกันกับคำขอเดิม
  • หากมีการสร้างพื้นที่ทำงานด้วยรหัสคำขอที่ระบุไว้แล้ว คำขอจะแสดงพื้นที่ทำงานนั้น โปรดทราบว่าพื้นที่ทำงานที่แสดงอาจมีข้อมูลไม่ครบถ้วน เนื่องจาก API จะแสดงพื้นที่ทำงานในคำขอของคุณพร้อมชื่อทรัพยากรที่ระบบกำหนด หากต้องการดึงข้อมูลเมตาของพื้นที่ทำงานล่าสุด ให้เรียกใช้ spaces.get
  • การนำรหัสคำขอที่มีอยู่กลับมาใช้ซ้ำกับผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์รายอื่นจะทำให้เกิดข้อผิดพลาด

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

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

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

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

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

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

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

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