REST Resource: spaces

ทรัพยากร: พื้นที่ทำงาน

พื้นที่ทำงานใน Google Chat พื้นที่ทำงานคือการสนทนาระหว่างผู้ใช้ตั้งแต่ 2 คนขึ้นไป หรือข้อความแบบ 1:1 ระหว่างผู้ใช้กับแอปใน Chat

การแสดง JSON
{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,
  "sessionState": enum (SpaceSessionState),
  "sessionEnableTime": string,
  "importModeExpireTime": string,
  "customer": string,

  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
}
ช่อง
name

string

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

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

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

type
(deprecated)

enum (Type)

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: โปรดใช้ spaceType แทน ประเภทของพื้นที่ทำงาน

spaceType

enum (SpaceType)

ไม่บังคับ ประเภทของพื้นที่ทำงาน ต้องระบุเมื่อสร้างพื้นที่ทำงานหรืออัปเดตประเภทพื้นที่ทำงานของพื้นที่ทำงาน เอาต์พุตสำหรับการใช้งานอื่นๆ เท่านั้น

singleUserBotDm

boolean

ไม่บังคับ พื้นที่ทำงานเป็น DM ระหว่างแอปใน Chat กับบุคคลเดียวหรือไม่

threaded
(deprecated)

boolean

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: โปรดใช้ spaceThreadingState แทน ข้อความจะแยกชุดข้อความในพื้นที่ทำงานนี้หรือไม่

displayName

string

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

สำหรับข้อความส่วนตัว ช่องนี้อาจว่างเปล่า

รองรับอักขระได้สูงสุด 128 ตัว

externalUserAllowed

boolean

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

  • ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วใช้บัญชีผู้ใช้ทั่วไป (บัญชีผู้ใช้ที่ไม่มีการจัดการ) โดยค่าเริ่มต้น พื้นที่ทำงานที่สร้างโดยบัญชีผู้ใช้ทั่วไปจะอนุญาตผู้ใช้ Google Chat ทุกคน

สำหรับพื้นที่ทำงานที่มีอยู่ ช่องนี้จะเป็นเอาต์พุตเท่านั้น

spaceThreadingState

enum (SpaceThreadingState)

เอาต์พุตเท่านั้น สถานะชุดข้อความในพื้นที่ทำงานใน Chat

spaceDetails

object (SpaceDetails)

ไม่บังคับ รายละเอียดเกี่ยวกับพื้นที่ทำงาน รวมถึงคำอธิบายและกฎ

spaceHistoryState

enum (HistoryState)

ไม่บังคับ สถานะประวัติข้อความสำหรับข้อความและชุดข้อความในพื้นที่ทำงานนี้

importMode

boolean

ไม่บังคับ พื้นที่ทำงานนี้สร้างขึ้นใน Import Mode โดยเป็นส่วนหนึ่งของการย้ายข้อมูลไปยัง Google Workspace หรือไม่ ขณะที่ระบบกำลังนำเข้าพื้นที่ทำงาน ผู้ใช้จะไม่เห็นพื้นที่ทำงานเหล่านั้นจนกว่าการนำเข้าจะเสร็จสมบูรณ์

การสร้างพื้นที่ทำงานใน Import Mode ต้องมีการตรวจสอบสิทธิ์ผู้ใช้

createTime

string (Timestamp format)

ไม่บังคับ เปลี่ยนแปลงไม่ได้ สำหรับพื้นที่ทำงานที่สร้างใน Chat จะเป็นเวลาที่สร้างพื้นที่ทำงาน ช่องนี้เป็นเอาต์พุตเท่านั้น ยกเว้นเมื่อใช้ในพื้นที่ทำงานโหมดการนำเข้า

สำหรับพื้นที่ทำงานในโหมดนำเข้า ให้ตั้งค่าช่องนี้เป็นการประทับเวลาที่ผ่านมาซึ่งมีการสร้างพื้นที่ทำงานในแหล่งที่มาเพื่อรักษาเวลาที่สร้างเดิมไว้

จะป้อนข้อมูลในเอาต์พุตเมื่อ spaceType เป็น GROUP_CHAT หรือ SPACE เท่านั้น

lastActiveTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาของข้อความสุดท้ายในพื้นที่ทำงาน

adminInstalled

boolean

เอาต์พุตเท่านั้น สำหรับพื้นที่ทำงานของข้อความส่วนตัว (DM) ที่มีแอปใน Chat ให้ดูว่าผู้ดูแลระบบ Google Workspace เป็นผู้สร้างพื้นที่ทำงานหรือไม่ ผู้ดูแลระบบสามารถติดตั้งและตั้งค่าข้อความส่วนตัวด้วยแอปใน Chat ในนามของผู้ใช้ในองค์กรได้

แอปใน Chat ต้องมีฟีเจอร์การรับส่งข้อความส่วนตัวเพื่อรองรับการติดตั้งโดยผู้ดูแลระบบ

membershipCount

object (MembershipCount)

เอาต์พุตเท่านั้น จำนวนการเป็นสมาชิกที่เข้าร่วมซึ่งจัดกลุ่มตามประเภทสมาชิก ระบบจะป้อนข้อมูลเมื่อ spaceType เป็น SPACE, DIRECT_MESSAGE หรือ GROUP_CHAT

accessSettings

object (AccessSettings)

ไม่บังคับ ระบุการตั้งค่าการเข้าถึงของพื้นที่ทำงาน จะป้อนข้อมูลเมื่อ spaceType เป็น SPACE เท่านั้น

spaceUri

string

เอาต์พุตเท่านั้น URI สำหรับให้ผู้ใช้เข้าถึงพื้นที่ทำงาน

sessionState

enum (SpaceSessionState)

เอาต์พุตเท่านั้น สถานะเซสชันของพื้นที่ทำงาน

sessionEnableTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาที่สถานะการรองรับเซสชันของพื้นที่ทำงานเปลี่ยนเป็นรองรับ ไม่ได้ตั้งค่าหากพื้นที่ทำงานไม่ได้เปิดใช้การรองรับเซสชัน

importModeExpireTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่ระบบจะลบพื้นที่ทำงานโดยอัตโนมัติหากยังคงอยู่ในโหมดการนำเข้า

พื้นที่ทำงานแต่ละรายการที่สร้างในโหมดการนำเข้าต้องออกจากโหมดนี้ก่อนเวลาหมดอายุโดยใช้ spaces.completeImport

ระบบจะป้อนข้อมูลในช่องนี้สำหรับพื้นที่ทำงานที่สร้างด้วยโหมดการนำเข้าเท่านั้น

customer

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ รหัสลูกค้าของโดเมนของพื้นที่ทำงาน ต้องระบุเมื่อสร้างพื้นที่ทำงานด้วยการตรวจสอบสิทธิ์แอปและ SpaceType เป็น SPACE เท่านั้น ไม่เช่นนั้นก็ไม่ควรตั้งค่า

ในรูปแบบ customers/{customer} โดยที่ customer คือ id จากทรัพยากรลูกค้า Admin SDK แอปส่วนตัวยังใช้นามแฝง customers/my_customer เพื่อสร้างพื้นที่ทำงานในองค์กร Google Workspace เดียวกันกับแอปได้ด้วย

ระบบจะไม่ป้อนข้อมูลในช่องนี้สำหรับข้อความส่วนตัว (DM) หรือเมื่อผู้ใช้ที่ไม่ได้ใช้ Google Workspace เป็นผู้สร้างพื้นที่ทำงาน

แสดงการตั้งค่าสิทธิ์ของพื้นที่ทำงาน จะป้อนข้อมูลเมื่อ space_type เป็น SPACE เท่านั้น รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
predefinedPermissionSettings

enum (PredefinedPermissionSettings)

ไม่บังคับ อินพุตเท่านั้น การตั้งค่ากลุ่มสิทธิ์ของพื้นที่ทำงานที่กำหนดไว้ล่วงหน้า ให้ป้อนข้อมูลเมื่อสร้างพื้นที่ทำงานเท่านั้น หากไม่ได้ตั้งค่าฟิลด์นี้ ระบบจะสร้างพื้นที่ทำงานร่วมกัน หลังจากสร้างพื้นที่ทำงานแล้ว การตั้งค่าจะปรากฏในช่อง PermissionSettings

การตั้งค่ากลุ่มสิทธิ์ที่กำหนดไว้ล่วงหน้าจะรองรับสิ่งต่อไปนี้

permissionSettings

object (PermissionSettings)

ไม่บังคับ การตั้งค่าสิทธิ์ของพื้นที่ทำงานสำหรับพื้นที่ทำงานที่มีอยู่ ข้อมูลสำหรับการอัปเดตการตั้งค่าสิทธิ์ของพื้นที่ทำงานที่แน่นอน ซึ่งจะแทนที่การตั้งค่าสิทธิ์ที่มีอยู่ เอาต์พุตจะแสดงการตั้งค่าสิทธิ์ปัจจุบัน

การอ่านและอัปเดตการตั้งค่าสิทธิ์รองรับสิ่งต่อไปนี้

สิ้นสุดฟิลด์ที่แยกกัน

ประเภท

เลิกใช้งานแล้ว: โปรดใช้ SpaceType แทน

Enum
TYPE_UNSPECIFIED Reserved.
ROOM การสนทนาระหว่างมนุษย์ 2 คนขึ้นไป
DM ข้อความส่วนตัวแบบ 1:1 ระหว่างบุคคลกับแอปใน Chat ซึ่งข้อความทั้งหมดจะไม่มีการแยกชุดข้อความ โปรดทราบว่าการดำเนินการนี้ไม่รวมข้อความส่วนตัวระหว่างบุคคล 2 คน

SpaceType

ประเภทของพื้นที่ทำงาน ต้องระบุเมื่อสร้างหรืออัปเดตพื้นที่ทำงาน เอาต์พุตสำหรับการใช้งานอื่นๆ เท่านั้น

Enum
SPACE_TYPE_UNSPECIFIED Reserved.
SPACE พื้นที่ที่ผู้คนส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน SPACE สามารถมีแอปใน Chat ได้
GROUP_CHAT การสนทนากลุ่มระหว่างผู้คนตั้งแต่ 3 คนขึ้นไป GROUP_CHAT สามารถมีแอปใน Chat ได้
DIRECT_MESSAGE ข้อความแบบ 1:1 ระหว่างมนุษย์ 2 คนหรือมนุษย์กับแอปใน Chat

SpaceThreadingState

ระบุประเภทสถานะชุดข้อความในพื้นที่ทำงานใน Chat

Enum
SPACE_THREADING_STATE_UNSPECIFIED Reserved.
THREADED_MESSAGES พื้นที่ทำงานที่รองรับชุดข้อความ เมื่อผู้ใช้ตอบกลับข้อความ ผู้ใช้สามารถตอบกลับในชุดข้อความได้ ซึ่งจะทำให้คำตอบอยู่ในบริบทของข้อความต้นฉบับ
GROUPED_MESSAGES พื้นที่ทำงานที่มีชื่อซึ่งจัดระเบียบการสนทนาตามหัวข้อ ระบบจะจัดกลุ่มหัวข้อและการตอบกลับไว้ด้วยกัน
UNTHREADED_MESSAGES

พื้นที่ทำงานที่ไม่รองรับชุดข้อความ สถานะชุดข้อความของพื้นที่ทำงานนี้ใช้สำหรับกรณีพิเศษเท่านั้น ซึ่งรวมถึงกรณีต่อไปนี้

  • แชทในการประชุมแบบต่อเนื่องที่ปิดชุดข้อความไว้โดยเจตนา
  • การสนทนากลุ่มแบบเดิมที่สร้างขึ้นก่อนปี 2022

SpaceDetails

รายละเอียดเกี่ยวกับพื้นที่ทำงาน รวมถึงคำอธิบายและกฎ

การแสดง JSON
{
  "description": string,
  "guidelines": string
}
ฟิลด์
description

string

ไม่บังคับ คำอธิบายพื้นที่ทำงาน เช่น อธิบายหัวข้อการสนทนา วัตถุประสงค์การใช้งาน หรือผู้เข้าร่วมของพื้นที่ทำงาน

รองรับอักขระสูงสุด 4,096 ตัว

guidelines

string

ไม่บังคับ กฎ ความคาดหวัง และมารยาทของพื้นที่ทำงาน

รองรับอักขระได้สูงสุด 5,000 ตัว

HistoryState

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

Enum
HISTORY_STATE_UNSPECIFIED ค่าเริ่มต้น โปรดอย่าใช้
HISTORY_OFF ประวัติปิดอยู่ ระบบจะเก็บข้อความและชุดข้อความไว้เป็นเวลา 24 ชั่วโมง
HISTORY_ON ประวัติเปิดอยู่ กฎการเก็บรักษาของห้องนิรภัยขององค์กรจะระบุระยะเวลาที่จะเก็บข้อความและชุดข้อความไว้

MembershipCount

แสดงจำนวนการเป็นสมาชิกของพื้นที่ทำงาน โดยแบ่งออกเป็นหมวดหมู่ต่างๆ

การแสดง JSON
{
  "joinedDirectHumanUserCount": integer,
  "joinedGroupCount": integer
}
ช่อง
joinedDirectHumanUserCount

integer

เอาต์พุตเท่านั้น จำนวนผู้ใช้ที่เป็นมนุษย์ซึ่งเข้าร่วมพื้นที่ทำงานโดยตรง โดยไม่นับรวมผู้ใช้ที่เข้าร่วมโดยการเป็นสมาชิกในกลุ่มที่เข้าร่วม

joinedGroupCount

integer

เอาต์พุตเท่านั้น จำนวนกลุ่มทั้งหมดที่เข้าร่วมพื้นที่ทำงานโดยตรง

AccessSettings

แสดงการตั้งค่าการเข้าถึงของพื้นที่ทำงาน

การแสดง JSON
{
  "accessState": enum (AccessState),
  "audience": string,
  "accessPermissionSettings": {
    object (AccessPermissionSettings)
  }
}
ช่อง
accessState

enum (AccessState)

เอาต์พุตเท่านั้น ระบุสถานะการเข้าถึงของพื้นที่ทำงาน

audience

string

ไม่บังคับ ชื่อทรัพยากรของกลุ่มเป้าหมายที่สามารถค้นพบพื้นที่ทำงาน เข้าร่วมพื้นที่ทำงาน และดูตัวอย่างข้อความในพื้นที่ทำงานได้ หากไม่ได้ตั้งค่าไว้ เฉพาะผู้ใช้หรือ Google Groups ที่ได้รับเชิญหรือเพิ่มไปยังพื้นที่ทำงานเป็นรายบุคคลเท่านั้นที่จะเข้าถึงพื้นที่ทำงานได้ โปรดดูรายละเอียดที่หัวข้อทำให้กลุ่มเป้าหมายค้นพบพื้นที่ทำงานได้

รูปแบบ: audiences/{audience}

หากต้องการใช้กลุ่มเป้าหมายเริ่มต้นสำหรับองค์กร Google Workspace ให้ตั้งค่าเป็น audiences/default

การอ่านกลุ่มเป้าหมายรองรับสิ่งต่อไปนี้

ระบบจะไม่ป้อนข้อมูลในช่องนี้เมื่อใช้ขอบเขต chat.bot กับการตรวจสอบสิทธิ์แอป

การตั้งค่ากลุ่มเป้าหมายต้องมีการตรวจสอบสิทธิ์ของผู้ใช้

accessPermissionSettings

object (AccessPermissionSettings)

ไม่บังคับ การตั้งค่าสิทธิ์เข้าถึงสำหรับพื้นที่ทำงาน

หากต้องการตั้งค่ากลุ่มเป้าหมายเมื่อสร้างพื้นที่ทำงาน ให้ระบุช่อง accessSettings.audience ในคำขอ

AccessState

แสดงสถานะการเข้าถึงของพื้นที่ทำงาน

Enum
ACCESS_STATE_UNSPECIFIED ไม่ทราบสถานะการเข้าถึงหรือไม่รองรับใน API นี้
PRIVATE เฉพาะผู้ใช้หรือ Google Groups ที่ได้รับการเพิ่มหรือเชิญโดยผู้ใช้รายอื่นหรือผู้ดูแลระบบ Google Workspace เป็นรายบุคคลเท่านั้นที่จะค้นพบและเข้าถึงพื้นที่ทำงานได้
DISCOVERABLE

ผู้จัดการพื้นที่ทำงานได้ให้สิทธิ์เข้าถึงพื้นที่ทำงานแก่กลุ่มเป้าหมาย ผู้ใช้หรือ Google Groups ที่ได้รับการเพิ่มหรือได้รับเชิญให้เข้าร่วมพื้นที่ทำงานเป็นรายบุคคลจะค้นพบและเข้าถึงพื้นที่ทำงานได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่หัวข้อทำให้ผู้ใช้บางรายค้นพบพื้นที่ทำงานได้

การสร้างพื้นที่ทำงานที่ค้นพบได้ต้องมีการตรวจสอบสิทธิ์ผู้ใช้

AccessPermissionSettings

การตั้งค่าสิทธิ์เข้าถึงสำหรับพื้นที่ทำงาน

การแสดง JSON
{
  "discoverSpaceSetting": {
    object (AccessPermissionSetting)
  },
  "joinSpaceSetting": {
    object (AccessPermissionSetting)
  },
  "viewSpaceMembershipSetting": {
    object (AccessPermissionSetting)
  }
}
ฟิลด์
discoverSpaceSetting

object (AccessPermissionSetting)

ไม่บังคับ การตั้งค่าสิทธิ์เข้าถึงสำหรับการค้นพบพื้นที่ทำงาน

joinSpaceSetting

object (AccessPermissionSetting)

ไม่บังคับ การตั้งค่าสิทธิ์เข้าถึงสำหรับการเข้าร่วมพื้นที่ทำงาน

viewSpaceMembershipSetting

object (AccessPermissionSetting)

ไม่บังคับ การตั้งค่าสิทธิ์เข้าถึงสำหรับการดูการเป็นสมาชิกของพื้นที่ทำงาน ต้องระบุร่วมกับ PermissionSettings.view_space_membership ในมาสก์การอัปเดตและเนื้อหาคำขอเมื่ออัปเดตผู้ที่มีสิทธิ์ดูการเป็นสมาชิกพื้นที่ทำงาน เมื่อให้สิทธิ์ดูแก่กลุ่มเป้าหมาย คุณต้องให้สิทธิ์ PermissionSettings.view_space_membership แก่สมาชิกทุกคนในคำขอเดียวกันด้วย หากต้องการนำกลุ่มเป้าหมายที่มีอยู่ออก (เช่น เพื่อจำกัดสิทธิ์ดูให้เฉพาะผู้จัดการพื้นที่ทำงานหรือผู้ช่วยผู้จัดการเท่านั้น) ให้ระบุ AccessPermissionSetting ที่ว่างเปล่า (ไม่มี principals)

AccessPermissionSetting

การตั้งค่าสิทธิ์การเข้าถึง

การแสดง JSON
{
  "principals": [
    {
      object (Principal)
    }
  ]
}
ฟิลด์
principals[]

object (Principal)

ไม่บังคับ รายการที่ไม่เรียงลำดับ ผู้ใช้หลักที่ได้รับอนุญาตสำหรับสิทธิ์นี้

ผู้ใช้หลัก

ผู้ใช้หลักที่แสดงถึงเอนทิตีที่ได้รับสิทธิ์เข้าถึง

การแสดง JSON
{

  "audience": {
    object (Audience)
  }
}
ช่อง
ประเภทของ Principal รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
audience

object (Audience)

กลุ่มเป้าหมาย

สิ้นสุดฟิลด์ที่แยกกัน

กลุ่มเป้าหมาย

กลุ่มเป้าหมายใน Google Chat กลุ่มเป้าหมายหมายถึงกลุ่มผู้ใช้ภายในองค์กร Google Workspace ซึ่งกำหนดโดยผู้ดูแลระบบ กลุ่มเป้าหมายใช้เพื่อกำหนดค่าการเข้าถึงและการตั้งค่าระดับการเข้าถึงสำหรับทรัพยากร เช่น การทำให้พื้นที่ทำงานค้นพบได้สำหรับกลุ่มผู้ใช้ที่เฉพาะเจาะจง

ดูรายละเอียดเพิ่มเติมได้ที่หัวข้อกลุ่มเป้าหมายและทำให้พื้นที่ทำงานค้นพบได้สำหรับกลุ่มเป้าหมาย

การแสดง JSON
{
  "name": string
}
ช่อง
name

string

ชื่อทรัพยากรของกลุ่มเป้าหมายที่สามารถค้นพบหรือเข้าร่วมพื้นที่ทำงานได้ โปรดดูรายละเอียดที่หัวข้อทำให้กลุ่มเป้าหมายค้นพบพื้นที่ทำงานได้ รูปแบบ: audiences/{audience}

หากต้องการใช้กลุ่มเป้าหมายเริ่มต้นสำหรับองค์กร Google Workspace ให้ตั้งค่าเป็น audiences/default

PredefinedPermissionSettings

การตั้งค่าสิทธิ์ที่กำหนดไว้ล่วงหน้าซึ่งคุณระบุได้เฉพาะเมื่อสร้างพื้นที่ทำงานที่มีชื่อเท่านั้น ทั้งนี้อาจมีการเพิ่มการตั้งค่าอื่นๆ ในอนาคต โปรดดูรายละเอียดเกี่ยวกับการตั้งค่าสิทธิ์สำหรับพื้นที่ทำงานที่มีชื่อที่หัวข้อดูข้อมูลเกี่ยวกับพื้นที่ทำงาน

Enum
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED ไม่ระบุ ไม่ใช้
COLLABORATION_SPACE การตั้งค่าเพื่อทำให้พื้นที่ทำงานเป็นพื้นที่สำหรับการทำงานร่วมกันซึ่งสมาชิกทุกคนสามารถโพสต์ข้อความได้
ANNOUNCEMENT_SPACE การตั้งค่าเพื่อทำให้พื้นที่ทำงานเป็นพื้นที่ประกาศซึ่งมีเพียงผู้จัดการพื้นที่ทำงานเท่านั้นที่โพสต์ข้อความได้

PermissionSettings

การตั้งค่าสิทธิ์ที่คุณระบุได้เมื่ออัปเดตพื้นที่ทำงานที่มีชื่ออยู่แล้ว

หากต้องการตั้งค่าสิทธิ์เมื่อสร้างพื้นที่ทำงาน ให้ระบุช่อง PredefinedPermissionSettings ในคำขอ

การแสดง JSON
{
  "manageMembersAndGroups": {
    object (PermissionSetting)
  },
  "modifySpaceDetails": {
    object (PermissionSetting)
  },
  "toggleHistory": {
    object (PermissionSetting)
  },
  "useAtMentionAll": {
    object (PermissionSetting)
  },
  "manageApps": {
    object (PermissionSetting)
  },
  "manageWebhooks": {
    object (PermissionSetting)
  },
  "postMessages": {
    object (PermissionSetting)
  },
  "replyMessages": {
    object (PermissionSetting)
  },
  "viewSpaceMembership": {
    object (PermissionSetting)
  }
}
ฟิลด์
manageMembersAndGroups

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการจัดการสมาชิกและกลุ่มในพื้นที่ทำงาน

modifySpaceDetails

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการอัปเดตชื่อ รูปโปรไฟล์ คำอธิบาย และหลักเกณฑ์ของพื้นที่ทำงาน

toggleHistory

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการเปิดและปิดประวัติพื้นที่ทำงาน

useAtMentionAll

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการใช้ @ทั้งหมด ในพื้นที่ทำงาน

manageApps

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการจัดการแอปในพื้นที่ทำงาน

manageWebhooks

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการจัดการเว็บฮุคในพื้นที่ทำงาน

postMessages

object (PermissionSetting)

เอาต์พุตเท่านั้น การตั้งค่าสำหรับการโพสต์ข้อความในพื้นที่ทำงาน

replyMessages

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการตอบกลับข้อความในพื้นที่ทำงาน

viewSpaceMembership

object (PermissionSetting)

ไม่บังคับ การตั้งค่าสำหรับการดูการเป็นสมาชิกของพื้นที่ทำงาน ต้องระบุร่วมกับ AccessPermissionSettings.view_space_membership_setting ในมาสก์การอัปเดตและเนื้อหาคำขอเมื่ออัปเดตผู้ที่มีสิทธิ์ดูการเป็นสมาชิกพื้นที่ทำงาน เมื่อจำกัดสิทธิ์ดูสำหรับบทบาทที่เฉพาะเจาะจง (เช่น ผู้จัดการพื้นที่ทำงานหรือผู้ช่วยผู้จัดการเท่านั้น) ให้ระบุสิทธิ์ของบทบาทที่ต้องการที่นี่ และระบุ AccessPermissionSettings.view_space_membership_setting ที่ว่างเปล่าในคำขอเดียวกัน หากมีการกำหนดค่ากลุ่มเป้าหมายใน AccessPermissionSettings.view_space_membership_setting คุณต้องให้สิทธิ์การตั้งค่านี้แก่สมาชิกทุกคน

PermissionSetting

แสดงการตั้งค่ากลุ่มสิทธิ์ของพื้นที่ทำงาน

การแสดง JSON
{
  "managersAllowed": boolean,
  "membersAllowed": boolean,
  "assistantManagersAllowed": boolean
}
ฟิลด์
managersAllowed

boolean

ไม่บังคับ เจ้าของพื้นที่ทำงาน (ROLE_MANAGER) มีสิทธิ์นี้หรือไม่

membersAllowed

boolean

ไม่บังคับ สมาชิกพื้นที่ทำงานขั้นพื้นฐาน (ROLE_MEMBER) มีสิทธิ์นี้หรือไม่

assistantManagersAllowed

boolean

ไม่บังคับ ผู้จัดการพื้นที่ทำงาน ROLE_ASSISTANT_MANAGER) มีสิทธิ์นี้หรือไม่

SpaceSessionState

สถานะเซสชันของพื้นที่ทำงาน

Enum
SPACE_SESSION_STATE_UNSPECIFIED ไม่ระบุ ไม่ใช้
NOT_SUPPORTED พื้นที่ทำงานไม่รองรับเซสชัน
THREAD พื้นที่ทำงานรองรับเซสชันตามชุดข้อความ

เมธอด

completeImport

ดำเนินการกระบวนการนำเข้าสำหรับพื้นที่ทำงานที่ระบุให้เสร็จสมบูรณ์และทำให้ผู้ใช้มองเห็นได้

create

สร้างพื้นที่ทำงาน

delete

ลบพื้นที่ทำงานที่มีชื่อ

findDirectMessage

แสดงผลข้อความส่วนตัวที่มีอยู่กับผู้ใช้ที่ระบุ

findGroupChats

แสดงผลพื้นที่ทำงานทั้งหมดที่มี spaceType == GROUP_CHAT ซึ่งการเป็นสมาชิกของบุคคลมีผู้ใช้ที่โทรและผู้ใช้ที่ระบุใน FindGroupChatsRequest.users เท่านั้น

get

แสดงรายละเอียดเกี่ยวกับพื้นที่ทำงาน

list

แสดงรายการพื้นที่ทำงานที่ผู้โทรเป็นสมาชิก

patch

อัปเดตพื้นที่ทำงาน
แสดงรายการพื้นที่ทำงานในองค์กร Google Workspace

setup

สร้างพื้นที่ทำงานและเพิ่มผู้ใช้ที่ระบุลงในพื้นที่ทำงาน