Phần này giải thích cách một ứng dụng Google Chat có thể gọi Chat API, cho phép các ứng dụng Chat thực hiện các thao tác như tạo không gian, thêm người vào không gian và đăng tin nhắn.
Xác thực
Bạn cần xác thực để gọi Chat API. Mỗi phương thức Chat API yêu cầu xác thực người dùng (để thay mặt người dùng thực hiện hành động hoặc truy cập dữ liệu) hoặc xác thực ứng dụng (để thực hiện hành động hoặc truy cập dữ liệu dưới dạng ứ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ề tính năng xác thực trong Chat, hãy xem bài viết Tổng quan về tính năng xác thực.
Thư viện ứng dụng
Hầu hết các nhà phát triển nên gọi API Google Chat bằng Thư viện ứng dụng đám mây được hỗ trợ chính thức của chúng tôi cho ngôn ngữ bạn muốn sử dụng, chẳng hạn như Python, Java hoặc Node.js.
Nếu bạn đang lập trình bằng Google Apps Script, hãy sử dụng Dịch vụ Chat nâng cao thay vì cài đặt thư viện ứng dụng.
Các khái niệm về API Google Chat
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 các không gian Chat, thành viên không gian, tin nhắn, lượt phản ứng 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ô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 khoảng trắng. 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 một người dùng và ứng dụng Chat. Cuộc trò chuyện nhóm là cuộc trò chuyện giữa ba người dùng trở lên và ứng dụng Chat. Không gian được đặt tên là những không gian ổn định, nơi mọi người gửi tin nhắn, chia sẻ tệp và cộng tác.
Tài liệu tham khảo về 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 vào một không gian.
Tài liệu tham khảo về 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 các thông tin liên lạc bằng văn bản và thẻ được đăng trong không gian. Tin nhắn có thể đính kèm tệp. Mọi người có thể phản ứng với tin nhắn bằng cách thêm biểu tượng cảm xúc vào tin nhắn đó.
Tài liệu tham khảo về 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à 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à 🌞.
Tài liệu tham khảo về 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 (Bản dùng thử cho nhà phát triển)
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 một tin nhắn hoặc dùng để bày tỏ cảm xúc về một tin nhắn.
Tài liệu tham khảo về tài nguyên:
- 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.
Tham chiếu tài nguyên đa phương tiện (Không có trong RPC):
Tệp đính kèm là các thực thể của nội dung đa phương tiện (tệp) được đính kèm vào thư.
Tài liệu tham khảo về tài nguyên:
Để biết ví dụ về cách sử dụng, hãy xem:
- Sự kiện trên Space
Sự kiện trong 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 phản ứng.
Tài liệu tham khảo về 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ụ thể trong không gian Google Chat hoặc luồng tin nhắn.
Tài nguyên tham chiếu trạng thái đọc không gian:
Tài nguyên tham chiếu trạng thái đọc luồng:
Để biết ví dụ về cách sử dụng, hãy xem:
- Cài đặt thông báo trong không gian người dùng (Bản dùng thử cho nhà phát triển)
Chế độ cài đặt thông báo của không gian người dùng là các tài nguyên singleton đại diện cho một chế độ cài đặt thông báo cụ thể của người dùng trong một không gian Google Chat.
Tài liệu tham khảo về tài nguyên:
Chủ đề có liên quan
- Khám phá các mẫu ứng dụng Google Chat để bắt đầu sử dụng Chat API.
Ngoài việc gọi Chat API, ứng dụng Chat cũng có thể:
- Nhận và phản hồi các sự kiện tương tác với ứng dụng Chat, chẳng hạn như tin nhắn được gửi đến ứng dụng Google Chat, theo thời gian thực.
- Đăng ký nhận sự kiện trên Google Chat để thực hiện hành động hoặc phản hồi khi một số hoạt động hoặc thay đổi nhất định xảy ra trong Chat, chẳng hạn như tin nhắn mới và thay đổi về tư cách thành viên.