Phần này giải thích cách một ứng dụng Google Chat có thể gọi điện API Chat để cho phép các ứng dụng trong Chat làm những việc như tạo không gian, thêm người vào không gian và đăng tin nhắn mà không phải nhận lời nhắc Sự kiện tương tác với ứng dụng Chat.
Xác thực
Để gọi API Chat một cách không đồng bộ, bạn cần xác thực. Một Phương thức API Chat yêu cầu xác thực người dùng (để thực hiện hành động hoặc truy cập thay mặt cho người dùng) hoặc xác thực ứng dụng (để thực hiện thao tác hoặc truy cập vào dữ liệu dưới dạng ứng dụng Chat). Hơi nhiều 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ề việc xác thực trong Chat, hãy xem Tổng quan về việc xác thực.
Tài nguyên và phương thức API
Các tài nguyên và phương thức REST cấp quyền truy cập không đồng bộ vào Chat không gian, thành viên trong không gian, tin nhắn, lượt bày tỏ cảm xúc tin nhắn và tệp đính kèm tin nhắn.
- 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ó là một số loại không gian. Tin nhắn trực tiếp (DM) là các cuộc trò chuyện 1:1 giữa hai người dùng hoặc một người dùng và một ứng dụng trong Chat. Bảng Các cuộc trò chuyện là các cuộc trò chuyện giữa ít nhất ba người dùng và Ứng dụng nhắn tin. Không gian được đặt tên là những địa điểm cố định mà mọi người gửi nhắn tin, chia sẻ tệp và cộng tác.
Chiến lược phát hành đĩa đơn Tài nguyên
spaces
biểu thị một không gian.Không gian hỗ trợ các phương thức sau:
- Tạo không gian, một nơi mà mọi người và các ứng dụng có thể trao đổi và chia sẻ tệp.
- Thiết lập không gian để tạo không gian, đồng thời thêm người và các ứng dụng trong Chat vào không gian đó .
- Mua không gian để xem thông tin chi tiết về một không gian.
- Liệt kê không gian để xem danh sách không gian được phân trang và có thể lọc.
- Cập nhật không gian để thay đổi thuộc tính của một không gian, chẳng hạn như tên hiển thị mà người dùng thấy được, mô tả và nguyên tắc.
- Xoá không gian khi không còn cần thiết nữa.
- Tìm tin nhắn trực tiếp (DM) để trả về tin nhắn trực tiếp giữa hai người dùng hoặc tin nhắn trực tiếp giữa một người dùng và nhóm gọi Ứng dụng nhắn tin.
- Thành viên
Hội viên là những người dùng và ứng dụng nhắn tin đã tham gia hoặc đã tham gia đã mời tham gia không gian.
Chiến lược phát hành đĩa đơn Tài nguyên
spaces.members
đại diện cho một thành viên.Thành phần hỗ trợ các phương thức sau:
- Tạo gói thành viên để thêm người dùng hoặc ứng dụng vào một không gian.
- Mua gói thành viên để xem chi tiết về một gói thành viên.
- Danh sách thành viên để xem danh sách thành viên có thể lọc và phân trang trong một không gian.
- Cập nhật gói thành viên để thay đổi các thuộc tính về một thành viên, chẳng hạn như thay đổi thành viên trong không gian thành người quản lý không gian hoặc thay đổi người quản lý không gian thành thành viên của không gian.
- Xoá gói thành viên để xoá người dùng hoặc ứng dụng khỏi không gian.
- Tin nhắn
Thông báo bao gồm văn bản và thẻ nội dung trao đổi được đăng trong không gian. Tin nhắn có thể có tệp đính kèm. 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.
Chiến lược phát hành đĩa đơn Tài nguyên
spaces.messages
biểu thị một thông điệp.Thông báo hỗ trợ các phương thức sau:
- Tạo thông báo để đăng văn bản hoặc thẻ. Bạn cũng có thể bắt đầu hoặc trả lời một chuỗi tin nhắn.
- Nhận tin nhắn để xem thông tin chi tiết về một tin nhắn, chẳng hạn như thời điểm tin nhắn được gửi hoặc nội dung tin nhắn.
- Liệt kê tin nhắn để xem danh sách tin nhắn có thể lọc và phân trang trong một không gian.
- Cập nhật tin nhắn để thay đổi các thuộc tính của tin nhắn, chẳng hạn như nội dung tin nhắn. Bạn cũng có thể nối thêm văn bản sang thông báo thẻ, hoặc một thẻ đến tin nhắn văn bản.
- Xoá thư khi không còn cần thiết nữa.
- Bày tỏ cảm xúc
Thể hiện cảm xúc chính là biểu tượng cảm xúc mà mọi người dùng để thể hiện cảm xúc với một tin nhắn, chẳng hạn như 👍, 🚲 và 🌞.
Chiến lược phát hành đĩa đơn Tài nguyên
spaces.messages.reactions
biểu thị một phản ứng.Bạn có thể dùng tính năng bày tỏ cảm xúc cho những phương thức sau:
- Tạo phản ứng để thêm biểu tượng cảm xúc vào thư.
- Liệt kê các biểu tượng cảm xúc để xem danh sách phản ứng với một tin nhắn được phân trang và có thể lọc.
- Xoá một lượt thể hiện cảm xúc để xoá một biểu tượng cảm xúc khỏi thư.
- Nội dung nghe nhìn và tệp đính kèm
Nội dung nghe nhìn thể hiện 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.
Chiến lược phát hành đĩa đơn Tài nguyên
media
biểu thị nội dung nghe nhìn được đính kèm vào thư.Tệp đính kèm là các bản sao nội dung nghe nhìn (tệp) được đính kèm vào thư.
Chiến lược phát hành đĩa đơn Tài nguyên
spaces.messages.attachments
đại diện cho một tệp đính kèm. Tệp đính kèm bao gồm phương tiện và siêu dữ liệu được đính kèm vào thư.Nội dung nghe nhìn và tệp đính kèm hỗ trợ những phương thức sau:
- Tải nội dung nghe nhìn lên dưới dạng tệp đính kèm tải nội dung nghe nhìn lên Google Chat rồi đính kèm vào tin nhắn.
- Tải nội dung nghe nhìn xuống dưới dạng tệp đính kèm để tải nội dung nghe nhìn từ Google Chat xuống dưới dạng tệp nhị phân.
- Tải tệp đính kèm để truy xuất siêu dữ liệu về tệp đính kèm tin nhắn.
- Sự kiện của không gian
Sự kiện trong không gian thể hiện các thay đổi đối với một không gian hoặc tài nguyên con, chẳng hạn như thành viên, thông báo và lượt thể hiện cảm xúc.
Tài nguyên
spaces.spaceEvent
đại diện cho một sự kiện trong không gian.Sự kiện trong không gian hỗ trợ các phương thức sau:
- Nhận sự kiện trên không gian để trả về thông tin chi tiết về một sự kiện đã xảy ra trong một không gian.
- Liệt kê các sự kiện trong không gian để xem danh sách các sự kiện đã xảy ra trong một không gian.
- 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 thể hiện thông tin chi tiết về một tin nhắn được đọc gần đây nhất của người dùng mà bạn chỉ định trong phòng Google Chat hoặc tin nhắn chuỗi.
Tài nguyên
users.spaces
thể hiện trạng thái đọc của người dùng trong một không gian.Tài nguyên
users.spaces.threads
thể hiện trạng thái đã đọc của người dùng trong một chuỗi thư.Trạng thái đọc của người dùng hỗ trợ các phương thức sau:
- Nhận trạng thái đọc không gian để trả về thông tin chi tiết về trạng thái đọc của người dùng trong một không gian.
- Cập nhật trạng thái đọc không gian để cập nhật trạng thái đã đọc của người dùng trong một không gian.
- Nhận trạng thái đã đọc chuỗi để trả về thông tin chi tiết về trạng thái đọc của người dùng trong một chuỗi.