客户端库可优化开发者调用 Google Chat API 的体验 减少必须编写的样板代码。本指南介绍了 并说明如何安装这些客户端库。
Chat API 具有 gRPC 和 REST 接口 客户端库。Cloud 客户端库支持 gRPC 和 REST 接口,Google API 客户端库仅支持 REST 接口, 可以在同一个项目中同时使用这两个客户端库。(可选)如果 提供的客户端库未能满足您的需求,您可以自行编写 使用 gRPC 或 REST 接口的客户端库中。
要详细了解 Google 支持的客户端库类型,请参阅 客户端库说明。
安装 Cloud 客户端库(推荐)
Cloud 客户端库 是适用于 Chat API。Cloud 客户端库同时支持 gRPC 和 REST 界面。
Chat API 提供以下语言的 Cloud 客户端库。 选择您要使用的语言:
Node.js
如需安装客户端库,请执行以下操作:
npm install @google-apps/chat
<ph type="x-smartling-placeholder">
了解详情:
Python
如需安装客户端库,请执行以下操作:
<ph type="x-smartling-placeholder">python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
了解详情:
Java
从以下标签页中选择您的构建环境。无论您选择哪个 请务必将版本更新到 GitHub。
使用 BoM 的 Maven
如果您使用的是
BOM、
将以下代码添加到您的 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>
没有 BoM 的 Maven
如果您使用的是没有 BOM、 将以下代码添加到您的依赖项中:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.9.0</version>
</dependency>
Gradle
如果您在未使用 Gradle 的情况下 BOM、 将以下代码添加到您的依赖项中:
implementation 'com.google.cloud:google-cloud-chat:0.10.0'
SBT
如果您使用的是 SBT,请将以下内容添加到您的依赖项中:
libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"
了解详情:
Go
导入适用于 Google Cloud 服务的 Go 软件包。
import "cloud.google.com/go"
如需在系统上安装软件包,请执行以下操作:
- 切换到您的项目目录:
cd /my/cloud/project
。 - 获取要使用的软件包:
go get cloud.google.com/go/chat
了解详情:
Ruby
如需安装客户端库,请执行以下操作:
gem install google-apps-chat
了解详情:
PHP
如需安装客户端库,请执行以下操作:
- 如有必要,请安装依赖项管理器 Composer。
- 在命令行界面中,运行以下命令:
composer require google/apps-chat
了解详情:
.NET
如需安装客户端库,请执行以下操作:
安装 NuGet 提供的 Google.Apps.Chat.V1
软件包。将它添加到
项目(例如在
Visual Studio 并选择“管理 NuGet 包...”)。请确保您
启用预发布软件包(例如,在 Visual Studio NuGet 用户
选中“包括预发行版”方框)。
如需安装 NuGet 软件包,请访问 NuGet.org 上的 Google.Apis。
了解详情:
安装 Google API 客户端库
Cloud 客户端库的替代方法 Google API 客户端库 使用 REST 资源以编程方式访问 Chat API, 方法。您可能更倾向于使用 Google API 客户端库。 Cloud 客户端库,或您要扩展已在使用它们的项目。
Chat API 为以下产品提供 Google API 客户端库 语言。选择您要使用的语言:
Go
获取最新的 Go 版 Google Chat API 客户端库(Alpha 版)。阅读该客户端库的开发者指南。
Java
此页面包含有关如何通过 适用于 Java 的 Google API 客户端库。如需了解详情,请参阅以下文档:
将客户端库添加到您的项目中
从以下标签页中选择构建环境(Maven 或 Gradle):
请将以下内容添加到 pom.xml
文件:
请将以下内容添加到 build.gradle
文件:
JavaScript
阅读该客户端库的开发者指南。
.NET
此页面包含有关如何通过 适用于 .NET 的 Google API 客户端库。如需了解详情,请参阅以下文档:
下载库
安装 NuGet 软件包:Google.Apis。
Node.js
获取最新的 Node.js 版 Google Chat API 客户端库。阅读该客户端库的开发者指南。
Obj-C
获取最新的 Objective-C 版 Google Chat API 客户端库。阅读该客户端库的开发者指南。
PHP
获取最新的 PHP 版 Google Chat API 客户端库。阅读该客户端库的开发者指南。
Python
此页面包含有关如何通过 适用于 Python 的 Google API 客户端库。如需了解详情,请参阅以下文档:
系统要求
- 操作系统:
- Linux
- macOS X
- Windows
- Python 2.7/3.4 或更高版本
安装客户端库
您既可以使用软件包管理器,也可以手动下载并安装 Python 客户端库:
托管安装
利用 pip 或 setuptools 管理安装流程,您可能需要先运行 sudo
。
- pip(首选):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
手动安装
- 下载最新的 Python 版客户端库。
- 解压缩代码。
- 安装:
python setup.py install
App Engine
由于 App Engine Python 运行时环境中未安装 Python 客户端库,因此您必须像使用第三方库一样将这些库复制到您的应用中。
Ruby
此页面包含有关如何通过 适用于 Ruby 的 Google API 客户端库。如需了解详情,请参阅以下文档:
安装 google-api-client
gem
您可能需要在这些命令前面加上 sudo
,具体取决于您的系统。
如果您之前未安装过 Ruby 版 Google API 客户端库,请使用 RubyGems
进行安装:
gem install google-api-client
如果您已安装 gem,请更新至最新版本:
gem update -y google-api-client
Ruby 版 Google API 客户端库使用入门
如需了解如何发出第一个请求,请参阅入门指南。
Apps 脚本和客户端库
建议大多数开发者调用 Google Chat API 是基于我们官方支持的 Cloud 客户端库 (例如 Python、Java 或 Node.js)。
如果您使用 Google Apps 脚本编写代码,请使用 高级 Chat 服务 而无需安装客户端库
身份验证
调用 Chat API 需要进行身份验证。每个 Chat API 方法需要 用户身份验证 (执行操作或访问 代表用户的数据)或 应用身份验证 (以 Chat 应用的形式执行操作或访问数据)。部分 方法同时支持用户身份验证和应用身份验证。
如需详细了解 Chat 中的身份验证,请参阅 身份验证概览。