REST Resource: spaces.members

แหล่งข้อมูล: การเป็นสมาชิก

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

การแสดง JSON 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,
  "affiliation": enum (Affiliation),

  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
}
ช่อง
name

string

ตัวระบุ ชื่อแหล่งข้อมูลของการเป็นสมาชิกที่กำหนดโดยเซิร์ฟเวอร์

รูปแบบ: spaces/{space}/members/{member}
state

enum (MembershipState)

เอาต์พุตเท่านั้น สถานะการเป็นสมาชิก
role

enum (MembershipRole)

ไม่บังคับ บทบาทของผู้ใช้ในพื้นที่ใน Chat ซึ่งกำหนดการดำเนินการที่อนุญาตในพื้นที่ทำงาน

ช่องนี้ใช้เป็นอินพุตได้ใน members.patch เท่านั้น
createTime

string (Timestamp format)

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

string (Timestamp format)

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

enum (Affiliation)

เอาต์พุตเท่านั้น ความสัมพันธ์ของผู้ใช้กับองค์กร Workspace ที่เป็นเจ้าของพื้นที่ทำงาน ในพื้นที่ทำงานที่เป็นเจ้าของโดยบัญชีผู้ใช้ทั่วไป แอฟฟิลิเอตของสมาชิกทุกคนจะเป็น EXTERNAL
ฟิลด์ Union memberType สมาชิกที่เชื่อมโยงกับการเป็นสมาชิกนี้ ระบบอาจรองรับสมาชิกประเภทอื่นๆ ในอนาคต memberType จะเป็นได้เพียงค่าใดค่าหนึ่งต่อไปนี้
member

object (User)

ไม่บังคับ ผู้ใช้หรือแอป Google Chat ที่การเป็นสมาชิกนี้เกี่ยวข้อง หากแอป Chat ของคุณตรวจสอบสิทธิ์ในฐานะผู้ใช้ เอาต์พุตจะป้อนข้อมูล ผู้ใช้ name และ type
groupMember

object (Group)

ไม่บังคับ Google Group ที่การเป็นสมาชิกนี้เกี่ยวข้อง

การอ่านหรือแก้ไขการเป็นสมาชิกสำหรับ Google Groups ต้องมีการตรวจสอบสิทธิ์ของผู้ใช้

MembershipState

ระบุความสัมพันธ์ของสมาชิกกับพื้นที่ทำงาน ระบบอาจรองรับสถานะการเป็นสมาชิกอื่นๆ ในอนาคต

Enum
MEMBERSHIP_STATE_UNSPECIFIED ค่าเริ่มต้น อย่าใช้
JOINED ผู้ใช้ได้รับการเพิ่มไปยังพื้นที่ทำงานและเข้าร่วมในพื้นที่ทำงานได้
INVITED ผู้ใช้ได้รับเชิญให้เข้าร่วมพื้นที่ทำงาน แต่ยังไม่ได้เข้าร่วม
NOT_A_MEMBER ผู้ใช้ไม่ได้อยู่ในพื้นที่ทำงานและไม่มีคำเชิญที่รอดำเนินการให้เข้าร่วมพื้นที่ทำงาน

MembershipRole

แสดงถึงการดำเนินการที่อนุญาตของผู้ใช้ในพื้นที่ใน Chat ระบบอาจเพิ่มค่า Enum อื่นๆ ในอนาคต

Enum
MEMBERSHIP_ROLE_UNSPECIFIED ค่าเริ่มต้น สำหรับ users ผู้ใช้ไม่ได้เป็นสมาชิกของพื้นที่ทำงาน แต่สามารถได้รับเชิญ สำหรับ Google Groups ระบบจะกำหนดบทบาทนี้ให้กับกลุ่มเสมอ (ระบบอาจใช้ค่า Enum อื่นๆ ในอนาคต)
ROLE_MEMBER

สมาชิกของพื้นที่ทำงาน ใน UI ของ Chat บทบาทนี้เรียกว่าสมาชิก

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

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

ในข้อความส่วนตัวและการสนทนาแบบกลุ่มที่ไม่มีชื่อ ทุกคนจะมีบทบาทนี้
ROLE_MANAGER

เจ้าของพื้นที่ทำงาน ใน UI ของ Chat บทบาทนี้เรียกว่าเจ้าของ

ผู้ใช้มีสิทธิ์ทั้งหมดในพื้นที่ทำงานเพื่อจัดการพื้นที่ทำงาน ซึ่งรวมถึงสิทธิ์ต่อไปนี้

  • เปลี่ยนบทบาทของสมาชิกคนอื่นๆ ในพื้นที่ทำงานเป็นสมาชิก ผู้จัดการ หรือเจ้าของ
  • ลบพื้นที่ทำงาน

รองรับเฉพาะใน SpaceType.SPACE (พื้นที่ทำงานที่มีชื่อ)

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

ผู้จัดการพื้นที่ทำงาน ใน UI ของ Chat บทบาทนี้เรียกว่าผู้จัดการ

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

  • ลบพื้นที่ทำงาน
  • ทำให้สมาชิกคนอื่นในพื้นที่ทำงานเป็นเจ้าของ
  • เปลี่ยนบทบาทของเจ้าของ

โดยค่าเริ่มต้น สิทธิ์ของผู้จัดการจะรวมถึงแต่ไม่จำกัดเพียงสิทธิ์ต่อไปนี้

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

รองรับเฉพาะใน SpaceType.SPACE (พื้นที่ทำงานที่มีชื่อ)

ดูข้อมูลเพิ่มเติมได้ที่ จัดการการตั้งค่าพื้นที่ทำงาน

กลุ่ม

Google Group ใน Google Chat

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

string

ชื่อแหล่งข้อมูลสำหรับ Google Group

แสดงถึงกลุ่มใน Cloud Identity Groups API

รูปแบบ: groups/{group}

แอฟฟิลิเอต

แสดงถึงแอฟฟิลิเอตของผู้ใช้กับองค์กร Google Workspace ที่เป็นเจ้าของพื้นที่ทำงาน Enum นี้อาจมีค่าเพิ่มเติมในอนาคต

Enum
AFFILIATION_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
INTERNAL บัญชีที่จัดการโดยองค์กร Google Workspace เดียวกันกับที่เป็นเจ้าของพื้นที่ทำงาน
EXTERNAL บัญชีภายนอกองค์กร Google Workspace ที่เป็นเจ้าของพื้นที่ทำงาน (เช่น บัญชีผู้ใช้ทั่วไป หรือบัญชีที่จัดการโดยองค์กร Workspace อื่น)
MANAGED_EXTERNAL บัญชีที่จัดการโดยองค์กร Workspace ที่เป็นเจ้าของพื้นที่ทำงาน แต่จัดเตรียมไว้สำหรับผู้ใช้ที่อยู่นอกองค์กร (เช่น ผู้ใช้ชั่วคราว) ดูข้อมูลเพิ่มเติมเกี่ยวกับแขกได้ที่ https://support.google.com/chat/answer/16997417

เมธอด

create

 สร้างการเป็นสมาชิกสำหรับแอป Chat ที่เรียกใช้ ผู้ใช้ หรือ Google Group

delete

 ลบการเป็นสมาชิก

get

 แสดงรายละเอียดเกี่ยวกับการเป็นสมาชิก

list

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

patch

 อัปเดตการเป็นสมาชิก