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)

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

คุณสามารถอัปเดตพื้นที่ทำงานในช่องต่อไปนี้

  • spaceDetails

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

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

  • spaceHistoryState: อัปเดตการตั้งค่าประวัติพื้นที่ทำงานโดยการเปิดหรือปิดประวัติสำหรับพื้นที่ทำงาน รองรับเฉพาะเมื่อเปิดการตั้งค่าประวัติสำหรับองค์กร Google Workspace หากต้องการอัปเดตสถานะประวัติพื้นที่ทำงาน คุณต้องเว้นฟิลด์มาสก์อื่นๆ ทั้งหมดในคำขอ spaceHistoryState ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ

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

  • ตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: รองรับการเปลี่ยนการตั้งค่าสิทธิ์ของพื้นที่ทำงาน เส้นทางช่องที่รองรับ ได้แก่ permissionSettings.manage_members_and_groups, permissionSettings.modify_space_details, permissionSettings.toggle_history, permissionSettings.use_at_mention_all, permissionSettings.manage_apps, permissionSettings.manage_webhooks, permissionSettings.reply_messages (คำเตือน: จำกัดเฉพาะเส้นทางในช่องการตั้งค่าที่ไม่ใช่สิทธิ์อื่นๆ ทั้งหมด) permissionSettings ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ
useAdminAccess

boolean

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

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

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

ค่า FieldMask บางค่าไม่ได้รับการสนับสนุนโดยใช้สิทธิ์เข้าถึงระดับผู้ดูแลระบบ โปรดดูรายละเอียดในคำอธิบาย updateMask

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

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

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

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

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

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

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

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