Google Chat API 用戶端程式庫

用戶端程式庫能最佳化開發人員呼叫 Google Chat API 的體驗 來減少一成不變的程式碼編寫作業本指南將介紹 用戶端程式庫，並說明如何安裝這些程式庫。

Chat API 有 gRPC 和 REST 介面 支援這兩種架構的用戶端程式庫Cloud 用戶端程式庫支援 gRPC 和 REST Google API 用戶端程式庫僅支援 REST 介面，不過您 同一個專案中可以使用這兩個用戶端程式庫。選用 (如有) 提供的用戶端程式庫不符合您的需求 使用 gRPC 或 REST 介面的用戶端程式庫。

如要進一步瞭解 Google 支援的用戶端程式庫類型，請參閱 用戶端程式庫說明。

安裝 Cloud 用戶端程式庫 (建議選項)

Cloud 用戶端程式庫 是呼叫程式庫時建議使用的最新版用戶端程式庫 Chat API。Cloud 用戶端程式庫支援 gRPC 和 REST 存取 API

Chat API 提供下列語言的 Cloud 用戶端程式庫。 選取要使用的語言：

Node.js

如要安裝用戶端程式庫：

npm install @google-apps/chat

查看 Cloud 用戶端程式庫的範例 Node.js。

瞭解詳情：

• GitHub 存放區
• Cloud 用戶端程式庫參考資料
• 快速入門導覽課程

Python

如要安裝用戶端程式庫：

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

查看 Cloud 用戶端程式庫的範例 Python。

瞭解詳情：

• GitHub 存放區
• Cloud 用戶端程式庫參考資料
• 快速入門導覽課程

Java

從下列分頁中選取建構環境。隨心所欲 請記得將應用程式更新至 GitHub。

採用 BOM 的 Maven

如果您是透過以下方式使用 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

如果您使用 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"

查看 Cloud 用戶端程式庫的範例 Java。

瞭解詳情：

• GitHub 存放區
• Cloud 用戶端程式庫參考資料
• 快速入門導覽課程

Go

匯入 Google Cloud 服務的 Go 套件。

import "cloud.google.com/go"

如何在您的系統上安裝套件：

1. 變更至專案目錄：cd /my/cloud/project。
2. 取得您要使用的套件：

go get cloud.google.com/go/chat

瞭解詳情：

• GitHub 存放區
• Cloud 用戶端程式庫參考資料

小茹

如要安裝用戶端程式庫：

gem install google-apps-chat

瞭解詳情：

• GitHub 存放區
• Cloud 用戶端程式庫參考資料

PHP

如要安裝用戶端程式庫：

1. 如有需要，請安裝依附元件管理員 Composer。
2. 從指令列介面執行下列指令：

composer require google/apps-chat

瞭解詳情：

• GitHub 存放區
• Cloud 用戶端程式庫參考資料

.NET

如要安裝用戶端程式庫：

從 NuGet 安裝 Google.Apps.Chat.V1 套件。新增至 您可以在 Visual Studio，並選擇 [管理 NuGet 套件...]。務必 啟用預先發布版套件 (例如在 Visual Studio NuGet 使用者中) 介面上，勾選 [包括預先發布版]方塊)。

如要安裝 NuGet 套件，請造訪 NuGet.org 中的 Google.Apis。

瞭解詳情：

• GitHub 存放區
• Cloud 用戶端程式庫參考資料

安裝 Google API 用戶端程式庫

Cloud 用戶端程式庫的替代方案 Google API 用戶端程式庫 可讓您透過 REST 資源和程式輔助方式存取 Chat API 方法。您可能想使用 Google API 用戶端程式庫 (如果所使用的語言沒有 或要擴充已使用該程式庫的專案。

Chat API 提供以下項目的 Google API 用戶端程式庫 語言。選取要使用的語言：

Go

取得適用於 Go 的 Google Chat API 用戶端程式庫 (Alpha 版) 最新版本。閱讀用戶端程式庫的開發人員指南。

Java

本頁說明如何開始使用 Google Chat API， 適用於 Java 的 Google API 用戶端程式庫詳情請參閱下列說明文件：

• 瀏覽 Google Chat API 的 Javadoc 參考資料。
• 閱讀適用於 Java 的 Google API 用戶端程式庫開發人員指南。

在專案中加入用戶端程式庫

從下列分頁選取您的建構環境 (Maven 或 Gradle)：

Maven

請將以下內容新增到 pom.xml 檔案中：

您可以在這裡找到 Maven Central Repository 提供的所有版本。

Gradle

請將以下內容新增到 build.gradle 檔案中：

您可以在這裡找到 Maven Central Repository 提供的所有版本。

JavaScript

閱讀用戶端程式庫的開發人員指南。

.NET

本頁說明如何開始使用 Google Chat API， 適用於 .NET 的 Google API 用戶端程式庫詳情請參閱下列說明文件：

• 瀏覽 Google Chat API 的 .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

本頁說明如何開始使用 Google Chat API， 適用於 Python 的 Google API 用戶端程式庫詳情請參閱下列說明文件：

• 瀏覽 Google Chat API 的 PyDoc 參考資料。
• 閱讀適用於 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

手動安裝

1. 下載最新版 Python 用戶端程式庫。
2. 解壓縮程式碼。
3. 安裝：

   python setup.py install

App Engine

App Engine Python 執行階段環境並未安裝 Python 用戶端程式庫，因此您必須將這類程式庫複製到應用程式中，就像第三方用戶端程式庫一樣。

小茹

本頁說明如何開始使用 Google Chat API， 適用於 Ruby 的 Google API 用戶端程式庫詳情請參閱下列說明文件：

• 閱讀適用於 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 Script 和用戶端程式庫

對大多數開發人員呼叫 Google Chat API 的建議做法 包含正式支援的 Cloud 用戶端程式庫 。

如果您是透過 Google Apps Script 編寫程式碼，請使用 進階 Chat 服務 無須安裝用戶端程式庫

驗證

呼叫 Chat API 需要驗證。每項 Chat API 方法需要 使用者驗證 (以便執行操作或存取 代表使用者的資料) 或 應用程式驗證 (以 Chat 應用程式的形式執行動作或存取資料)。只有部分通知 方法均支援使用者驗證和應用程式驗證。

如要進一步瞭解 Chat 的驗證，請參閱 驗證總覽。