کتابخانه های سرویس گیرنده Google Chat API

کتابخانه‌های سرویس گیرنده، تجربه توسعه‌دهنده را برای تماس با Google Chat API با کاهش کد دیگ بخاری که باید بنویسید، بهینه می‌کنند. این راهنما کتابخانه های سرویس گیرنده را معرفی می کند و نحوه نصب آنها را توضیح می دهد.

Chat API دارای رابط های gRPC و REST و کتابخانه های سرویس گیرنده ای است که از هر دو پشتیبانی می کنند. Cloud Client Libraries از رابط های gRPC و REST پشتیبانی می کند، Google API Client Libraries فقط از رابط REST پشتیبانی می کند، اما می توانید از هر دو کتابخانه مشتری در یک پروژه استفاده کنید. به صورت اختیاری، اگر کتابخانه های مشتری ارائه شده نیازهای شما را برآورده نمی کند، می توانید کتابخانه های مشتری خود را بنویسید که از رابط gRPC یا REST استفاده می کنند.

برای اطلاعات بیشتر در مورد انواع کتابخانه های سرویس گیرنده که Google پشتیبانی می کند، به توضیح کتابخانه های مشتری مراجعه کنید.

نصب کتابخانه های سرویس گیرنده ابری (توصیه می شود)

Cloud Client Libraries جدیدترین و توصیه‌شده‌ترین کتابخانه‌های سرویس گیرنده برای تماس با Chat API هستند. Cloud Client Libraries از هر دو رابط gRPC و REST پشتیبانی می کند.

Chat API کتابخانه های سرویس گیرنده ابری را برای زبان های زیر فراهم می کند. زبانی را که می خواهید استفاده کنید انتخاب کنید:

Node.js

برای نصب کتابخانه مشتری:

npm install @google-apps/chat

نمونه‌های کتابخانه کلاینت Cloud را برای Node.js بررسی کنید.

بیشتر بدانید:

• مخزن GitHub
• مرجع Cloud Client Library
• شروع سریع

پایتون

برای نصب کتابخانه مشتری:

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

نمونه‌های کتابخانه کلاینت Cloud را برای پایتون بررسی کنید.

بیشتر بدانید:

• مخزن GitHub
• مرجع Cloud Client Library
• شروع سریع

جاوا

محیط ساخت خود را از تب های زیر انتخاب کنید. از هر کدام که استفاده می کنید، به یاد داشته باشید که نسخه را به آخرین نسخه موجود در GitHub به روز کنید.

Maven با 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>

Maven بدون BOM

اگر از Maven بدون BOM استفاده می کنید، این را به وابستگی های خود اضافه کنید:

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

گریدل

اگر از 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 را برای جاوا بررسی کنید.

بیشتر بدانید:

• مخزن GitHub
• مرجع Cloud Client Library
• شروع سریع

برو

بسته‌های Go را برای سرویس‌های Google Cloud وارد کنید.

import "cloud.google.com/go"

برای نصب بسته بر روی سیستم خود:

1. دایرکتوری پروژه خود را تغییر دهید: cd /my/cloud/project .
2. بسته مورد نظر خود را دریافت کنید:

go get cloud.google.com/go/chat

بیشتر بدانید:

• مخزن GitHub
• مرجع Cloud Client Library

روبی

برای نصب کتابخانه مشتری:

gem install google-apps-chat

بیشتر بدانید:

• مخزن GitHub
• مرجع Cloud Client Library

PHP

برای نصب کتابخانه مشتری:

1. در صورت لزوم، Dependency Manager Composer را نصب کنید.
2. از رابط خط فرمان خود، اجرا کنید:

composer require google/apps-chat

بیشتر بدانید:

• مخزن GitHub
• مرجع Cloud Client Library

دات نت

برای نصب کتابخانه مشتری:

بسته Google.Apps.Chat.V1 را از NuGet نصب کنید. آن را به روش عادی به پروژه خود اضافه کنید (به عنوان مثال با کلیک راست روی پروژه در ویژوال استودیو و انتخاب "Manage NuGet Packages..."). مطمئن شوید که بسته‌های قبل از انتشار را فعال کرده‌اید (برای مثال، در رابط کاربری Visual Studio NuGet، کادر «Include prerelease» را علامت بزنید).

برای نصب بسته NuGet، از Google.Apis در NuGet.org دیدن کنید.

بیشتر بدانید:

• مخزن GitHub
• مرجع Cloud Client Library

Google API Client Libraries را نصب کنید

Google API Client Libraries جایگزینی برای Cloud Client Libraries، با استفاده از منابع و روش‌های REST، دسترسی برنامه‌ای به Chat API را فراهم می‌کند. اگر از زبانی استفاده می کنید که کتابخانه سرویس گیرنده ابری ندارد، یا اگر در حال توسعه پروژه ای هستید که قبلاً از آنها استفاده می کند، ممکن است ترجیح دهید از Google API Client Libraries استفاده کنید.

Chat API کتابخانه های سرویس گیرنده Google API را برای زبان های زیر فراهم می کند. زبانی را که می خواهید استفاده کنید انتخاب کنید:

برو

آخرین کتابخانه سرویس گیرنده Google Chat API را برای Go (آلفا) دریافت کنید. راهنمای توسعه‌دهنده کتابخانه مشتری را بخوانید.

جاوا

این صفحه حاوی اطلاعاتی درباره شروع کار با Google Chat API با استفاده از Google API Client Library برای جاوا است. برای اطلاعات بیشتر به مستندات زیر مراجعه کنید:

• مرجع Javadoc را برای Google Chat API مرور کنید.
• راهنمای توسعه‌دهنده Google API Client Library برای جاوا را بخوانید.

کتابخانه مشتری را به پروژه خود اضافه کنید

محیط ساخت خود (Maven یا Gradle) را از زبانه های زیر انتخاب کنید:

ماون

موارد زیر را به فایل pom.xml خود اضافه کنید:

تمام نسخه های موجود در مخزن مرکزی Maven را ببینید.

گریدل

موارد زیر را به فایل build.gradle خود اضافه کنید:

تمام نسخه های موجود در مخزن مرکزی Maven را ببینید.

جاوا اسکریپت

راهنمای توسعه‌دهنده کتابخانه مشتری را بخوانید.

دات نت

این صفحه حاوی اطلاعاتی درباره شروع با Google Chat API با استفاده از Google API Client Library برای دات نت است. برای اطلاعات بیشتر به مستندات زیر مراجعه کنید:

• اسناد مرجع دات نت را برای Google Chat API مرور کنید.
• راهنمای برنامه‌نویس Google API Client Library را برای دات‌نت بخوانید.

در حال دانلود کتابخانه

بسته NuGet را نصب کنید: Google.Apis .

Node.js

آخرین کتابخانه سرویس گیرنده Google Chat API را برای Node.js دریافت کنید. راهنمای توسعه‌دهنده کتابخانه مشتری را بخوانید.

Obj-C

آخرین کتابخانه سرویس گیرنده Google Chat API را برای Objective-C دریافت کنید. راهنمای توسعه‌دهنده کتابخانه مشتری را بخوانید.

PHP

آخرین کتابخانه سرویس گیرنده Google Chat API را برای PHP دریافت کنید. راهنمای توسعه‌دهنده کتابخانه مشتری را بخوانید.

پایتون

این صفحه حاوی اطلاعاتی درباره شروع کار با Google Chat API با استفاده از Google API Client Library برای پایتون است. برای اطلاعات بیشتر به مستندات زیر مراجعه کنید:

• مرجع PyDoc را برای Google Chat API مرور کنید.
• راهنمای توسعه‌دهنده Google API Client Library برای Python را بخوانید.

سیستم مورد نیاز

• سیستم عامل:
  • لینوکس
  • macOS X
  • ویندوز
• پایتون 2.7 یا 3.4 یا بالاتر

کتابخانه مشتری را نصب کنید

می توانید از یک مدیریت بسته استفاده کنید یا به صورت دستی کتابخانه کلاینت پایتون را دانلود و نصب کنید:

نصب مدیریت شده

از pip یا setuptools برای مدیریت نصب خود استفاده کنید. شاید لازم باشد ابتدا sudo اجرا کنید.

• پیپ (ترجیحا):

  pip install --upgrade google-api-python-client

• ابزارهای نصب :

  easy_install --upgrade google-api-python-client

نصب دستی

1. آخرین کتابخانه مشتری برای پایتون را دانلود کنید .
2. کد را باز کنید.
3. نصب کنید:

   python setup.py install

موتور برنامه

از آنجایی که کتابخانه‌های کلاینت پایتون در محیط اجرای برنامه موتور پایتون نصب نشده‌اند، باید آنها را مانند کتابخانه‌های شخص ثالث در برنامه خود کپی کنید .

روبی

این صفحه حاوی اطلاعاتی درباره شروع کار با Google Chat API با استفاده از Google API Client Library برای Ruby است. برای اطلاعات بیشتر به مستندات زیر مراجعه کنید:

• راهنمای شروع برای Google API Client Library برای Ruby را بخوانید.

جم google-api-client را نصب کنید

بسته به سیستم شما، ممکن است لازم باشد این دستورات را با sudo اضافه کنید.

اگر قبلاً Google API Client Library را برای Ruby نصب نکرده‌اید، با استفاده از RubyGems نصب کنید:

gem install google-api-client

اگر قبلاً Gem را نصب کرده‌اید، به آخرین نسخه به‌روزرسانی کنید:

gem update -y google-api-client

با Google API Client Library for Ruby شروع کنید

برای آشنایی با نحوه ارائه اولین درخواست، به راهنمای شروع کار مراجعه کنید.

اسکریپت برنامه ها و کتابخانه های سرویس گیرنده

روش توصیه شده برای اکثر توسعه دهندگان برای فراخوانی Google Chat API با کتابخانه های Cloud Client ما برای زبان دلخواه شما مانند Python، جاوا یا Node.js است.

اگر با Google Apps Script کدنویسی می کنید، به جای نصب کتابخانه سرویس گیرنده، از سرویس گفتگوی پیشرفته استفاده کنید.

احراز هویت

فراخوانی Chat API نیاز به احراز هویت دارد. هر روش Chat API به احراز هویت کاربر (برای انجام اقدامات یا دسترسی به داده‌ها از طرف یک کاربر) یا تأیید اعتبار برنامه (برای انجام اقدامات یا دسترسی به داده‌ها به عنوان برنامه چت) نیاز دارد. برخی از روش ها هم از احراز هویت کاربر و هم از تأیید اعتبار برنامه پشتیبانی می کنند.

برای کسب اطلاعات بیشتر درباره احراز هویت در چت، به نمای کلی احراز هویت مراجعه کنید.