Trang này cung cấp thông tin tổng quan về cách sử dụng Google Chat API và tài liệu tham khảo của API này.
Google Chat API có cả giao diện gRPC và REST, cũng như các thư viện ứng dụng hỗ trợ cả hai giao diện này. Nếu các thư viện ứng dụng được cung cấp không đáp ứng nhu cầu của bạn, thì bạn có thể viết thư viện ứng dụng của riêng mình bằng giao diện gRPC hoặc REST.
Thư viện ứng dụng
Cách mà hầu hết nhà phát triển nên dùng để gọi Google Chat API là sử dụng Thư viện ứng dụng đám mây được chúng tôi hỗ trợ chính thức cho ngôn ngữ mà bạn muốn, chẳng hạn như Python, Java hoặc Node.js.
Nếu bạn đang viết mã bằng Google Apps Script, hãy sử dụng dịch vụ Chat nâng cao thay vì cài đặt một thư viện ứng dụng.
Tên loại, phương thức và 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ó một số điểm khác biệt:
- 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 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 chúng.
- REST được sắp xếp theo hệ thống 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 chữ snake case.
- Tên trường REST sử dụng kiểu lạc đà, mặc dù dịch vụ API sẽ chấp nhận cả kiểu lạc đà hoặc kiểu rắn.
- Tên trường thư viện ứng dụng sử dụng chữ cái đầu viết hoa, chữ hoa chữ thường hoặc chữ thường phân tách bằng dấu gạch dưới, 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ác 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 bộ đệm giao thức nổi tiếng.
Ngoài ra, khi gọi REST API, hành vi giá trị mặc định cho các 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 phiên bản API sau đây hiện có:
- v1: Ổ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ó trong 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.