Xác thực và uỷ quyền cho các ứng dụng trong Chat cũng như các yêu cầu API Google Chat

Xác thực và uỷ quyền là các cơ chế dùng để xác minh danh tính và quyền truy cập vào tài nguyên. Tài liệu này trình bày cách hoạt động của quy trình xác thực và uỷ quyền cho các ứng dụng Chat và yêu cầu Chat API.

Tổng quan về quy trình

Sơ đồ sau đây cho thấy các bước xác thực và uỷ quyền cấp cao đối với Google Chat:

Các bước tổng quan để xác thực và uỷ quyền cho Google Chat
Hình 1. Các bước nâng cao để xác thực và uỷ quyền trong Google Chat.

  1. Định cấu hình dự án Google Cloud, bật Chat API và định cấu hình ứng dụng Chat: Trong quá trình phát triển, bạn sẽ tạo một dự án Google Cloud. Trong dự án Google Cloud, bạn bật API Chat, định cấu hình ứng dụng Chat và thiết lập tính năng xác thực. Để biết thêm thông tin, hãy xem các bài viết Phát triển trên Google WorkspaceTạo ứng dụng trong Chat.

  2. Call Chat API: Khi ứng dụng của bạn gọi Chat API, ứng dụng đó sẽ gửi thông tin xác thực đến Chat API. Nếu ứng dụng của bạn xác thực bằng tài khoản dịch vụ, thì thông tin xác thực sẽ được gửi dưới dạng một phần trong mã của ứng dụng. Nếu ứng dụng của bạn yêu cầu gọi API Chat bằng phương thức xác thực chưa được cấp của người dùng, thì ứng dụng sẽ nhắc người dùng đăng nhập.

  3. Yêu cầu tài nguyên: Ứng dụng của bạn yêu cầu quyền truy cập bằng phạm vi mà bạn chỉ định trong khi thiết lập quy trình xác thực.

  4. Xin phép người dùng: Nếu ứng dụng của bạn xác thực với tư cách là người dùng, thì Google sẽ hiển thị màn hình xin phép bằng OAuth để người dùng có thể quyết định xem có cấp cho ứng dụng của bạn quyền truy cập vào dữ liệu được yêu cầu hay không. Việc xác thực bằng tài khoản dịch vụ không yêu cầu sự đồng ý của người dùng.

  5. Gửi yêu cầu được phê duyệt đối với tài nguyên: Nếu người dùng đồng ý với các phạm vi uỷ quyền, ứng dụng của bạn sẽ nhóm thông tin xác thực và các phạm vi được người dùng phê duyệt thành một yêu cầu. Yêu cầu này được gửi đến máy chủ uỷ quyền của Google để lấy mã truy cập.

  6. Google trả về một mã truy cập: Mã truy cập chứa danh sách các phạm vi đã cấp. Nếu danh sách phạm vi được trả về hạn chế hơn phạm vi được yêu cầu, thì ứng dụng của bạn sẽ tắt mọi tính năng bị giới hạn bởi mã thông báo.

  7. Truy cập vào tài nguyên được yêu cầu: Ứng dụng của bạn sử dụng mã truy cập của Google để gọi API Chat và truy cập vào tài nguyên API Chat.

  8. Nhận mã làm mới (không bắt buộc): Nếu phải truy cập vào API Google Chat sau thời gian hoạt động của một mã truy cập duy nhất, thì ứng dụng có thể nhận được mã làm mới. Để biết thêm thông tin, hãy xem bài viết Sử dụng OAuth 2.0 để truy cập vào API của Google.

  9. Yêu cầu thêm tài nguyên: Nếu cần thêm quyền truy cập, ứng dụng của bạn sẽ yêu cầu người dùng cấp phạm vi mới, dẫn đến yêu cầu mới để lấy mã truy cập (bước 3-6).

Trường hợp ứng dụng Chat yêu cầu xác thực

Ứng dụng trò chuyện có thể gửi tin nhắn để phản hồi hoạt động tương tác của người dùng hoặc gửi tin nhắn không đồng bộ. Họ cũng có thể thay mặt người dùng hoàn thành các thao tác, chẳng hạn như tạo phòng Chat hoặc lấy danh sách người dùng trong phòng Chat.

Ứng dụng trò chuyện không yêu cầu xác thực để phản hồi hoạt động tương tác của người dùng, trừ phi ứng dụng trò chuyện gọi Chat API hoặc một API khác của Google trong khi xử lý phản hồi.

Để gửi tin nhắn không đồng bộ hoặc thay mặt người dùng thực hiện các thao tác, ứng dụng Chat sẽ tạo các yêu cầu RESTful đến Chat API. API này yêu cầu xác thực và uỷ quyền.

Phản hồi cho tương tác của người dùng không yêu cầu xác thực

Các ứng dụng Google Chat không cần xác thực là người dùng hoặc ứng dụng Chat để nhận và phản hồi đồng bộ các sự kiện tương tác.

Ứng dụng Google Chat nhận được các sự kiện tương tác mỗi khi người dùng tương tác hoặc gọi một ứng dụng Chat, bao gồm:

  • Người dùng gửi tin nhắn đến một ứng dụng Chat.
  • Người dùng @đề cập đến một ứng dụng Chat.
  • Người dùng gọi một trong các lệnh dấu gạch chéo của ứng dụng Chat.

Sơ đồ dưới đây cho thấy trình tự phản hồi yêu cầu giữa người dùng Chat và ứng dụng Chat:

Các sự kiện tương tác trong ứng dụng Chat không cần được cho phép
Hình 2. Các sự kiện tương tác với ứng dụng Chat không yêu cầu xác thực.

  1. Người dùng gửi tin nhắn đến ứng dụng Chat trong Google Chat.
  2. Google Chat sẽ chuyển tiếp tin nhắn đó đến ứng dụng.
  3. Ứng dụng sẽ nhận được thông báo, xử lý thông báo đó và trả về phản hồi cho Google Chat.
  4. Google Chat hiển thị phản hồi cho người dùng hoặc trong một không gian.

Trình tự này lặp lại cho mỗi sự kiện tương tác với ứng dụng Chat.

Thông báo không đồng bộ yêu cầu xác thực

Tin nhắn không đồng bộ xảy ra khi một ứng dụng Chat gửi yêu cầu đến Chat API. API này yêu cầu xác thực và uỷ quyền.

Bằng cách gọi API Chat, các ứng dụng trong Chat có thể đăng tin nhắn lên Google Chat hoặc hoàn thành công việc và truy cập vào dữ liệu thay mặt người dùng. Ví dụ: sau khi phát hiện sự cố ngừng hoạt động của máy chủ, ứng dụng Chat có thể gọi Chat API để:

  • Tạo phòng Chat riêng để điều tra và khắc phục sự cố.
  • Thêm người khác vào phòng Chat.
  • Đăng thông báo lên phòng Chat để cung cấp thông tin chi tiết về sự cố.

Sơ đồ sau đây cho thấy một trình tự thông báo không đồng bộ giữa ứng dụng Chat và không gian Chat:

Yêu cầu xác thực cho các thông báo không đồng bộ
Hình 3. Các thông báo không đồng bộ yêu cầu xác thực.

  1. Một ứng dụng Chat tạo tin nhắn bằng cách gọi API Chat bằng phương thức spaces.messages.create và đưa thông tin đăng nhập của người dùng vào yêu cầu HTTP.
  2. Google Chat xác thực ứng dụng Chat bằng tài khoản dịch vụ hoặc thông tin đăng nhập của người dùng.
  3. Google Chat hiển thị tin nhắn của ứng dụng cho một không gian Chat được chỉ định.

Phạm vi Chat API

Định cấu hình màn hình xin phép bằng OAuth và chọn phạm vi để xác định thông tin nào sẽ hiển thị cho người dùng và người đánh giá ứng dụng, đồng thời đăng ký ứng dụng để bạn có thể phát hành vào lúc khác.

Để xác định cấp truy cập được cấp cho ứng dụng, bạn cần xác định và khai báo phạm vi uỷ quyền. Phạm vi uỷ quyền là một chuỗi URI OAuth 2.0 chứa tên ứng dụng Google Workspace, loại dữ liệu mà ứng dụng truy cập và cấp truy cập.

Phạm vi không nhạy cảm

Mã phạm vi Mô tả
https://www.googleapis.com/auth/chat.bot

Cho phép các ứng dụng trong Chat xem cuộc trò chuyện và gửi tin nhắn.

Phạm vi này chỉ hỗ trợ xác thực ứng dụng bằng tài khoản dịch vụ. Bạn không thể xác thực bằng thông tin đăng nhập của người dùng hoặc uỷ quyền trên toàn miền ở phạm vi này.

Phạm vi nhạy cảm

Mã phạm vi Mô tả
https://www.googleapis.com/auth/chat.spaces Tạo cuộc trò chuyện và không gian cũng như xem hoặc chỉnh sửa siêu dữ liệu (bao gồm cả chế độ cài đặt nhật ký và chế độ cài đặt quyền truy cập) trong Chat.
https://www.googleapis.com/auth/chat.spaces.create Tạo cuộc trò chuyện mới trong Chat.
https://www.googleapis.com/auth/chat.spaces.readonly Xem cuộc trò chuyện và không gian trong Chat.
https://www.googleapis.com/auth/chat.memberships Xem, thêm, cập nhật và xoá thành viên khỏi cuộc trò chuyện trong Chat.
https://www.googleapis.com/auth/chat.memberships.app Thêm và xoá chính ứng dụng khỏi cuộc trò chuyện trong Google Chat.
https://www.googleapis.com/auth/chat.memberships.readonly Xem thành viên trong các cuộc trò chuyện trên Chat.
https://www.googleapis.com/auth/chat.messages.create Soạn và gửi tin nhắn trong Chat.
https://www.googleapis.com/auth/chat.messages.reactions Xem, thêm và xoá các biểu tượng cảm xúc đối với tin nhắn trong Chat.
https://www.googleapis.com/auth/chat.messages.reactions.create Thêm biểu tượng cảm xúc vào tin nhắn trong Chat.
https://www.googleapis.com/auth/chat.messages.reactions.readonly Xem các lượt bày tỏ cảm xúc với một tin nhắn trong Chat.
https://www.googleapis.com/auth/chat.users.readstate Xem và sửa đổi dấu thời gian đọc cuộc trò chuyện gần đây nhất trên Chat.
https://www.googleapis.com/auth/chat.users.readstate.readonly Xem thời gian đọc gần đây nhất đối với các cuộc trò chuyện trên Chat.
https://www.googleapis.com/auth/chat.admin.spaces.readonly Xem cuộc trò chuyện và không gian do miền của quản trị viên sở hữu trong Chat.
https://www.googleapis.com/auth/chat.admin.spaces Xem hoặc chỉnh sửa cuộc trò chuyện và không gian thuộc sở hữu của miền của quản trị viên trong Chat.
https://www.googleapis.com/auth/chat.admin.memberships.readonly Xem thành viên và người quản lý trong các cuộc trò chuyện thuộc sở hữu của miền của quản trị viên trong Chat.
https://www.googleapis.com/auth/chat.admin.memberships Xem, thêm, cập nhật và xoá thành viên cũng như người quản lý trong các cuộc trò chuyện do miền của quản trị viên sở hữu trong Chat.
https://www.googleapis.com/auth/chat.app.spaces

Tạo cuộc trò chuyện và không gian cũng như xem hoặc cập nhật siêu dữ liệu (bao gồm cả chế độ cài đặt nhật ký và chế độ cài đặt quyền truy cập) trong Chat. Yêu cầu quản trị viên phê duyệt.

Phạm vi này chỉ hỗ trợ việc xác thực ứng dụng với tài khoản dịch vụ. Bạn không thể xác thực bằng thông tin đăng nhập của người dùng hoặc uỷ quyền trên toàn miền ở phạm vi này.

https://www.googleapis.com/auth/chat.app.spaces.create

Tạo cuộc trò chuyện và không gian mới trong Chat. Yêu cầu quản trị viên phê duyệt.

Phạm vi này chỉ hỗ trợ xác thực ứng dụng bằng tài khoản dịch vụ. Bạn không thể xác thực bằng thông tin đăng nhập của người dùng hoặc bằng quyền uỷ quyền trên toàn miền bằng phạm vi này.

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

Xem, thêm, cập nhật và xoá thành viên khỏi các cuộc trò chuyện và không gian trong Chat. Yêu cầu quản trị viên phê duyệt.

Phạm vi này chỉ hỗ trợ xác thực ứng dụng với tài khoản dịch vụ. Bạn không thể xác thực bằng thông tin đăng nhập của người dùng hoặc bằng tính năng uỷ quyền trên toàn miền bằng phạm vi này.

https://www.googleapis.com/auth/chat.customemojis Xem, tạo và xoá biểu tượng cảm xúc tuỳ chỉnh trong Chat.
https://www.googleapis.com/auth/chat.customemojis.readonly Xem biểu tượng cảm xúc tuỳ chỉnh trong Chat.
https://www.googleapis.com/auth/chat.users.spacesettings Xem và cập nhật chế độ cài đặt không gian của người dùng Chat.

Xem các API cài đặt của người dùng không gian: getSpaceNotificationSetting, updateSpaceNotificationSetting

Phạm vi bị hạn chế

Mã phạm vi Mô tả
https://www.googleapis.com/auth/chat.delete Xoá các cuộc trò chuyện và không gian, đồng thời xoá quyền truy cập vào các tệp được liên kết trong Chat.
https://www.googleapis.com/auth/chat.import Nhập không gian, tin nhắn và thành viên vào Chat. Để biết thêm thông tin, hãy xem phần Uỷ quyền cho ứng dụng Chat nhập dữ liệu
https://www.googleapis.com/auth/chat.messages Xem, soạn, gửi, cập nhật và xoá tin nhắn cũng như thêm, xem và xoá biểu tượng cảm xúc đối với tin nhắn.
https://www.googleapis.com/auth/chat.messages.readonly Xem tin nhắn và lượt thể hiện cảm xúc trong Chat.
https://www.googleapis.com/auth/chat.admin.delete Xoá các cuộc trò chuyện và không gian do miền của quản trị viên sở hữu, đồng thời xoá quyền truy cập vào các tệp có liên quan trong Chat.
https://www.googleapis.com/auth/chat.app.delete

Xoá các cuộc trò chuyện và không gian, đồng thời xoá quyền truy cập vào các tệp có liên quan trong Chat. Yêu cầu quản trị viên phê duyệt.

Phạm vi này chỉ hỗ trợ xác thực ứng dụng bằng tài khoản dịch vụ. Bạn không thể xác thực bằng thông tin đăng nhập của người dùng hoặc uỷ quyền trên toàn miền ở phạm vi này.

Phạm vi trong các bảng trước cho biết độ nhạy của phạm vi đó, theo các định nghĩa sau:

Nếu ứng dụng của bạn yêu cầu quyền truy cập vào bất kỳ API nào khác của Google, bạn cũng có thể thêm các phạm vi đó. Để biết thêm thông tin về phạm vi API của Google, hãy xem bài viết Sử dụng OAuth 2.0 để truy cập vào API của Google.

Để tìm hiểu thêm về phạm vi cho API Google Workspace, hãy xem bài viết Định cấu hình màn hình xin phép bằng OAuth và chọn phạm vi.

Các loại xác thực bắt buộc

Có 2 cách mà các ứng dụng trong Chat có thể xác thực và uỷ quyền thông qua API Chat:

Xác thực người dùng
Xác thực người dùng cho phép ứng dụng Chat truy cập vào dữ liệu người dùng và thay mặt người dùng hoàn tất các thao tác. Phạm vi OAuth chỉ định dữ liệu và hành động được uỷ quyền. Trừ phi ứng dụng Chat được quản trị viên cài đặt hoặc được cấp quyền uỷ quyền trên toàn miền, thì trong lần đầu tiên ứng dụng Chat thực hiện hành động thay mặt cho người dùng, người dùng phải uỷ quyền cho ứng dụng Chat bằng màn hình xin phép bằng OAuth.
Xác thực ứng dụng

Tính năng xác thực ứng dụng cho phép ứng dụng Chat sử dụng thông tin xác thực tài khoản dịch vụ, truy cập vào dữ liệu và hoàn tất các thao tác dưới dạng chính ứng dụng đó. Vì ứng dụng Chat sử dụng thông tin xác thực của riêng ứng dụng để truy cập và xử lý tài nguyên, nên người dùng cuối không cần phê duyệt các lệnh gọi API của ứng dụng Chat và bạn không thể thêm các phạm vi uỷ quyền OAuth hỗ trợ uỷ quyền ứng dụng vào màn hình đồng ý OAuth.

Hai loại phạm vi uỷ quyền OAuth hỗ trợ xác thực ứng dụng:

  • https://www.googleapis.com/auth/chat.bot: Ứng dụng Chat của bạn có thể gọi các phương thức API Google Chat hỗ trợ phạm vi uỷ quyền này để tạo, cập nhật, lấy, liệt kê hoặc xoá các tài nguyên mà ứng dụng có quyền truy cập, chẳng hạn như tin nhắn trong không gian mà người dùng cuối thêm ứng dụng Chat của bạn vào. Ứng dụng Chat của bạn có thể tự cấp phạm vi uỷ quyền này mà không cần quản trị viên hoặc người dùng cuối uỷ quyền.
  • https://www.googleapis.com/auth/chat.app.* (Bản dùng thử cho nhà phát triển): Việc sử dụng các phạm vi này yêu cầu quản trị viên phê duyệt một lần. Để được quản trị viên phê duyệt, bạn cần chuẩn bị tài khoản dịch vụ của ứng dụng Chat để được quản trị viên phê duyệt bằng cách tạo một ứng dụng OAuth tương thích với Google Workspace Marketplace và định cấu hình ứng dụng đó trong SDK của Google Workspace Marketplace. Các phạm vi này cho phép ứng dụng Chat của bạn gọi các phương thức cụ thể của API Google Chat. Ví dụ: chat.app.spaces.create cho phép các ứng dụng tạo không gian trò chuyện.

Nếu một phương thức hỗ trợ cả xác thực người dùng hoặc ứng dụng, thì Chat API sẽ trả về các kết quả khác nhau dựa trên loại xác thực mà bạn sử dụng:

  • Với tính năng xác thực ứng dụng, các phương thức chỉ trả về các tài nguyên mà ứng dụng Chat có thể truy cập.
  • Với tính năng xác thực người dùng, các phương thức chỉ trả về các tài nguyên mà người dùng có thể truy cập.

Ví dụ: việc gọi phương thức spaces.list() có uỷ quyền ứng dụng sẽ trả về danh sách không gian có ứng dụng Chat. Việc gọi spaces.list() với quyền uỷ quyền của người dùng sẽ trả về danh sách không gian mà người dùng là thành viên. Trong thực tế, bạn có thể sử dụng cả hai loại xác thực khi gọi Chat API, tuỳ thuộc vào thiết kế và tính năng của ứng dụng Chat.

Đối với các lệnh gọi API Chat không đồng bộ

Bảng sau đây liệt kê các phương thức Chat API và phạm vi uỷ quyền được hỗ trợ của các phương thức đó:

Phương thức Hỗ trợ xác thực người dùng Hỗ trợ xác thực ứng dụng Phạm vi uỷ quyền được hỗ trợ
Không gian  
Tạo không gian Với Xác thực người dùng:
  • chat.spaces.create
  • chat.spaces
  • chat.import
Với Xác thực ứng dụngquyền phê duyệt của quản trị viên (có trong Bản dùng thử cho nhà phát triển):
  • chat.app.spaces.create
  • chat.app.spaces
Thiết lập không gian Với Xác thực người dùng:
  • chat.spaces.create
  • chat.spaces
Tạo không gian Với Xác thực người dùng:
  • chat.spaces.readonly
  • chat.spaces
Với tính năng Xác thực người dùng bằng đặc quyền của quản trị viên:
  • chat.admin.spaces.readonly
Với tính năng Xác thực ứng dụng:
  • chat.bot
Với Xác thực ứng dụngquyền phê duyệt của quản trị viên (có trong Bản dùng thử cho nhà phát triển):
  • chat.app.spaces
Liệt kê không gian Với Xác thực người dùng:
  • chat.spaces.readonly
  • chat.spaces
Với Xác thực ứng dụng:
  • chat.bot
Tìm kiếm không gian Với Xác thực người dùng bằng quyền quản trị:
  • chat.admin.spaces.readonly
Cập nhật không gian Với tính năng Xác thực người dùng:
  • chat.spaces
  • chat.import
Với Xác thực người dùng bằng quyền quản trị:
  • chat.admin.spaces
Với tính năng Xác thực ứng dụngphê duyệt của quản trị viên (có trong Bản dùng thử cho nhà phát triển):
  • chat.app.spaces
Xoá không gian Với Xác thực người dùng:
  • chat.delete
  • chat.import
Với tính năng Xác thực người dùng bằng đặc quyền của quản trị viên:
  • chat.admin.delete
Với tính năng Xác thực ứng dụngphê duyệt của quản trị viên (có trong Bản dùng thử cho nhà phát triển):
  • chat.app.delete
Hoàn tất quy trình nhập cho một không gian Với Xác thực người dùng:
  • chat.import
Tìm tin nhắn trực tiếp Với Xác thực người dùng:
  • chat.spaces.readonly
  • chat.spaces
Với Xác thực ứng dụng:
  • chat.bot
Thành viên  
Tạo thành viên Với Xác thực người dùng:
  • chat.memberships
  • chat.memberships.app
  • chat.import
Với Xác thực người dùng bằng quyền quản trị:
  • chat.admin.memberships
Với Xác thực ứng dụngquyền phê duyệt của quản trị viên (có trong Bản dùng thử cho nhà phát triển):
  • chat.app.memberships
Đăng ký gói thành viên Với Xác thực người dùng:
  • chat.memberships.readonly
  • chat.memberships
Với tính năng Xác thực ứng dụng:
  • chat.bot
Với tính năng Xác thực người dùng bằng đặc quyền của quản trị viên:
  • chat.admin.memberships.readonly
Thành viên trong danh sách Với Xác thực người dùng:
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
Với Xác thực ứng dụng:
  • chat.bot
Với Xác thực người dùng bằng quyền quản trị:
  • chat.admin.memberships.readonly
Xoá thành viên Với Xác thực người dùng:
  • chat.memberships
  • chat.memberships.app
  • chat.import
Với Xác thực người dùng bằng quyền quản trị:
  • chat.admin.memberships
Với Xác thực ứng dụngquyền phê duyệt của quản trị viên (có trong Bản dùng thử cho nhà phát triển):
  • chat.app.memberships
Cập nhật thành viên Với tính năng Xác thực người dùng:
  • chat.memberships
  • chat.import
Với Xác thực người dùng bằng quyền quản trị:
  • chat.admin.memberships
Với tính năng Xác thực ứng dụngphê duyệt của quản trị viên (có trong Bản dùng thử cho nhà phát triển):
  • chat.app.memberships
Tin nhắn  
Tạo thông báo Với Xác thực người dùng:
  • chat.messages.create
  • chat.messages
  • chat.import
Với Xác thực ứng dụng:
  • chat.bot
Nhận tin nhắn Với Xác thực người dùng:
  • chat.messages.readonly
  • chat.messages
Với tính năng Xác thực ứng dụng:
  • chat.bot
Liệt kê tin nhắn Với Xác thực người dùng:
  • chat.messages.readonly
  • chat.messages
  • chat.import
Cập nhật tin nhắn Với tính năng Xác thực người dùng:
  • chat.messages
  • chat.import
Với Xác thực ứng dụng:
  • chat.bot
Xoá tin nhắn Với Xác thực người dùng:
  • chat.messages
  • chat.import
Với Xác thực ứng dụng:
  • chat.bot
Bày tỏ cảm xúc  
Tạo phản ứng Với Xác thực người dùng:
  • chat.messages.reactions.create
  • chat.messages.reactions
  • chat.messages
  • chat.import
Liệt kê các lượt thể hiện cảm xúc Với Xác thực người dùng:
  • chat.messages.reactions.readonly
  • chat.messages.reactions
  • chat.messages.readonly
  • chat.messages
Xoá lượt bày tỏ cảm xúc Với tính năng Xác thực người dùng:
  • chat.messages.reactions
  • chat.messages
  • chat.import
Biểu tượng cảm xúc tuỳ chỉnh  
Tạo biểu tượng cảm xúc tuỳ chỉnh Với tính năng Xác thực người dùng:
  • chat.customemojis
Xoá biểu tượng cảm xúc tuỳ chỉnh Với tính năng Xác thực người dùng:
  • chat.customemojis
Tạo biểu tượng cảm xúc tuỳ chỉnh Với tính năng Xác thực người dùng:
  • chat.customemojis
  • chat.customemojis.readonly
Liệt kê biểu tượng cảm xúc tuỳ chỉnh Với tính năng Xác thực người dùng:
  • chat.customemojis
  • chat.customemojis.readonly
Nội dung nghe nhìn và tệp đính kèm  
Tải nội dung nghe nhìn lên dưới dạng tệp đính kèm Với Xác thực người dùng:
  • chat.messages.create
  • chat.messages
  • chat.import
Tải nội dung nghe nhìn xuống Với tính năng Xác thực người dùng:
  • chat.messages.readonly
  • chat.messages
Với Xác thực ứng dụng:
  • chat.bot
Nhận tệp đính kèm tin nhắn Với tính năng Xác thực ứng dụng:
  • chat.bot
Trạng thái đọc của người dùng
Lấy trạng thái đọc không gian của người dùng Với tính năng Xác thực người dùng:
  • chat.users.readstate
  • chat.users.readstate.readonly
Cập nhật trạng thái đọc không gian của người dùng Với Xác thực người dùng:
  • chat.users.readstate
Nhận trạng thái đọc luồng của người dùng Với Xác thực người dùng:
  • chat.users.readstate
  • chat.users.readstate.readonly
Cài đặt không gian của người dùng
Xem chế độ cài đặt thông báo về không gian của người dùng Với tính năng Xác thực người dùng:
  • chat.users.spacesettings
Cập nhật chế độ cài đặt thông báo về không gian của người dùng Với Xác thực người dùng:
  • chat.users.spacesettings
Sự kiện trên Space
Nhận sự kiện trong không gian Với tính năng Xác thực người dùng, bạn phải sử dụng một phạm vi dựa trên loại sự kiện:
  • Đối với các sự kiện về tin nhắn:
    • chat.messages
    • chat.messages.readonly
  • Đối với sự kiện về lượt phản ứng:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • Đối với sự kiện về gói hội viên:
    • chat.memberships
    • chat.memberships.readonly
  • Đối với các sự kiện về không gian:
    • chat.spaces
    • chat.spaces.readonly
Liệt kê sự kiện trong không gian Với tính năng Xác thực người dùng, bạn phải sử dụng phạm vi cho từng loại sự kiện có trong yêu cầu:
  • Đối với sự kiện về tin nhắn:
    • chat.messages
    • chat.messages.readonly
  • Đối với sự kiện về lượt phản ứng:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • Đối với sự kiện về gói hội viên:
    • chat.memberships
    • chat.memberships.readonly
  • Đối với sự kiện về không gian:
    • chat.spaces
    • chat.spaces.readonly

Đối với sự kiện tương tác với ứng dụng Chat

Bảng sau đây liệt kê các cách phổ biến mà người dùng tương tác với ứng dụng Chat và liệu ứng dụng có yêu cầu hoặc hỗ trợ xác thực hay không:

Trường hợp Không yêu cầu xác thực Có hỗ trợ xác thực người dùng Hỗ trợ Xác thực ứng dụng
Nhận tin nhắn từ:
Sự kiện tương tác với ứng dụng trò chuyện
Lệnh gọi lại Apps Script
Google Cloud Pub/Sub
Trả lời tin nhắn:
Đồng bộ, sử dụng sự kiện tương tác với ứng dụng Chat
Đồng bộ, sử dụng giá trị trả về của lệnh gọi lại trong Apps Script
Gửi tin nhắn mới:
Với các webhook đến