Method: spaces.patch

อัปเดตพื้นที่ทำงาน ดูตัวอย่างได้ที่อัปเดตพื้นที่ทำงาน

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

ต้องมีการตรวจสอบสิทธิ์ผู้ใช้

คำขอ HTTP

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

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

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

พารามิเตอร์
space.name

string

ชื่อทรัพยากรของพื้นที่ทำงาน

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

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

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

string (FieldMask format)

ต้องระบุ เส้นทางของช่องที่อัปเดต โดยคั่นด้วยคอมมาหากมีหลายรายการ

เส้นทางฟิลด์ที่รองรับในปัจจุบัน:

  • displayName (รองรับเฉพาะการเปลี่ยนชื่อที่แสดงของพื้นที่ทำงานที่มีประเภท SPACE หรือเมื่อใส่มาสก์ spaceType ด้วยเพื่อเปลี่ยนประเภทพื้นที่ทำงาน GROUP_CHAT เป็น SPACE การพยายามอัปเดตชื่อที่แสดงของ GROUP_CHAT หรือพื้นที่ทำงาน DIRECT_MESSAGE ทำให้เกิดข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ไม่ถูกต้อง หากคุณได้รับข้อความแสดงข้อผิดพลาด ALREADY_EXISTS ขณะอัปเดต displayName ให้ลองใช้ displayName อื่น พื้นที่ทำงานที่มีอยู่ภายในองค์กร Google Workspace อาจใช้ชื่อที่แสดงนี้อยู่แล้ว)

  • spaceType (รองรับการเปลี่ยนประเภทพื้นที่ทำงาน GROUP_CHAT เป็น SPACE เท่านั้น รวม displayName ร่วมกับ spaceType ในมาสก์การอัปเดต และตรวจสอบว่าพื้นที่ที่ระบุมีชื่อที่แสดงและเป็นประเภท SPACE ที่ไม่ว่างเปล่า คุณจะรวมมาสก์ spaceType และประเภท SPACE ลงในพื้นที่ทำงานที่ระบุเมื่ออัปเดตชื่อที่แสดงหรือไม่ก็ได้ หากพื้นที่ทำงานที่มีอยู่มีประเภท SPACE อยู่แล้ว การพยายามอัปเดตประเภทพื้นที่ทํางานด้วยวิธีอื่นจะทำให้เกิดข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ไม่ถูกต้อง)

  • spaceDetails

  • spaceHistoryState (รองรับการเปิดหรือปิดประวัติของพื้นที่ทำงาน หากองค์กรอนุญาตให้ผู้ใช้เปลี่ยนการตั้งค่าประวัติได้ คำเตือน: ใช้ร่วมกับเส้นทางฟิลด์อื่นทั้งหมด)

  • ตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: accessSettings.audience (รองรับการเปลี่ยนการตั้งค่าการเข้าถึงของพื้นที่ทำงาน หากไม่ได้ระบุกลุ่มเป้าหมายในการตั้งค่าการเข้าถึง ระบบจะอัปเดตการตั้งค่าการเข้าถึงของพื้นที่ทำงานเป็นถูกจำกัด คำเตือน: ใช้ร่วมกับเส้นทางฟิลด์อื่นทั้งหมด)

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

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

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

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

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

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

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

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