Thư viện ứng dụng giúp tối ưu hoá trải nghiệm của nhà phát triển khi gọi API Google Chat bằng cách giảm thiểu mã nguyên mẫu mà bạn phải viết. Hướng dẫn này giới thiệu về các thư viện ứng dụng và giải thích cách cài đặt các thư viện đó.
API Chat có giao diện gRPC và REST cũng như thư viện ứng dụng hỗ trợ cả hai. Thư viện ứng dụng trên đám mây hỗ trợ giao diện gRPC và REST, Thư viện ứng dụng API của Google chỉ hỗ trợ giao diện REST, nhưng bạn có thể sử dụng cả hai thư viện ứng dụng trong cùng một dự án. 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.
Để tìm hiểu thêm về các loại thư viện ứng dụng mà Google hỗ trợ, hãy xem phần Giải thích về thư viện ứng dụng.
Cài đặt Thư viện ứng dụng Cloud (nên dùng)
Thư viện ứng dụng đám mây là các thư viện ứng dụng mới nhất và được đề xuất để gọi Chat API. Thư viện ứng dụng đám mây hỗ trợ cả giao diện gRPC và giao diện REST.
Chat API cung cấp Thư viện ứng dụng đám mây cho các ngôn ngữ sau. Chọn ngôn ngữ bạn muốn sử dụng:
Node.js
Cách cài đặt thư viện ứng dụng:
npm install @google-apps/chat
Tìm hiểu thêm:
Python
Cách cài đặt thư viện ứng dụng:
python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
Tìm hiểu thêm:
Java
Chọn môi trường xây dựng của bạn trong các thẻ sau. Dù bạn sử dụng phiên bản nào, hãy nhớ cập nhật phiên bản lên bản phát hành mới nhất có trên GitHub.
Maven có BOM
Nếu bạn đang sử dụng Maven với BOM, hãy thêm nội dung này vào tệp pom.xml
:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>26.42.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
</dependency>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.10.0</version>
</dependency>
Maven không có BOM
Nếu bạn đang sử dụng Maven mà không có BOM, hãy thêm phần phụ thuộc này vào:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.9.0</version>
</dependency>
Gradle
Nếu bạn đang sử dụng Gradle mà không có BOM, hãy thêm phần phụ thuộc này vào:
implementation 'com.google.cloud:google-cloud-chat:0.10.0'
SBT
Nếu bạn đang sử dụng SBT, hãy thêm phần phụ thuộc này vào:
libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"
Tìm hiểu thêm:
Go
Nhập các gói Go cho các dịch vụ của Google Cloud.
import "cloud.google.com/go"
Cách cài đặt gói trên hệ thống:
- Thay đổi thành thư mục dự án:
cd /my/cloud/project
. - Tải gói bạn muốn sử dụng:
go get cloud.google.com/go/chat
Tìm hiểu thêm:
Ruby
Cách cài đặt thư viện ứng dụng:
gem install google-apps-chat
Tìm hiểu thêm:
PHP
Cách cài đặt thư viện ứng dụng:
- Nếu cần, hãy cài đặt trình quản lý phần phụ thuộc Composer.
- Trên giao diện dòng lệnh, hãy chạy:
composer require google/apps-chat
Tìm hiểu thêm:
.NET
Cách cài đặt thư viện ứng dụng:
Cài đặt gói Google.Apps.Chat.V1
từ NuGet. Thêm gói này vào dự án theo cách thông thường (ví dụ: nhấp chuột phải vào dự án trong Visual Studio rồi chọn "Manage NuGet Packages..." (Quản lý gói NuGet...)). Hãy nhớ bật các gói phát hành trước (ví dụ: trong giao diện người dùng Visual Studio NuGet, hãy đánh dấu vào hộp "Bao gồm bản phát hành trước").
Để cài đặt gói NuGet, hãy truy cập vào Google.Apis tại NuGet.org.
Tìm hiểu thêm:
Cài đặt Thư viện ứng dụng API của Google
Thay vì Thư viện ứng dụng trên đám mây, Thư viện ứng dụng API của Google cung cấp quyền truy cập có lập trình vào Chat API bằng các tài nguyên và phương thức REST. Bạn nên sử dụng Thư viện ứng dụng API của Google nếu sử dụng một ngôn ngữ không có Thư viện ứng dụng trên đám mây hoặc nếu bạn đang mở rộng một dự án đã sử dụng các thư viện đó.
Chat API cung cấp Thư viện ứng dụng API của Google cho các ngôn ngữ sau. Chọn ngôn ngữ bạn muốn sử dụng:
Go
Tải thư viện ứng dụng Google Chat API mới nhất cho Go (alpha). Đọc hướng dẫn dành cho nhà phát triển của thư viện ứng dụng.
Java
Trang này cung cấp thông tin về cách bắt đầu sử dụng API Google Chat bằng Thư viện ứng dụng Java cho API của Google. Để biết thêm thông tin, hãy xem tài liệu sau đây:
Thêm thư viện ứng dụng vào dự án
Chọn môi trường tạo bản dựng của bạn (Maven hoặc Gradle) qua các thẻ sau đây:
Thêm đoạn mã sau vào tệp pom.xml
của bạn:
Thêm đoạn mã sau vào tệp build.gradle
của bạn:
JavaScript
Đọc hướng dẫn dành cho nhà phát triển của thư viện ứng dụng.
.NET
Trang này cung cấp thông tin về cách bắt đầu sử dụng API Google Chat bằng cách sử dụng Thư viện ứng dụng API của Google cho .NET. Để biết thêm thông tin, hãy xem tài liệu sau:
Tải thư viện xuống
Cài đặt gói NuGet: Google.Apis.
Node.js
Tải thư viện ứng dụng Google Chat API mới nhất cho Node.js. Đọc hướng dẫn dành cho nhà phát triển của thư viện ứng dụng.
Obj-C
Tải thư viện ứng dụng Google Chat API mới nhất cho Objective-C. Đọc hướng dẫn dành cho nhà phát triển của thư viện ứng dụng.
PHP
Tải thư viện ứng dụng Google Chat API mới nhất cho PHP. Đọc hướng dẫn dành cho nhà phát triển của thư viện ứng dụng.
Python
Trang này cung cấp thông tin về cách bắt đầu sử dụng API Google Chat bằng Thư viện ứng dụng API của Google cho Python. Để biết thêm thông tin, hãy xem tài liệu sau đây:
Yêu cầu hệ thống
- Hệ điều hành:
- Linux
- macOS X
- Windows
- Python 2.7 hoặc 3.4 trở lên
Cài đặt thư viện ứng dụng
Bạn có thể sử dụng trình quản lý gói để cài đặt hoặc tải thư viện ứng dụng Python xuống rồi cài đặt theo cách thủ công:
Cài đặt qua trình quản lý
Dùng pip hoặc setuptools để quản lý hoạt động cài đặt của bạn. Có thể trước tiên bạn phải chạy sudo
.
- pip (ưu tiên):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
Cài đặt theo cách thủ công
- Tải thư viện ứng dụng mới nhất cho Python.
- Giải nén mã.
- Cài đặt:
python setup.py install
App Engine
Do các thư viện ứng dụng Python không cài đặt được trong môi trường chạy App Engine Python, nên bạn phải sao chép các thư viện đó vào ứng dụng của mình y như thư viện của bên thứ ba.
Ruby
Trang này cung cấp thông tin về cách bắt đầu sử dụng API Google Chat bằng Thư viện ứng dụng API của Google cho Ruby. Để biết thêm thông tin, hãy xem tài liệu sau đây:
Cài đặt gem google-api-client
Tuỳ thuộc vào hệ thống của bạn, có thể bạn phải thêm sudo
vào phần đầu các lệnh này.
Nếu bạn chưa từng cài đặt Thư viện ứng dụng API của Google cho Ruby, hãy cài đặt bằng cách sử dụng RubyGems
:
gem install google-api-client
Nếu bạn từng cài đặt gem này, hãy cập nhật lên phiên bản mới nhất:
gem update -y google-api-client
Bắt đầu sử dụng Thư viện ứng dụng API của Google cho Ruby
Để tìm hiểu cách đưa ra yêu cầu đầu tiên, hãy xem phần Hướng dẫn bắt đầu sử dụng.
Apps Script và 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.
Xác thực
Bạn cần xác thực để gọi Chat API. Mỗi phương thức Chat API yêu cầu xác thực người dùng (để thay mặt người dùng thực hiện hành động hoặc truy cập dữ liệu) hoặc xác thực ứng dụng (để thực hiện hành động hoặc truy cập dữ liệu dưới dạng ứng dụng Chat). Một số phương thức 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ề tính năng xác thực trong Chat, hãy xem bài viết Tổng quan về tính năng xác thực.