Trang này cung cấp thông tin tổng quan về API Google Chat và các ứng dụng trong Google Chat.
Tổng quan về API Google Chat
API Chat 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 trong 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 trong 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 API Chat:
- 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 trong Chat. Trò chuyện nhóm là cuộc trò chuyện giữa 3 người dùng trở lên và các ứng dụng trong Chat. Không gian có tên là những nơi cố đị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 trong 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ể có tệp đính kèm. Mọi người có thể bày tỏ 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:
- Phản ứng
Phản ứng đại diện cho biểu tượng cảm xúc mà mọi người dùng để phản ứng 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 đại diện cho biểu tượng cảm xúc tuỳ chỉnh được tạo và chia sẻ trong tổ chức trong Google Chat. Bạn có thể đưa 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 để phản ứng với tin nhắn.
Mã tham chiếu tài nguyên:
Để biết ví dụ về cách sử dụng, hãy xem:
- Mục
Mục là cách để người dùng nhóm các cuộc trò chuyện và tuỳ chỉnh danh sách không gian hiển thị trong bảng điều hướng Google Chat. Có các mục hệ thống được xác định trước và các mục tuỳ chỉnh do người dùng xác định.
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 đại diện cho 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.
Thông tin tham khảo về tài nguyên nội dung nghe nhìn (Không có trong RPC):
Tệp đính kèm là các thực thể 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 không gian
Sự kiện trong không gian đại diện cho các thay đổi đối với một không gian hoặc tài nguyên con của không gian đó, bao gồm cả thành viên, tin nhắn và phản ứng.
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à các tài nguyên singleton đại diện cho 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 chỉ định trong phòng Chat của Google Chat hoặc chuỗi tin nhắn.
Thông tin tham khảo về tài nguyên trạng thái đã đọc của không gian:
Thông tin tham khảo về tài nguyên trạng thái đã đọc của chuỗi tin nhắn:
Để 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ề phòng Chat của người dùng là các tài nguyên singleton đại diện cho chế độ cài đặt thông báo của người dùng được chỉ định trong một phòng Chat trên Google Chat.
Mã tham chiếu tài nguyên:
Xác thực
Bạn phải xác thực để gọi API Chat. Mỗi phương thức API Chat đề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 ứng dụng trong 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 Tổng quan về quy trình xác thực.
Thư viện ứng dụng
Cách được đề xuất để hầu hết nhà phát triển gọi API Google Chat là sử dụng Thư viện ứng dụng đám mây được hỗ trợ chính thức cho ngôn ngữ bạn ưu tiên, chẳng hạn như Python, Java hoặc Node.js.
Tạo ứng dụng trong 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 Google Chat. Bạn có thể tạo ứng dụng trong Chat để 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 truy vấn 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 cấu phần phần mềm 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ên lịch tài nguyên.
Bạn có thể thiết kế ứng dụng trong Chat bằng nhiều kiểu kiến trúc khác nhau, bao gồm:
- Ứng dụng tương tác: Phản hồi lượt tương tác của người dùng, chẳng hạn như lượt đề cập bằng @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 làm việc 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ư cảnh báo 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 phòng Chat, chẳng hạn như một thành viên mới tham gia. Để phản hồi một sự kiện, ứng dụng có thể gửi tin nhắn 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 trong Chat, hãy xem bài viết Chọn kiến trúc ứng dụng Google Chat.
Chủ đề có liên quan
- Khám phá các mẫu ứng dụng Google Chat.
- Tạo ứng dụng Google Chat tương tác.
- Chọn kiến trúc ứng dụng Google Chat.
 |
Bạn muốn xem API Google Chat hoạt động trong thực tế?
Kênh Nhà phát triển Google Workspace cung cấp các video về mẹo,
thủ thuật và các tính năng mới nhất.
|