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 แบบสุ่ม การระบุรหัสคำขอที่มีอยู่จะแสดงพื้นที่ทำงานที่สร้างด้วยรหัสนั้นแทนที่จะสร้างพื้นที่ทำงานใหม่ การระบุรหัสคำขอที่มีอยู่จากแอป Chat เดียวกันกับผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์รายอื่นจะทำให้เกิดข้อผิดพลาด

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

เนื้อความของคำขอมีอินสแตนซ์ของ 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

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