Google Chat API istemci kitaplıkları

İstemci kitaplıkları, yazmanız gereken ortak metin kodlarını azaltarak Google Chat API'yi çağırma konusunda geliştirici deneyimini optimize eder. Bu kılavuzda istemci kitaplıkları tanıtılmakta ve bunların nasıl yükleneceği açıklanmaktadır.

Chat API'de gRPC ve REST arayüzleri ile her ikisini de destekleyen istemci kitaplıkları bulunur. Cloud istemci kitaplıkları gRPC ve REST arayüzlerini, Google API istemci kitaplıkları ise yalnızca REST arayüzünü destekler. Ancak aynı projede her iki istemci kitaplığını da kullanabilirsiniz. İsteğe bağlı olarak, sağlanan istemci kitaplıkları ihtiyaçlarınızı karşılamıyorsa gRPC veya REST arayüzünü kullanan kendi istemci kitaplıklarınızı yazabilirsiniz.

Google'ın desteklediği istemci kitaplığı türleri hakkında daha fazla bilgi edinmek için İstemci kitaplıkları hakkında başlıklı makaleyi inceleyin.

Cloud İstemci Kitaplıklarını yükleme (önerilen)

Cloud İstemci Kitaplıkları, Chat API'yi çağırmak için en güncel ve önerilen istemci kitaplıklarıdır. Cloud istemci kitaplıkları hem gRPC hem de REST arayüzlerini destekler.

Chat API, aşağıdaki diller için Cloud İstemci Kitaplıkları sağlar. Kullanmak istediğiniz dili seçin:

Node.js

İstemci kitaplığını yüklemek için:

npm install @google-apps/chat

Daha fazla bilgi:

Python

İstemci kitaplığını yüklemek için:

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

Daha fazla bilgi:

Java

Aşağıdaki sekmelerden derleme ortamınızı seçin. Hangisini kullanırsanız kullanın sürümü GitHub'daki en son sürüme güncellemeyi unutmayın.

BOM içeren Maven

Maven'i BOM ile kullanıyorsanız pom.xml dosyanıza şunları ekleyin:

  <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'suz Maven

Maven'i BOM olmadan kullanıyorsanız şunu bağımlılıklarınıza ekleyin:

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

Gradle

Gradle'ı BOM olmadan kullanıyorsanız aşağıdakileri bağımlılıklarınıza ekleyin:

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

SBT

SBT kullanıyorsanız aşağıdakileri bağımlılıklarınıza ekleyin:

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

Daha fazla bilgi:

Go

Google Cloud hizmetleri için Go paketlerini içe aktarın.

import "cloud.google.com/go"

Paketi sisteminize yüklemek için:

  1. Proje dizininize geçin: cd /my/cloud/project.
  2. Kullanmak istediğiniz paketi edinin:
go get cloud.google.com/go/chat

Daha fazla bilgi:

Ruby

İstemci kitaplığını yüklemek için:

gem install google-apps-chat

Daha fazla bilgi:

PHP

İstemci kitaplığını yüklemek için:

  1. Gerekirse bağımlılık yöneticisi Composer'ı yükleyin.
  2. Komut satırı arayüzünüzde şu komutu çalıştırın:
composer require google/apps-chat

Daha fazla bilgi:

.NET

İstemci kitaplığını yüklemek için:

NuGet'ten Google.Apps.Chat.V1 paketini yükleyin. Paketi projenize normal şekilde ekleyin (örneğin, Visual Studio'da projeyi sağ tıklayıp "NuGet Paketlerini Yönet..."i seçerek). Yayın öncesi paketleri etkinleştirdiğinizden emin olun (örneğin, Visual Studio NuGet kullanıcı arayüzünde "Yayın öncesi sürümü dahil et" kutusunu işaretleyin).

NuGet paketini yüklemek için NuGet.org'daki Google.Apis sayfasını ziyaret edin.

Daha fazla bilgi:

Google API İstemci Kitaplıklarını Yükleme

Cloud İstemci Kitaplıkları'na alternatif olarak Google API İstemci Kitaplıkları, REST kaynaklarını ve yöntemlerini kullanarak Chat API'ye programatik erişim sağlar. Cloud istemci kitaplığı olmayan bir dil kullanıyorsanız veya zaten bu kitaplıkları kullanan bir projeyi genişletiyorsanız Google API istemci kitaplıklarını kullanmayı tercih edebilirsiniz.

Chat API, aşağıdaki diller için Google API istemci kitaplıkları sağlar. Kullanmak istediğiniz dili seçin:

Go

Go (alfa) için Google Chat API istemci kitaplığının en son sürümünü edinin. İstemci kitaplığının geliştirici kılavuzunu okuyun.

Java

Bu sayfada, Java için Google API İstemci Kitaplığı'nı kullanarak Google Chat API'sini kullanmaya başlama hakkında bilgiler yer alır. Daha fazla bilgi için aşağıdaki dokümanlara bakın:

İstemci kitaplığını projenize ekleme

Aşağıdaki sekmelerden derleme ortamınızı (Maven veya Gradle) seçin:

JavaScript

İstemci kitaplığının geliştirici kılavuzunu okuyun.

.NET

Bu sayfada, .NET için Google API istemci kitaplığını kullanarak Google Chat API'yi kullanmaya başlama hakkında bilgiler yer alır. Daha fazla bilgi için aşağıdaki dokümanlara bakın:

Kitaplığı indirme

NuGet paketini yükleyin: Google API'leri.

Node.js

Node.js için Google Chat API istemci kitaplığının en son sürümünü edinin. İstemci kitaplığının geliştirici kılavuzunu okuyun.

Obj-C

Objective-C için Google Chat API istemci kitaplığının en son sürümünü edinin. İstemci kitaplığının geliştirici kılavuzunu okuyun.

PHP

PHP için Google Chat API istemci kitaplığının en son sürümünü edinin. İstemci kitaplığının geliştirici kılavuzunu okuyun.

Python

Bu sayfada, Python için Google API İstemci Kitaplığı'nı kullanarak Google Chat API'sini kullanmaya başlama hakkında bilgiler yer alır. Daha fazla bilgi için aşağıdaki dokümanlara bakın:

Sistem gereksinimleri

İstemci kitaplığını yükleme

Paket yöneticisi kullanabilir ya da Python istemci kitaplığını manuel olarak indirip yükleyebilirsiniz:

Yönetilen yükleme

Yüklemenizi yönetmek için pip veya setuptools'u kullanın (Önce sudo öğesini çalıştırmanız gerekebilir.):

  • pip (tercih edilen): 
    pip install --upgrade google-api-python-client
  • Setuptools: 
    easy_install --upgrade google-api-python-client

Manuel yükleme

  1. Python için istemci kitaplığının en son sürümünü indirin.
  2. Kodu paketten çıkarın.
  3. Yükleme: 
    python setup.py install

App Engine

Python istemci kitaplıkları App Engine Python çalışma zamanı ortamında yüklenmediğinden, tıpkı üçüncü kitaplıklar gibi bunları uygulamanıza kopyalamanız gerekir.

Ruby

Bu sayfada, Ruby için Google API İstemci Kitaplığı'nı kullanarak Google Chat API'sini kullanmaya başlama hakkında bilgiler yer alır. Daha fazla bilgi için aşağıdaki dokümanlara bakın:

google-api-client gem'ini yükleme

Sisteminize bağlı olarak, bu komutların başına sudo eklemeniz gerekebilir.

Daha önce Ruby için Google API istemci kitaplığını yüklemediyseniz RubyGems kullanarak yükleyin: 

gem install google-api-client

Gem zaten yüklüyse en son sürüme güncelleyin: 

gem update -y google-api-client

Ruby için Google API İstemci Kitaplığı'nı kullanmaya başlama

İlk kez nasıl istekte bulunacağınızı öğrenmek için Başlangıç kılavuzuna bakın.

Apps Script ve istemci kitaplıkları

Çoğu geliştiricinin Google Chat API'yi çağırması için önerilen yöntem, tercih ettiğiniz dil (ör. Python, Java veya Node.js) için resmi olarak desteklenen Cloud istemci kitaplıklarımızı kullanmaktır.

Google Apps Komut Dosyası ile kod yazıyorsanız istemci kitaplığı yüklemek yerine Gelişmiş Chat hizmetini kullanın.

Kimlik doğrulama

Chat API'yi çağırmak için kimlik doğrulama gerekir. Her Chat API yöntemi için kullanıcı kimlik doğrulaması (kullanıcı adına işlem yapmak veya verilere erişmek için) ya da uygulama kimlik doğrulaması (Chat uygulaması olarak işlem yapmak veya verilere erişmek için) gerekir. Bazı yöntemler hem kullanıcı kimlik doğrulamasını hem de uygulama kimlik doğrulamasını destekler.

Chat'te kimlik doğrulama hakkında daha fazla bilgi edinmek için Kimlik doğrulamaya genel bakış başlıklı makaleyi inceleyin.