หน้านี้ได้รับการแปลโดย Cloud Translation API

Method: spaces.patch

คำขอ HTTP
พารามิเตอร์เส้นทาง
พารามิเตอร์การค้นหา
เนื้อความของคำขอ
เนื้อหาการตอบกลับ
ขอบเขตการให้สิทธิ์
ลองใช้งาน

อัปเดตพื้นที่ทำงาน โปรดดูตัวอย่างที่หัวข้ออัปเดตพื้นที่ทำงาน

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

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

คำขอ HTTP

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

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

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

พารามิเตอร์

พารามิเตอร์
`space.name`	`string` ชื่อทรัพยากรของพื้นที่ทำงาน รูปแบบ: `spaces/{space}`

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` อยู่แล้ว การพยายามอัปเดตประเภทพื้นที่ทำงานด้วยวิธีอื่นๆ จะส่งผลให้เกิดข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ไม่ถูกต้อง) `spaceType` ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ `spaceDetails` `spaceHistoryState` (รองรับการเปิดหรือปิดประวัติสำหรับพื้นที่ทำงาน หากองค์กรอนุญาตให้ผู้ใช้เปลี่ยนการตั้งค่าประวัติ คำเตือน: ใช้ไม่ได้กับเส้นทางช่องอื่นๆ ทั้งหมด) `spaceHistoryState` ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ ตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: `accessSettings.audience` (รองรับการเปลี่ยนการตั้งค่าการเข้าถึงของพื้นที่ทำงาน หากไม่ได้ระบุกลุ่มเป้าหมายไว้ในการตั้งค่าการเข้าถึง ระบบจะอัปเดตการตั้งค่าการเข้าถึงของพื้นที่ทำงานเป็นจํากัด คำเตือน: ใช้ไม่ได้กับเส้นทางช่องอื่นๆ ทั้งหมด) `accessSettings.audience` ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ
`useAdminAccess`	`boolean` ตัวอย่างสำหรับนักพัฒนาแอป: มีให้ใช้งานโดยเป็นส่วนหนึ่งของโปรแกรมทดลองใช้สำหรับนักพัฒนาแอป Google Workspace ซึ่งจะให้สิทธิ์ทดลองใช้บางฟีเจอร์ก่อนเปิดตัว เมื่อใช้ `true` เมธอดจะทำงานโดยใช้สิทธิ์ของผู้ดูแลระบบ Google Workspace ของผู้ใช้ ผู้ใช้ที่โทรต้องเป็นผู้ดูแลระบบ Google Workspace ที่มีสิทธิ์จัดการแชทและการสนทนาในพื้นที่ทำงาน ต้องใช้ขอบเขต OAuth 2.0 ของ `chat.admin.spaces` ค่า `FieldMask` บางค่าไม่ได้รับการสนับสนุนโดยใช้สิทธิ์เข้าถึงระดับผู้ดูแลระบบ โปรดดูรายละเอียดในคำอธิบาย `updateMask`

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 อยู่แล้ว การพยายามอัปเดตประเภทพื้นที่ทำงานด้วยวิธีอื่นๆ จะส่งผลให้เกิดข้อผิดพลาดเกี่ยวกับอาร์กิวเมนต์ไม่ถูกต้อง) spaceType ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ
spaceDetails
spaceHistoryState (รองรับการเปิดหรือปิดประวัติสำหรับพื้นที่ทำงาน หากองค์กรอนุญาตให้ผู้ใช้เปลี่ยนการตั้งค่าประวัติ คำเตือน: ใช้ไม่ได้กับเส้นทางช่องอื่นๆ ทั้งหมด) spaceHistoryState ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ
ตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: accessSettings.audience (รองรับการเปลี่ยนการตั้งค่าการเข้าถึงของพื้นที่ทำงาน หากไม่ได้ระบุกลุ่มเป้าหมายไว้ในการตั้งค่าการเข้าถึง ระบบจะอัปเดตการตั้งค่าการเข้าถึงของพื้นที่ทำงานเป็นจํากัด คำเตือน: ใช้ไม่ได้กับเส้นทางช่องอื่นๆ ทั้งหมด) accessSettings.audience ไม่รองรับสิทธิ์เข้าถึงระดับผู้ดูแลระบบ

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

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