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 đ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:

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:

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:

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:

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: