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
สมาชิกที่เชื่อมโยงกับการเป็นสมาชิกนี้ และอาจรองรับสมาชิกประเภทอื่นๆ ในอนาคต ต่อไปนี้คือรายการฟิลด์ที่แยกกัน ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
member

object (User)

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

object (Group)

ไม่บังคับ กลุ่ม Google ที่การเป็นสมาชิกสอดคล้องกัน

การอ่านหรือการเปลี่ยนแปลงการเป็นสมาชิก 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 ของแชท บทบาทนี้เรียกว่าเจ้าของ

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

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

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

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

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

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

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

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

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

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

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

กลุ่ม

Google Group ใน Google Chat

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

string

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

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

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