Phần này giải thích cách một ứng dụng Google Chat có thể gọi API Chat. API này 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 cần nhận 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ỗ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 hành động 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 hành động hoặc truy cập vào dữ liệu như một ứng dụng Chat). Một số phương thức hỗ trợ cả việ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 bài viết Tổng quan về việc xác thực.
Tài nguyên và phương thức API
Tài nguyên và phương thức REST cấp quyền truy cập không đồng bộ vào các không gian trong Chat, thành viên trong không gian, tin nhắn, lượt thể hiện 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ó 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 2 người dùng hoặc một người dùng và một ứng dụng trong Chat. Cuộc 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 tên là những địa điểm cố định nơi mọi người gửi tin nhắn, chia sẻ tệp và cộng tác.
Tài nguyên
spaces
đại diện cho một không gian.Không gian hỗ trợ các phương thức sau:
- Tạo không gian, nơi mọi người và các ứng dụng có thể trò chuyện và chia sẻ tệp.
- Thiết lập một không gian để tạo không gian và thêm người dùng và các ứng dụng trong Chat vào không gian đó.
- Tìm không gian để xem thông tin chi tiết về không gian đó.
- Liệt kê không gian để xem danh sách không gian có thể phân trang và có thể lọc.
- Cập nhật không gian để thay đổi các thuộc tính về một không gian, chẳng hạn như tên hiển thị mà người dùng nhìn thấy, nội dung mô tả và nguyên tắc của không gian đó.
- Xoá không gian khi không còn cần đến.
- 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à các ứng dụng trò chuyện đang gọi.
- 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 không gian.
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 không gian.
- Đăng ký gói thành viên để xem thông tin chi tiết về gói đó.
- Liệt kê 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 thành viên để thay đổi các thuộc tính liên quan đến 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
Tin nhắn bao gồm nội dung giao tiếp qua văn bản và thẻ đượ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.
Tài nguyên
spaces.messages
đại diện cho một thông báo.Thông báo hỗ trợ các phương thức sau:
- Tạo thông báo để đăng thông báo 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 để biết thông tin chi tiết về 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ể phân trang và có thể lọc trong một không gian.
- Cập nhật thông báo để thay đổi các thuộc tính của thông báo, chẳng hạn như nội dung tin nhắn. Bạn cũng có thể thêm văn bản vào thông báo thẻ hoặc thẻ vào tin nhắn văn bản.
- Xoá thư khi không còn cần đến.
- Bày tỏ cảm xúc
Biểu tượng thể hiện cảm xúc đại diện cho những biểu tượng cảm xúc mà mọi người dùng để thể hiện cảm xúc với tin nhắn, chẳng hạn như 👍, 🚲 và 🌞.
Tài nguyên
spaces.messages.reactions
đại diện cho 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 một phản ứng để thêm biểu tượng cảm xúc vào tin nhắn.
- Liệt kê các phản ứng để xem danh sách các phản ứng được phân trang, có thể lọc được với một tin nhắn.
- Xoá biểu tượng cảm xúc để xoá một biểu tượng cảm xúc khỏi tin nhắn.
- Nội dung nghe nhìn và tệp đính kèm
Nội dung nghe nhìn biểu thị 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
media
đại diện cho nội dung nghe nhìn đính kèm vào thông báo.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ư.
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 nội dung nghe nhìn và siêu dữ liệu liên quan được đính kèm với tin nhắn.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 xuống từ Google Chat 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 của không gian đó, bao gồm các thành viên, tin nhắn 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 không gian.Sự kiện trong không gian hỗ trợ các phương thức sau:
- Lấy một sự kiện trong 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 của không gian để nhận 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 biểu thị thông tin chi tiết về tin nhắn đọc gần đây nhất của người dùng được chỉ định trong phòng Google Chat hoặc một chuỗi tin nhắn.
Tài nguyên
users.spaces
đại diện cho trạng thái đọc của người dùng trong một không gian.Tài nguyên
users.spaces.threads
đại diện cho trạng thái đọc của người dùng trong một chuỗi thông báo.Trạng thái đọc của người dùng hỗ trợ các phương thức sau:
- Lấy 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 luồng để trả về thông tin chi tiết về trạng thái đã đọc của người dùng trong một luồng.