REST Resource: spaces.members

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

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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
สมาชิกที่เชื่อมโยงกับการเป็นสมาชิกนี้ และอาจรองรับสมาชิกประเภทอื่นๆ ในอนาคต ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
member

object (User)

ไม่บังคับ ผู้ใช้หรือแอป Google Chat ที่การเป็นสมาชิกนั้นๆ สอดคล้องกัน หากแอป Chat ตรวจสอบสิทธิ์ในฐานะผู้ใช้ เอาต์พุตจะแสดงเฉพาะฟิลด์ผู้ใช้ name และ type สำหรับทั้งผู้ใช้ภายในและภายนอก เว้นแต่ว่าผู้ใช้จะเป็นสมาชิกของพื้นที่ทำงานหรือมีความสัมพันธ์มาก่อน เช่น การสนทนาข้อความส่วนตัว (DM) กับผู้ใช้ที่โทร
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 และ Webhook ที่ติดตั้งในพื้นที่ทำงาน

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

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

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

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

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

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

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

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

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

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

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

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

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

กลุ่ม

Google Group ใน Google Chat

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

string

ชื่อทรัพยากรสำหรับ Google Groups

แสดงถึงกลุ่มใน 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

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