Google Chat API

API Google Chat cho phép bạn tạo ứng dụng trong Chat để tích hợp các dịch vụ của bạn với Google Chat và quản lý tài nguyên trong Chat, chẳng hạn như không gian, thành viên và tin nhắn.

Dịch vụ: chat.googleapis.com

Để gọi dịch vụ này, bạn nên dùng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng của bạn cần dùng các thư viện riêng để gọi dịch vụ này, hãy sử dụng thông tin sau khi bạn thực hiện các yêu cầu API.

Tài liệu khám phá

Tài liệu khám phá là một quy cách có thể đọc được bằng máy để mô tả và sử dụng API REST. Quy cách này được dùng để tạo các thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác có tương tác với API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp tài liệu khám phá sau:

Điểm cuối dịch vụ

Điểm cuối dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của một dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối dịch vụ. Dịch vụ này có điểm cuối dịch vụ sau và tất cả URI bên dưới đều liên quan đến điểm cuối dịch vụ này:

  • https://chat.googleapis.com

Tài nguyên REST: v1.customEmojis

Phương thức
create POST /v1/customEmojis
Tạo biểu tượng cảm xúc tuỳ chỉnh.
delete DELETE /v1/{name=customEmojis/*}
Xoá biểu tượng cảm xúc tuỳ chỉnh.
get GET /v1/{name=customEmojis/*}
Trả về thông tin chi tiết về một biểu tượng cảm xúc tuỳ chỉnh.
list GET /v1/customEmojis
Liệt kê các biểu tượng cảm xúc tuỳ chỉnh mà người dùng đã xác thực có thể nhìn thấy.

Tài nguyên REST: v1.media

Phương thức
download GET /v1/media/{resourceName=**}
Tải nội dung nghe nhìn xuống.
upload POST /upload/v1/{parent=spaces/*}/attachments:upload
Tải tệp đính kèm lên.

Tài nguyên REST: v1.spaces

Phương thức
completeImport POST /v1/{name=spaces/*}:completeImport
Hoàn tất quy trình nhập cho không gian được chỉ định và cho phép người dùng nhìn thấy không gian đó.
create POST /v1/spaces
Tạo không gian.
delete DELETE /v1/{name=spaces/*}
Xoá một không gian có tên.
findDirectMessage GET /v1/spaces:findDirectMessage
Trả về tin nhắn trực tiếp hiện có với người dùng được chỉ định.
findGroupChats GET /v1/spaces:findGroupChats
Trả về tất cả không gian có spaceType == GROUP_CHAT, có thành viên là người dùng chứa chính xác người dùng đang gọi và người dùng được chỉ định trong FindGroupChatsRequest.users.
get GET /v1/{name=spaces/*}
Trả về thông tin chi tiết về một không gian.
list GET /v1/spaces
Liệt kê các không gian mà người gọi là thành viên.
patch PATCH /v1/{space.name=spaces/*}
Cập nhật không gian.
search GET /v1/spaces:search
Trả về danh sách không gian trong một tổ chức trên Google Workspace.
setup POST /v1/spaces:setup
Tạo không gian và thêm người dùng được chỉ định vào không gian đó.

Tài nguyên REST: v1.spaces.members

Phương thức
create POST /v1/{parent=spaces/*}/members
Tạo tư cách thành viên cho ứng dụng Chat đang gọi, một người dùng hoặc một nhóm trên Google Groups.
delete DELETE /v1/{name=spaces/*/members/*}
Xoá một gói thành viên.
get GET /v1/{name=spaces/*/members/*}
Trả về thông tin chi tiết về một gói thành viên.
list GET /v1/{parent=spaces/*}/members
Liệt kê các thành viên trong một không gian.
patch PATCH /v1/{membership.name=spaces/*/members/*}
Cập nhật gói thành viên.

Tài nguyên REST: v1.spaces.messagePins

Phương thức
create POST /v1/{parent=spaces/*}/messagePins
Tạo một ghim tin nhắn.
delete DELETE /v1/{name=spaces/*/messagePins/*}
Xoá một tin nhắn đã ghim.
list GET /v1/{parent=spaces/*}/messagePins
Liệt kê các tin nhắn được ghim trong một không gian.

Tài nguyên REST: v1.spaces.messages

Phương thức
create POST /v1/{parent=spaces/*}/messages
Tạo tin nhắn trong không gian Google Chat.
delete DELETE /v1/{name=spaces/*/messages/*}
Xoá tin nhắn.
get GET /v1/{name=spaces/*/messages/*}
Trả về thông tin chi tiết về một tin nhắn.
list GET /v1/{parent=spaces/*}/messages
Liệt kê các tin nhắn trong một không gian mà người gọi là thành viên, bao gồm cả tin nhắn của các thành viên và không gian bị chặn.
patch PATCH /v1/{message.name=spaces/*/messages/*}
Cập nhật tin nhắn.
replaceCards POST /v1/{name=spaces/*/messages/*}:replaceCards
Thay thế các thẻ có trong một tin nhắn.
search POST /v1/{parent=spaces/*}/messages:search
Tìm kiếm tin nhắn trong Google Chat mà người dùng gọi có quyền truy cập.
update PUT /v1/{message.name=spaces/*/messages/*}
Cập nhật tin nhắn.

Tài nguyên REST: v1.spaces.messages.attachments

Phương thức
get GET /v1/{name=spaces/*/messages/*/attachments/*}
Lấy siêu dữ liệu của tệp đính kèm trong thư.

Tài nguyên REST: v1.spaces.messages.reactions

Phương thức
create POST /v1/{parent=spaces/*/messages/*}/reactions
Tạo một biểu tượng cảm xúc và thêm biểu tượng đó vào tin nhắn.
delete DELETE /v1/{name=spaces/*/messages/*/reactions/*}
Xoá một phản ứng đối với tin nhắn.
list GET /v1/{parent=spaces/*/messages/*}/reactions
Liệt kê các biểu tượng cảm xúc cho một tin nhắn.

Tài nguyên REST: v1.spaces.spaceEvents

Phương thức
get GET /v1/{name=spaces/*/spaceEvents/*}
Trả về một sự kiện từ một không gian trên Google Chat.
list GET /v1/{parent=spaces/*}/spaceEvents
Liệt kê các sự kiện trong một không gian trên Google Chat.

Tài nguyên REST: v1.users.availability

Phương thức
get GET /v1/{name=users/*/availability}
Trả về thông tin về trạng thái rảnh/bận của người dùng trong Google Chat.
markAsActive POST /v1/{name=users/*/availability}:markAsActive
Đánh dấu người dùng là ACTIVE trong Google Chat.
markAsAway POST /v1/{name=users/*/availability}:markAsAway
Đánh dấu người dùng là AWAY trong Google Chat.
markAsDoNotDisturb POST /v1/{name=users/*/availability}:markAsDoNotDisturb
Đánh dấu người dùng là DO_NOT_DISTURB trong Google Chat.
patch PATCH /v1/{availability.name=users/*/availability}
Cập nhật thông tin về tình trạng rảnh/bận cho người dùng.

Tài nguyên REST: v1.users.sections

Phương thức
create POST /v1/{parent=users/*}/sections
Tạo một mục trong Google Chat.
delete DELETE /v1/{name=users/*/sections/*}
Xoá một phần của loại CUSTOM_SECTION.
list GET /v1/{parent=users/*}/sections
Liệt kê các mục có sẵn cho người dùng Chat.
patch PATCH /v1/{section.name=users/*/sections/*}
Cập nhật một mục.
position POST /v1/{name=users/*/sections/*}:position
Thay đổi thứ tự sắp xếp của một phần.

Tài nguyên REST: v1.users.sections.items

Phương thức
list GET /v1/{parent=users/*/sections/*}/items
Liệt kê các mục trong một phần.
move POST /v1/{name=users/*/sections/*/items/*}:move
Di chuyển một mục từ phần này sang phần khác.

Tài nguyên REST: v1.users.spaces

Phương thức
getSpaceReadState GET /v1/{name=users/*/spaces/*/spaceReadState}
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, dùng để xác định tin nhắn đã đọc và chưa đọc.
updateSpaceReadState PATCH /v1/{spaceReadState.name=users/*/spaces/*/spaceReadState}
Cập nhật trạng thái đọc của người dùng trong một không gian, dùng để xác định tin nhắn đã đọc và chưa đọc.

Tài nguyên REST: v1.users.spaces.spaceNotificationSetting

Phương thức
get GET /v1/{name=users/*/spaces/*/spaceNotificationSetting}
Lấy chế độ cài đặt thông báo về không gian.
patch PATCH /v1/{spaceNotificationSetting.name=users/*/spaces/*/spaceNotificationSetting}
Cập nhật chế độ cài đặt thông báo của không gian.

Tài nguyên REST: v1.users.spaces.threads

Phương thức
getThreadReadState GET /v1/{name=users/*/spaces/*/threads/*/threadReadState}
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 tin nhắn, dùng để xác định tin nhắn đã đọc và chưa đọc.