Method: spaces.members.delete

Xoá gói thành viên. Ví dụ: hãy xem bài viết Xoá người dùng hoặc ứng dụng Google Chat khỏi một không gian.

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

  • Xác thực ứng dụng bằng quyền phê duyệt của quản trị viên trong Bản dùng thử dành cho nhà phát triể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ỉ dành cho dấu cách ở chế độ nhập)
    • Quy trình xác thực người dùng cấp đặc quyền quản trị khi tài khoản quản trị xác thực, useAdminAccesstrue và phạm vi uỷ quyền sau đây được sử 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á ứng dụng Chat khỏi không gian.

Để xoá gói 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á. Ứng dụng trò chuyện có thể xoá gói thành viên của người dùng hoặc của chính ứng dụng. Ứ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á gói thành viên của người dùng, yêu cầu phạm vi chat.memberships với quy trình xác thực người dùng hoặc phạm vi chat.memberships.app với quy trình 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/[email protected], trong đó [email protected] là email của người dùng Google Chat.

Khi xoá gói thành viên của ứng dụng, bạn phải 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ác đặ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à cuộc trò chuyện trong không gian.

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

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

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.