Tổng quan về API Google Chat

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:

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:

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:

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:

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: