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 인터페이스를 모두 지원합니다.

Chat API는 다음 언어의 Cloud 클라이언트 라이브러리를 제공합니다. 사용할 언어를 선택합니다.

Node.js

클라이언트 라이브러리 설치 방법:

npm install @google-apps/chat

자세히 알아보기:

Python

클라이언트 라이브러리 설치 방법:

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

자세히 알아보기:

자바

다음 탭에서 빌드 환경을 선택합니다. 어느 쪽을 사용하든 GitHub에서 제공되는 최신 버전으로 버전을 업데이트해야 합니다.

BOM이 있는 Maven

BOM과 함께 Maven을 사용하는 경우 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 없이 Maven을 사용하는 경우 종속 항목에 다음을 추가합니다.

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-chat</artifactId>
  <version>0.9.0</version>
</dependency>

Gradle

BOM 없이 Gradle을 사용하는 경우 종속 항목에 다음을 추가합니다.

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"

시스템에 패키지를 설치하려면 다음 단계를 따르세요.

  1. 프로젝트 디렉터리(cd /my/cloud/project)로 변경합니다.
  2. 사용할 패키지를 가져옵니다.
go get cloud.google.com/go/chat

자세히 알아보기:

Ruby

클라이언트 라이브러리 설치 방법:

gem install google-apps-chat

자세히 알아보기:

PHP

클라이언트 라이브러리 설치 방법:

  1. 필요한 경우 종속 항목 관리자 Composer를 설치합니다.
  2. 명령줄 인터페이스에서 다음을 실행합니다.
composer require google/apps-chat

자세히 알아보기:

.NET

클라이언트 라이브러리 설치 방법:

NuGet에서 Google.Apps.Chat.V1 패키지를 설치합니다. 일반적인 방법으로 프로젝트에 추가합니다(예를 들어 Visual Studio에서 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 'Manage NuGet Packages...'(NuGet 패키지 관리)를 선택). 출시 전 패키지를 사용 설정해야 합니다(예를 들어 Visual Studio NuGet 사용자 인터페이스에서 'Include prerelease(출시 전 버전 포함)' 상자 선택).

NuGet 패키지를 설치하려면 NuGet.org의 Google.Apis를 방문하세요.

자세히 알아보기:

Google API 클라이언트 라이브러리 설치

Cloud 클라이언트 라이브러리의 대안인 Google API 클라이언트 라이브러리는 REST 리소스와 메서드를 사용하여 Chat API에 프로그래매틱 액세스를 제공합니다. Cloud 클라이언트 라이브러리가 없는 언어를 사용하거나 이미 Cloud 클라이언트 라이브러리를 사용하는 프로젝트를 확장하는 경우 Google API 클라이언트 라이브러리를 사용하는 것이 좋습니다.

Chat API는 다음 언어의 Google API 클라이언트 라이브러리를 제공합니다. 사용할 언어를 선택합니다.

Go

최신 Go용 Google Chat API 클라이언트 라이브러리 (알파)를 가져옵니다. 클라이언트 라이브러리의 개발자 가이드를 읽어 보세요.

자바

이 페이지에는 자바용 Google API 클라이언트 라이브러리를 사용하여 Google Chat API를 시작하는 방법에 관한 정보가 포함되어 있습니다. 자세한 내용은 다음 설명서를 참고하세요.

프로젝트에 클라이언트 라이브러리 추가하기

다음 탭에서 빌드 환경(Maven 또는 Gradle)을 선택합니다.

자바스크립트

클라이언트 라이브러리의 개발자 가이드를 읽어 보세요.

.NET

이 페이지에는 .NET용 Google API 클라이언트 라이브러리를 사용하여 Google Chat 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 클라이언트 라이브러리를 사용하여 Google Chat API를 시작하는 방법에 관한 정보가 포함되어 있습니다. 자세한 내용은 다음 설명서를 참고하세요.

시스템 요구사항

클라이언트 라이브러리 설치하기

패키지 관리자를 사용하거나 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

Python 클라이언트 라이브러리는 App Engine Python 런타임 환경에 설치되어 있지 않으므로 타사 라이브러리와 마찬가지로 애플리케이션에 복사해야 합니다.

Ruby

이 페이지에는 Ruby용 Google API 클라이언트 라이브러리를 사용하여 Google Chat 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를 호출하는 데 권장되는 방법은 Python, Java, Node.js와 같이 선호하는 언어로 공식적으로 지원되는 Cloud 클라이언트 라이브러리를 사용하는 것입니다.

Google Apps Script로 코딩하는 경우 클라이언트 라이브러리를 설치하는 대신 고급 Chat 서비스를 사용하세요.

인증

Chat API를 호출하려면 인증이 필요합니다. 각 Chat API 메서드에는 사용자 인증(사용자를 대신하여 작업을 실행하거나 데이터에 액세스하기 위해) 또는 앱 인증(Chat 앱으로 작업을 실행하거나 데이터에 액세스하기 위해)이 필요합니다. 일부 메서드는 사용자 인증과 앱 인증을 모두 지원합니다.

Chat의 인증에 대해 자세히 알아보려면 인증 개요를 참고하세요.