Thư viện ứng dụng API Google Chat

Thư viện ứng dụng tối ưu hoá trải nghiệm của nhà phát triển để gọi API Google Chat bằng cách giảm bớt mã nguyên mẫu bạn phải viết. Hướng dẫn này giới thiệu các thư viện ứng dụng và giải thích cách cài đặt chúng.

API Chat có gRPC và REST giao diện và các thư viện ứng dụng hỗ trợ cả hai. Thư viện ứng dụng đám mây hỗ trợ gRPC và REST giao diện, 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. 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.

Để tìm hiểu thêm về các loại thư viện ứng dụng mà Google hỗ trợ, hãy xem Giải thích về thư viện ứng dụng.

Cài đặt Thư viện ứng dụng đám mây (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 API Chat. Thư viện ứng dụng đám mây hỗ trợ cả gRPC và REST giao diện.

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ữ mà bạn muốn 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:

Java

Chọn môi trường tạo bản dựng trong các thẻ sau. Bất kể bạn hãy nhớ cập nhật lên bản phát hành mới nhất có sẵn trên GitHub.

Maven có Bảng kê khai thành phần (BOM)

Nếu bạn đang sử dụng Maven với BOM, thêm đoạn mã này vào tệp pom.xml của bạn:

  <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 BOM, thêm đoạn mã này vào phần phụ thuộc:

<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, thêm đoạn mã này vào phần phụ thuộc:

implementation 'com.google.cloud:google-cloud-chat:0.10.0'

SBT

Nếu bạn đang sử dụng SBT, hãy thêm đoạn mã này vào phần phụ thuộc:

libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"

Tìm hiểu thêm:

Python

Trên máy Mac hoặc Linux, từ giao diện dòng lệnh, hãy chạy:

python3 -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat

Trên Windows, từ giao diện dòng lệnh, hãy chạy:

py -m venv <your-env>
.\<your-env>\Scripts\activate
pip install google-apps-chat

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 này trên hệ thống của bạn:

  1. Thay đổi thư mục dự án của bạn: cd /my/cloud/project.
  2. Lấy 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:

  1. Nếu cần, hãy cài đặt trình quản lý phần phụ thuộc Composer (Trình tổng hợp).
  2. 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 qua NuGet. Thêm thông tin này vào dự án theo cách thông thường (ví dụ: bằng cách nhấp chuột phải vào dự án trong Visual Studio rồi chọn "Manage NuGet Packages..."). Đảm bảo bạn bật gói phát hành trước (ví dụ: trong thẻ người dùng Visual Studio NuGet hãy chọn giao diện "Bao gồm bản phát hành trước" ).

Để cài đặt gói NuGet, hãy truy cập 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

Giải pháp thay thế cho Thư viện ứng dụng đá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 API Chat bằng tài nguyên REST và . Bạn có thể thích dùng Thư viện ứng dụng API của Google nếu bạn sử dụng ngôn ngữ không có Thư viện Cloud Client 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 những tính năng sau ngôn ngữ. Chọn ngôn ngữ mà bạn muốn dùng:

Go

Tải thư viện ứng dụng API Google Chat mới nhất cho phiên bản 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 chứa 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 dành cho Java. Để 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:

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 chứa 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 dành 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 API Google Chat 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 API Google Chat mới nhất cho Target-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 API Google Chat 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 chứa 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 dành 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

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

  1. Tải thư viện ứng dụng mới nhất cho Python.
  2. Giải nén mã.
  3. 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 chứa 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 dành 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

Đâ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.

Xác thực

Để gọi API Chat, bạn cần xác thực. Một Phương thức API Chat yêu cầu xác thực người dùng (để thực hiện hành động hoặc truy cập thay mặt cho người dùng) hoặc xác thực ứng dụng (để thực hiện thao tác hoặc truy cập vào dữ liệu dưới dạng ứng dụng Chat). Hơi nhiều 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ề việc xác thực trong Chat, hãy xem Tổng quan về việc xác thực.