Method: spaces.members.delete

Xoá một gói thành viên. Để biết ví dụ, hãy xem phần Xoá người dùng hoặc ứng dụng Google Chat khỏi không gian.

Hỗ trợ các loại xác thực sau:

  • Xác thực ứng dụng bằng sự phê duyệt của quản trị viên và phạm vi uỷ quyền:

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

  • Xác thực người dùng bằng một trong các phạm vi uỷ quyền sau:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (để xoá ứng dụng gọi khỏi không gian)
    • https://www.googleapis.com/auth/chat.import (chỉ có khoảng trắng ở chế độ nhập)
    • Xác thực người dùng cấp đặc quyền quản trị khi một tài khoản quản trị xác thực, useAdminAccess là true và phạm vi uỷ quyền sau đây được dùng:
      • https://www.googleapis.com/auth/chat.admin.memberships

Tính năng xác thực ứng dụng không được hỗ trợ cho các trường hợp sử dụng sau:

  • Xoá một Nhóm Google khỏi không gian.
  • Xoá một ứng dụng Chat khỏi không gian.

Để xoá tư cách thành viên của người quản lý không gian, người yêu cầu phải là người quản lý không gian. Nếu bạn đang sử dụng tính năng xác thực ứng dụng, thì ứng dụng Chat phải là ứng dụng tạo không gian.

Yêu cầu HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/members/*}

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

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Tên tài nguyên của gói thành viên cần xoá. Các ứng dụng trò chuyện có thể xoá tư cách thành viên của người dùng hoặc của chính ứng dụng. Các ứng dụng trò chuyện không thể xoá gói thành viên của các ứng dụng khác.

Khi xoá một thành viên là người dùng, bạn cần có phạm vi chat.memberships với xác thực người dùng hoặc phạm vi chat.memberships.app với xác thực ứng dụng và định dạng spaces/{space}/members/{member}. Bạn có thể sử dụng email này làm email đại diện cho {member}. Ví dụ: spaces/{space}/members/example@gmail.com, trong đó example@gmail.com là email của người dùng Google Chat.

Khi xoá một gói thành viên trong ứng dụng, bạn cần có phạm vi chat.memberships.app và định dạng spaces/{space}/members/app.

Định dạng: spaces/{space}/members/{member} hoặc spaces/{space}/members/app.

Tham số truy vấn

Thông số
useAdminAccess

boolean

Không bắt buộc. Khi true, phương thức này sẽ chạy bằng đặc quyền 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.

Bạn không thể xoá thành viên ứng dụng trong một không gian bằng quyền truy cập của quản trị viên.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

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 phiên bản 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.app.memberships
  • 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.