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,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}
ช่อง
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 หรือไม่ ขณะที่นําเข้าพื้นที่ทำงาน ผู้ใช้จะไม่เห็นพื้นที่ทำงานดังกล่าวจนกว่าการนําเข้าจะเสร็จสมบูรณ์

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 สำหรับผู้ใช้ในการเข้าถึงพื้นที่ทำงาน

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

enum (PredefinedPermissionSettings)

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

permissionSettings

object (PermissionSettings)

ไม่บังคับ การตั้งค่าสิทธิ์ที่แน่นอนซึ่งกำหนดให้อัปเดตพื้นที่ทำงานได้ อินพุตสำหรับการอัปเดตพื้นที่ทำงาน หากไม่เป็นเช่นนั้น ให้แสดงเฉพาะเอาต์พุต หากต้องการสร้างพื้นที่ทำงาน โปรดใช้ predefinedPermissionSettings แทน

ประเภท

เลิกใช้งานแล้ว: ใช้ SpaceType แทน

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

SpaceType

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

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

SpaceThreadingState

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

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

SpaceDetails

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

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

string

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

รองรับสูงสุด 150 อักขระ

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
}
ช่อง
accessState

enum (AccessState)

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

audience

string

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

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

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

AccessState

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

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

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)
  }
}
ช่อง
manageMembersAndGroups

object (PermissionSetting)

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

modifySpaceDetails

object (PermissionSetting)

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

toggleHistory

object (PermissionSetting)

การตั้งค่าเพื่อเปิด/ปิดประวัติพื้นที่ทำงาน

useAtMentionAll

object (PermissionSetting)

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

manageApps

object (PermissionSetting)

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

manageWebhooks

object (PermissionSetting)

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

postMessages

object (PermissionSetting)

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

replyMessages

object (PermissionSetting)

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

PermissionSetting

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

การแสดง JSON
{
  "managersAllowed": boolean,
  "membersAllowed": boolean
}
ช่อง
managersAllowed

boolean

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

membersAllowed

boolean

สมาชิกที่ไม่ใช่ผู้จัดการจะมีสิทธิ์นี้หรือไม่

เมธอด

completeImport

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

create

สร้างพื้นที่ทำงานที่ไม่มีสมาชิก

delete

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

findDirectMessage

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

get

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

list

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

patch

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

setup

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