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 của API này.
API Google Chat có cả giao diện gRPC và REST, cũng như thư viện ứng dụng hỗ trợ cả hai. Nếu các thư viện ứng dụng khách được cung cấp không đáp ứng nhu cầu của bạn, bạn có thể viết thư viện ứng dụng khách của riêng mình bằng cách sử dụng giao diện gRPC hoặc REST.
Thư viện ứng dụng
Hầu hết các nhà phát triển nên gọi API Google Chat bằng Thư viện ứng dụng đám mây được hỗ trợ chính thức của chúng tôi cho ngôn ngữ bạn muốn sử dụng, 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 sẽ có đôi chút khác biệt:
- Thư viện ứng dụng trên đám mây được sắp xếp theo các dịch vụ gRPC và phương thức của các dịch vụ đó. Thư viện ứng dụng Google API được sắp xếp dưới dạng các dịch vụ chứa các đối tượng hoặc lớp tương ứng với tài nguyên REST, đồng thời chứa các phương thức tương ứng.
- gRPC được sắp xếp theo các dịch vụ và phương thức của các dịch vụ đó.
- REST được sắp xếp theo hệ phân cấp tài nguyên và các phương thức của chúng.
- Tên trường gRPC sử dụng kiểu viết thường.
- Tên trường REST sử dụng kiểu viết hoa camel, mặc dù dịch vụ API sẽ chấp nhận kiểu viết hoa camel hoặc snake.
- Tên trường thư viện ứng dụng sử dụng kiểu viết hoa chữ cái đầu, kiểu viết hoa camel hoặc kiểu viết hoa snake, 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 được xác định bằng cách sử dụng vùng đệm giao thức. Cụ thể, dịch vụ này 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 bạn hiểu cơ bản về các loại vùng đệm giao thức phổ biến.
Ngoài ra, khi gọi API REST, hành vi giá trị mặc định cho vùng đệm giao thức có thể dẫn đến việc thiếu các trường trong phản hồi JSON. Các trường này được đặt thành giá trị mặc định nên không có trong phản hồi.
Phiên bản API
Có các phiên bản API sau:
- v1: Phiên bản ổn định.
Bản dùng thử cho nhà phát triển
Trong tài liệu, bạn có thể thấy các phương thức hoặc trường API chỉ có sẵn thông qua Chương trình Bản dùng thử cho nhà phát triển. Để kiểm thử, xem trước và đưa ra ý kiến 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 dùng thử cho nhà phát triển.