Phát triển bằng Google Chat

Trang này cung cấp thông tin tổng quan về Google Chat API và các ứng dụng Google Chat.

Tổng quan về Google Chat API

Chat API bao gồm các dịch vụ gRPC hoặc tài nguyên và phương thức REST cấp quyền truy cập vào Chat, bao gồm cả không gian, thành viên không gian, tin nhắn, lượt thể hiện cảm xúc với tin nhắn, tệp đính kèm tin nhắn, sự kiện không gian và trạng thái đã đọc của người dùng.

Khái niệm

Phần sau đây xác định các dịch vụ, tài nguyên và phương thức cho Chat API:

Không gian

Không gian là nơi mọi người và ứng dụng có thể trò chuyện và chia sẻ tệp. Có một số loại không gian. Tin nhắn trực tiếp (DM) là cuộc trò chuyện 1:1 giữa hai người dùng hoặc giữa một người dùng và một ứng dụng Chat. Cuộc trò chuyện nhóm là cuộc trò chuyện giữa từ 3 người dùng trở lên và các ứng dụng Chat. Không gian có tên là những nơi ổn định để mọi người gửi tin nhắn, chia sẻ tệp và cộng tác.

Mã tham chiếu tài nguyên:

Để biết ví dụ về cách sử dụng, hãy xem:

Thành viên

Thành viên là những người dùng và ứng dụng Chat đã tham gia hoặc được mời tham gia một không gian.

Mã tham chiếu tài nguyên:

Để biết ví dụ về cách sử dụng, hãy xem:

Tin nhắn

Tin nhắn bao gồm văn bản và thông tin liên lạc bằng thẻ được đăng trong không gian. Tin nhắn có thể đính kèm tệp. Mọi người có thể thể hiện cảm xúc với tin nhắn bằng cách thêm biểu tượng cảm xúc vào tin nhắn.

Mã tham chiếu tài nguyên:

Để biết ví dụ về cách sử dụng, hãy xem:

Bày tỏ cảm xúc

Phản ứng là những biểu tượng cảm xúc mà mọi người dùng để thể hiện cảm xúc đối với một tin nhắn, chẳng hạn như 👍, 🚲 và 🌞.

Mã tham chiếu tài nguyên:

Để biết ví dụ về cách sử dụng, hãy xem:

Biểu tượng cảm xúc tuỳ chỉnh

Biểu tượng cảm xúc tuỳ chỉnh là biểu tượng cảm xúc tuỳ chỉnh được tạo và chia sẻ trong tổ chức trên Google Chat. Bạn có thể thêm biểu tượng cảm xúc tuỳ chỉnh vào nội dung của tin nhắn hoặc dùng để thể hiện cảm xúc đối với một tin nhắn.

Mã tham chiếu tài nguyên:

Để biết ví dụ về cách sử dụng, hãy xem:

Nội dung nghe nhìn và tệp đính kèm

Nội dung nghe nhìn là một tệp được tải lên Google Chat, chẳng hạn như hình ảnh, video và tài liệu.

Tài nguyên tham chiếu nội dung nghe nhìn (Không có trong RPC):

Tệp đính kèm là các phiên bản của nội dung nghe nhìn (tệp) được đính kèm vào tin nhắn.

Mã tham chiếu tài nguyên:

Để biết ví dụ về cách sử dụng, hãy xem:

Sự kiện trong Space

Sự kiện không gian thể hiện những thay đổi đối với một không gian hoặc các tài nguyên con của không gian đó, bao gồm cả thành viên, tin nhắn và lượt bày tỏ cảm xúc.

Mã tham chiếu tài nguyên:

Để biết ví dụ về cách sử dụng, hãy xem:

Trạng thái đọc của người dùng

Trạng thái đã đọc của người dùng là tài nguyên singleton thể hiện thông tin chi tiết về tin nhắn đã đọc gần đây nhất của một người dùng cụ thể trong một không gian hoặc chuỗi tin nhắn trên Google Chat.

Tham chiếu tài nguyên trạng thái đọc của không gian:

Tham chiếu tài nguyên trạng thái đọc luồng:

Để biết ví dụ về cách sử dụng, hãy xem:

Chế độ cài đặt thông báo về không gian của người dùng

Chế độ cài đặt thông báo về không gian của người dùng là các tài nguyên đơn lẻ đại diện cho chế độ cài đặt thông báo của một người dùng cụ thể trong một không gian trên Google Chat.

Mã tham chiếu tài nguyên:

Xác thực

Bạn cần phải xác thực để gọi Chat API. Mỗi phương thức Chat API đều yêu cầu xác thực người dùng (để thực hiện các thao tác hoặc truy cập vào dữ liệu thay mặt cho người dùng) hoặc xác thực ứng dụng (để thực hiện các thao tác hoặc truy cập vào dữ liệu dưới dạng một ứng dụng Chat). Một số phương thức hỗ trợ cả xác thực người dùng và xác thực ứng dụng.

Để tìm hiểu thêm về quy trình xác thực trong Chat, hãy xem bài viết Tổng quan về quy trình xác thực.

Thư viện ứng dụng

Cách mà hầu hết nhà phát triển nên dùng để gọi Google Chat API là sử dụng Thư viện ứng dụng đám mây được chúng tôi hỗ trợ chính thức cho ngôn ngữ mà bạn muốn, chẳng hạn như Python, Java hoặc Node.js.

Nếu bạn đang viết mã bằng Google Apps Script, hãy sử dụng dịch vụ Chat nâng cao thay vì cài đặt một thư viện ứng dụng.

Tạo ứng dụng Chat

API Chat cho phép bạn tạo các ứng dụng Google Chat đưa các dịch vụ và tài nguyên của bạn vào ngay Google Chat. Bạn có thể tạo ứng dụng trò chuyện để thực hiện bất kỳ thao tác nào sau đây:

  • Truy xuất thông tin dựa trên các cụm từ tìm kiếm có cấu trúc hoặc văn bản tự do do người dùng nhập.
  • Tạo báo cáo sự cố hoặc các hiện vật khác bằng thông tin do người dùng cung cấp.
  • Tăng cường khả năng cộng tác trong nhóm, chẳng hạn như cung cấp "bộ nhớ nhóm" hoặc lập lịch tài nguyên.

Bạn có thể thiết kế ứng dụng Chat bằng nhiều kiểu kiến trúc, bao gồm:

  • Ứng dụng có tính tương tác: Phản hồi hoạt động tương tác của người dùng, chẳng hạn như @đề cập hoặc lệnh dấu gạch chéo, đồng thời trình bày thông tin hoặc hướng dẫn người dùng thực hiện quy trình bằng thẻ và hộp thoại.
  • Ứng dụng dòng lệnh hoặc webhook: Gửi tin nhắn chủ động (chẳng hạn như báo thức hoặc thông báo) từ một hệ thống khác vào một không gian. Người dùng không thể tương tác trực tiếp với loại ứng dụng này.
  • Ứng dụng dựa trên sự kiện: Đăng ký và phản ứng với hoạt động trong một không gian Chat, chẳng hạn như khi có thành viên mới tham gia. Để phản hồi một sự kiện, ứng dụng có thể gửi một thông báo hoặc thực hiện một hành động khác.

Để biết thông tin chi tiết về cách thiết kế ứng dụng Chat, hãy xem phần Chọn cấu trúc ứng dụng Google Chat.

Bạn muốn xem Google Chat API hoạt động như thế nào?
Kênh Google Workspace Developers cung cấp các video về mẹo, thủ thuật và các tính năng mới nhất.