Trang này cung cấp thông tin tổng quan về cách sử dụng API Google Chat và tài liệu tham khảo tài liệu.
Google Chat API có cả gRPC và giao diện REST và thư viện ứng dụng hỗ trợ cả hai. Không bắt buộc, nếu các thư viện ứng dụng đã cung cấp không đáp ứng nhu cầu của bạn, bạn có thể tự viết thư viện ứng dụng sử dụng giao diện gRPC hoặc REST.
Thư viện ứng dụng
Đây là cách mà hầu hết các nhà phát triển nên dùng để gọi API Google Chat là với Thư viện ứng dụng đám mây cho ngôn ngữ bạn ưu tiên, chẳng hạn như Python, Java hoặc Node.js.
Nếu bạn đang lập trình bằng Google Apps Script, hãy sử dụng Dịch vụ Chat nâng cao thay vì cài đặt thư viện ứng dụng.
Loại, phương thức và tên trường
Tuỳ thuộc vào việc bạn đang sử dụng thư viện ứng dụng, gRPC hay REST, loại phương thức và tên trường cho API Google Chat khác nhau đôi chút:
- Các thư viện ứng dụng đám mây được sắp xếp theo các dịch vụ gRPC và phương thức tương ứng. Thư viện ứng dụng API của Google được sắp xếp dưới dạng dịch vụ chứa các đối tượng hoặc các lớp tương ứng với tài nguyên REST, cũng chứa các tài nguyên tương ứng .
- gRPC được sắp xếp theo các dịch vụ và phương thức của chúng.
- REST được sắp xếp theo hệ phân cấp tài nguyên và phương thức tương ứng.
- Tên trường gRPC sử dụng kiểu viết con rắn.
- Tên trường REST sử dụng kiểu viết lạc đà, mặc dù dịch vụ API sẽ chấp nhận một trong hai kiểu viết lạc đà hoặc kiểu viết mã kiểu con rắn.
- Tên trường của thư viện ứng dụng sử dụng cả kiểu viết hoa tựa đề, kiểu viết lạc đà hoặc kiểu viết hoa con rắn, tuỳ thuộc vào tên nào phù hợp với ngôn ngữ đó.
Vùng đệm giao thức
Cho dù bạn đang sử dụng thư viện ứng dụng, REST hay gRPC, dịch vụ cơ bản đều là xác định bằng vùng đệm giao thức. Đặc biệt, dịch vụ sử dụng proto3.
Khi gọi API, một số trường yêu cầu hoặc phản hồi có thể yêu cầu lớp cơ bản hiểu về các loại phổ biến của bộ đệm giao thức.
Ngoài ra, khi gọi API REST, hành vi giá trị mặc định cho giao thức vùng đệm có thể dẫn đến thiếu trường trong phản hồi JSON. Những trường này được đặt thành giá trị mặc định, do đó chúng không được đưa vào phản hồi.
Phiên bản API
Có các phiên bản API sau đây:
- v1: Ổn định.
Bản dùng thử cho nhà phát triển
Trong tài liệu này, bạn có thể thấy các trường hoặc phương thức API chỉ có sẵn thông qua Chương trình dùng thử cho nhà phát triển. Thử nghiệm, xem trước và đưa ra đề xuất phản hồi về các tính năng xem trước mới nhất, hãy tham gia Chương trình Bản dùng thử cho nhà phát triển.