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ế được dùng để xác minh danh tính và quyền truy cập vào tài nguyên, tương ứng. 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 đối với 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 cho Google Chat:

Các bước chung để xác thực và uỷ quyền Google Chat
Hình 1. Các bước chung để xác thực và uỷ quyền cho Google Chat.

  1. Định cấu hình một dự án trê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 trên Google Cloud. Trong dự án Google Cloud, bạn bật Chat API, định cấu hình ứng dụng Chat và thiết lập quy trình xác thực. Để biết thêm thông tin, hãy xem phần Phát triển trên Google WorkspaceTạo ứng dụng Chat.

  2. Gọi 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 đăng nhập sẽ được gửi dưới dạng một phần của mã ứng dụng. Nếu ứng dụng của bạn yêu cầu gọi Chat API bằng thông tin xác thực của người dùng chưa được cấp, 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. Yêu cầu sự đồng ý: Nếu ứng dụng của bạn đang xác thực với tư cách là người dùng, thì Google sẽ hiển thị màn hình yêu cầu sự đồng ý qua 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. 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 đã phê duyệt về 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ẽ gói thông tin đăng nhập và các phạm vi do người dùng phê duyệt vào một yêu cầu. Yêu cầu được gửi đến máy chủ uỷ quyền của Google để lấy mã truy cập.

  6. Google trả về mã truy cập: Mã truy cập chứa danh sách các phạm vi được cấp. Nếu danh sách phạm vi được trả về có tính 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 các 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 các tài nguyên của 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 ngoài thời gian tồn tại của một mã truy cập duy nhất, thì ứng dụng của bạn có thể nhận 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 các 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 một yêu cầu mới để nhận mã truy cập (các bước 3-6).

Khi các ứng dụng Chat yêu cầu xác thực

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

Các ứng dụng trò chuyện không yêu cầu xác thực để phản hồi một lượt 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 Google API khác 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 tác vụ, các ứng dụng Chat sẽ đưa ra yêu cầu RESTful cho Chat API. API này yêu cầu xác thực và uỷ quyền.

Không cần xác thực đối với các phản hồi cho hoạt động tương tác của người dùng

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

Các ứng dụng Google Chat nhận đượ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 cả những sự kiện sau:

  • 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 của ứng dụng Chat.

Sơ đồ sau đây cho thấy một chuỗi yêu cầu-phản hồi giữa người dùng Chat và ứng dụng Chat:

Không cần có quyền cho các sự kiện tương tác của ứng dụng Chat
Hình 2.Các sự kiện tương tác của ứng dụng trò chuyện 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 nhận tin nhắn, xử lý tin nhắn đó và trả về phản hồi cho Google Chat.
  4. Google Chat hiển thị câu trả lờ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 trên ứ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. Yêu cầu này cần có quy trình xác thực và uỷ quyền.

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

  • Tạo một không gian Chat dành riêng cho việc điều tra và khắc phục sự cố ngừng hoạt động.
  • Thêm người vào không gian trên Chat.
  • Đăng tin nhắn vào phòng Chat để cung cấp thông tin chi tiết về sự cố ngừng hoạt động.

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

Bạn phải xác thực cho các thông báo không đồng bộ
Hình 3. Thông báo không đồng bộ yêu cầu xác thực.

  1. Ứng dụng Chat tạo một tin nhắn bằng cách gọi API Chat bằng phương thức spaces.messages.create và bao gồm thông tin đăng nhập của người dùng trong 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 trong một không gian Chat cụ thể.

Phạm vi của Chat API

Định cấu hình màn hình đồ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ể xuất bản ứng dụng sau này.

Để xác định cấp truy cập được cấp cho ứng dụng của bạn, 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 ứng dụng Chat xem các 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 bằng quyền uỷ thác trên toàn miền bằng 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 các cuộc trò chuyện trong Chat.
https://www.googleapis.com/auth/chat.memberships.app Tự 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 phản ứng đố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 biểu tượng cảm xúc đối 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 trên Chat lần gần đây nhất.
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 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 do miền của quản trị viên sở hữu 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 sự phê duyệt của quản trị viê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 bằng quyền uỷ thác trên toàn miền bằng 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 sự phê duyệt của quản trị viê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 bằng quyền uỷ thác 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 cuộc trò chuyện và không gian trong Chat. Cần có sự phê duyệt của quản trị viê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 bằng quyền uỷ thác 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 người dùng Chat.

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 quan trong Chat.
https://www.googleapis.com/auth/chat.import Nhập phòng trò chuyện, tin nhắn và thành viên vào Chat. Để biết thêm thông tin, hãy xem bài viết Cho phép ứ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à biểu tượng 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. Cần có sự phê duyệt của quản trị viê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 bằng quyền uỷ thác trên toàn miền bằng phạm vi này.

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

Nếu ứng dụng của bạn cần có 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ề các 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 các API của Google.

Để tìm hiểu thêm về các phạm vi cho API Google Workspace, hãy xem phần Định cấu hình màn hình đồng ý OAuth và chọn phạm vi.

Các loại phương thức xác thực bắt buộc

Có 2 cách để ứng dụng Chat xác thực và uỷ quyền bằng Chat API:

Xác thực người dùng
Xác thực người dùng cho phép một ứng dụng Chat truy cập vào dữ liệu người dùng và hoàn tất các thao tác thay mặt người dùng. 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, 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

Xác thực ứng dụng cho phép một ứ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 với tư cách là chính ứng dụng đó. Vì ứng dụng Chat sử dụng thông tin đăng nhập riêng để truy cập và làm việc với các 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ợ việc 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 Google Chat API hỗ trợ phạm vi uỷ quyền này để tạo, cập nhật, nhận, 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 có sự uỷ quyền của quản trị viên hoặc người dùng cuối.
  • https://www.googleapis.com/auth/chat.app.*: Để sử dụng các phạm vi này, bạn cần có sự phê duyệt một lần của quản trị viên. Để nhận được sự phê duyệt của quản trị viên, bạn cần chuẩn bị tài khoản dịch vụ của ứng dụng Chat để nhận được sự phê duyệt của quản trị viên 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 Google Workspace Marketplace SDK. 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 Chat.

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 này chỉ trả về những 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ề những 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() bằng uỷ quyền ứng dụng sẽ trả về danh sách các không gian mà ứng dụng Chat là thành viên. Khi gọi spaces.list() bằng uỷ quyền của người dùng, hệ thống sẽ trả về danh sách các không gian mà người dùng là thành viên. Trên thực tế, bạn có thể sử dụng cả hai loại xác thực khi gọi API Chat, tuỳ thuộc vào thiết kế và các tính năng của ứng dụng Chat.

Đối với 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 Các 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 tính năng Xác thực ứng dụngsự phê duyệt của quản trị viê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 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 tính năng Xác thực ứng dụngsự phê duyệt của quản trị viên:
  • chat.app.spaces
Liệt kê các 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 dụng:
  • chat.bot
Tìm kiếm không gian Với tính năng Xác thực người dùng bằng đặc quyền quản trị viên:
  • chat.admin.spaces.readonly
Cập nhật không gian Với Xác thực người dùng:
  • chat.spaces
  • chat.import
Với tính năng Xác thực người dùng bằng đặc quyền quản trị viên:
  • chat.admin.spaces
Với tính năng Xác thực ứng dụngsự phê duyệt của quản trị viê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 quản trị viên:
  • chat.admin.delete
Với tính năng Xác thực ứng dụngsự phê duyệt của quản trị viê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 tính năng 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 tính năng Xác thực người dùng bằng đặc quyền quản trị viên:
  • chat.admin.memberships
Với tính năng Xác thực ứng dụngsự phê duyệt của quản trị viên:
  • chat.app.memberships
Mời người khác làm 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 quản trị viên:
  • chat.admin.memberships.readonly
Danh sách thành viên Với Xác thực người dùng:
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
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 quản trị viên:
  • 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 tính năng Xác thực người dùng bằng đặc quyền quản trị viên:
  • chat.admin.memberships
Với tính năng Xác thực ứng dụngsự phê duyệt của quản trị viên:
  • chat.app.memberships
Cập nhật thành viên Với Xác thực người dùng:
  • chat.memberships
  • chat.import
Với tính năng Xác thực người dùng bằng đặc quyền quản trị viên:
  • chat.admin.memberships
Với tính năng Xác thực ứng dụngsự phê duyệt của quản trị viên:
  • chat.app.memberships
Tin nhắn  
Tạo tin nhắn Với Xác thực người dùng:
  • chat.messages.create
  • chat.messages
  • chat.import
Với tính năng 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ê thông báo Với Xác thực người dùng:
  • chat.messages.readonly
  • chat.messages
  • chat.import
Chỉnh sửa tin nhắn Với Xác thực người dùng:
  • chat.messages
  • chat.import
Với tính năng 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 tính năng Xác thực ứng dụng:
  • chat.bot
Bày tỏ cảm xúc  
Tạo biểu cảm 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 biểu tượng 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á một lượt thể hiện cảm xúc Với 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 Xác thực người dùng:
  • chat.customemojis
Xoá biểu tượng cảm xúc tuỳ chỉnh Với 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 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 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 tệp đính kèm đa phương tiện lên 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 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
Nhận tệp đính kèm trong thư 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 của không gian của người dùng Với 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
Lấy trạng thái đã đọc của một chuỗi tin nhắn của người dùng Với Xác thực người dùng:
  • chat.users.readstate
  • chat.users.readstate.readonly
Chế độ cài đặt không gian của người dùng
Lấy 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
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 trong Space
Nhận sự kiện của không gian Với 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 các sự kiện về lượt thể hiện cảm xúc:
    • 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ê các sự kiện trong không gian Với Xác thực người dùng, bạn phải sử dụng một phạm vi cho mỗi kiểu sự kiện có trong yêu cầu:
  • Đối với các sự kiện về tin nhắn:
    • chat.messages
    • chat.messages.readonly
  • Đối với các sự kiện về lượt thể hiện cảm xúc:
    • 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

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

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

Trường hợp Không yêu cầu xác thự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 của ứng dụng Chat
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 của ứng dụng Chat
Đồng bộ, sử dụng giá trị trả về của lệnh gọi lại Apps Script
Gửi tin nhắn mới:
Với webhook đến