Method: spaces.members.create

Tạo gói thành viên thủ công hoặc gói thành viên trong ứng dụng cho ứng dụng gọi. Không hỗ trợ tạo gói thành viên cho các ứng dụng khác. Ví dụ: hãy xem bài viết Mời hoặc thêm người dùng hoặc ứng dụng Google Chat vào một không gian. Khi tạo thành viên, nếu thành viên được chỉ định đã tắt chính sách tự động chấp nhận, thì họ sẽ được mời và phải chấp nhận lời mời tham gia không gian. Nếu không, khi tạo một thành viên, thành viên đó sẽ được thêm trực tiếp vào không gian được chỉ định. Yêu cầu xác thực người dùng.

Để chỉ định thành viên cần thêm, hãy đặt membership.member.name cho thành viên trong ứng dụng hoặc thành viên khác, hoặc đặt membership.group_member.name cho thành viên nhóm.

  • Để thêm ứng dụng gọi điện vào một không gian hoặc tin nhắn trực tiếp giữa 2 người dùng, hãy sử dụng users/app. Không thể thêm các ứng dụng khác vào không gian.

  • Để thêm người dùng là người thật, hãy sử dụng users/{user}, trong đó {user} có thể là địa chỉ email của người dùng đó. Đối với người dùng trong cùng một tổ chức Workspace, {user} cũng có thể là id đối với người dùng trong API Mọi người hoặc id đối với người dùng trong API Thư mục. Ví dụ: nếu Mã hồ sơ cá nhân API Mọi người cho user@example.com là 123456789, bạn có thể thêm người dùng vào không gian bằng cách đặt membership.member.name thành users/user@example.com hoặc users/123456789.

  • Để thêm hoặc mời một nhóm trên Google Groups trong không gian được đặt tên, hãy sử dụng groups/{group}, trong đó {group} là id cho nhóm theo API Cloud Identity Groups. Ví dụ: bạn có thể sử dụng API tra cứu nhóm trên Cloud Identity để truy xuất mã 123456789 cho email nhóm group@example.com, sau đó thêm hoặc mời nhóm vào một không gian được đặt tên bằng cách đặt membership.group_member.name thành groups/123456789. Email nhóm không được hỗ trợ và bạn chỉ có thể thêm nhóm trên Google làm thành viên trong các không gian được đặt tên.

Yêu cầu HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Tên tài nguyên của không gian để tạo thành viên.

Định dạng: dấu cách/{space}

Tham số truy vấn

Thông số
useAdminAccess

boolean

Khi true, phương thức này sẽ chạy bằng đặc quyền của quản trị viên Google Workspace của người dùng.

Người dùng gọi phải là quản trị viên Google Workspace có đặc quyền quản lý cuộc trò chuyện và không gian trên Chat.

Yêu cầu chat.admin.memberships phạm vi OAuth 2.0.

Quyền quản trị không hỗ trợ tính năng tạo thành viên trong ứng dụng hoặc tạo thành viên cho người dùng bên ngoài tổ chức Google Workspace của quản trị viên.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Membership.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của Membership.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.