Method: spaces.patch

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

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

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

  • การตรวจสอบสิทธิ์แอปที่มีการอนุมัติจากผู้ดูแลระบบและขอบเขตการให้สิทธิ์อย่างใดอย่างหนึ่งต่อไปนี้

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

  • การตรวจสอบสิทธิ์ผู้ใช้ที่มีขอบเขตการให้สิทธิ์อย่างใดอย่างหนึ่งต่อไปนี้

    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (เฉพาะพื้นที่ทำงานโหมดการนำเข้า)
    • การตรวจสอบสิทธิ์ผู้ใช้จะให้สิทธิ์ผู้ดูแลระบบเมื่อบัญชีผู้ดูแลระบบตรวจสอบสิทธิ์ useAdminAccess true และใช้ขอบเขตการให้สิทธิ์ต่อไปนี้
      • https://www.googleapis.com/auth/chat.admin.spaces

การตรวจสอบสิทธิ์แอปมีข้อจำกัดดังต่อไปนี้

  • หากต้องการอัปเดต space.predefined_permission_settings หรือ space.permission_settings แอปต้องเป็นผู้สร้างพื้นที่ทำงาน
  • การอัปเดต space.access_settings.audience ไม่รองรับการตรวจสอบสิทธิ์แอป

คำขอ HTTP

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

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

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

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

string

ตัวระบุ ชื่อทรัพยากรของพื้นที่ทำงาน

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

โดย {space} คือรหัสที่ระบบกำหนดให้สำหรับพื้นที่ทำงาน คุณรับรหัสพื้นที่ทำงานได้โดยการเรียกใช้เมธอด spaces.list() หรือจาก URL ของพื้นที่ทำงาน เช่น หาก URL ของพื้นที่ทำงานคือ https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA รหัสพื้นที่ทำงานจะเป็น AAAAAAAAA

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

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

string (FieldMask format)

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

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

spaceDetails: อัปเดตคำอธิบายและหลักเกณฑ์ของพื้นที่ทำงาน คุณต้องส่งทั้งคำอธิบายและหลักเกณฑ์ในคำขออัปเดตเป็น SpaceDetails หากต้องการอัปเดตเพียง 1 ฟิลด์ ให้ส่งค่าที่มีอยู่สำหรับฟิลด์อื่น

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

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

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

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

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

  • accessSettings.access_permission_settings.discoverSpaceSetting
  • accessSettings.access_permission_settings.joinSpaceSetting

permissionSettings: รองรับการเปลี่ยนการตั้งค่าสิทธิ์ของพื้นที่ทำงาน เมื่ออัปเดตการตั้งค่าสิทธิ์ คุณจะระบุได้เฉพาะมาสก์ฟิลด์ permissionSettings เท่านั้น และจะอัปเดตมาสก์ฟิลด์อื่นๆ พร้อมกันไม่ได้ ฟิลด์มาสก์ที่รองรับมีดังนี้

  • permissionSettings.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

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

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

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

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

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

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

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

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

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

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

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

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