مكتبات عملاء واجهة Google Chat API (original) (raw)

تعمل مكتبات العملاء على تحسين تجربة المطوّر عند استدعاء Google Chat API من خلال تقليل الرمز البرمجي المتكرّر الذي يجب كتابته. يقدّم هذا الدليل مكتبات العميل ويوضّح كيفية تثبيتها.

تتضمّن Chat API واجهتَي برمجة التطبيقاتgRPCوRESTومكتبات عملاء متوافقة مع كليهما. تتوافق مكتبات عملاء Cloud مع واجهات gRPC وREST، بينما تتوافق مكتبات عملاء Google API مع واجهة REST فقط، ولكن يمكنك استخدام كلتا مكتبتَي العملاء في المشروع نفسه. يمكنك اختياريًا كتابة مكتبات عملاء خاصة بك تستخدم واجهة gRPC أو REST إذا كانت مكتبات العملاء المقدَّمة لا تلبي احتياجاتك.

للاطّلاع على مزيد من المعلومات عن أنواع مكتبات العملاء التي تتوافق مع Google، يمكنك الاطّلاع على مقالة شرح مكتبات العملاء.

تثبيت مكتبات برامج Cloud Client (إجراء يُنصح به)

مكتبات عملاء 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

مزيد من المعلومات:

Java

اختَر بيئة الإنشاء من علامات التبويب التالية. أيًا كان الخيار الذي تستخدمه، احرص على تحديث الإصدار إلى أحدث إصدار متاح على 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

إذا كنت تستخدم 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.

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.

لتثبيت مكتبة العميل:

ثبِّت حزمة Google.Apps.Chat.V1 من NuGet. أضِفها إلى مشروعك بالطريقة المعتادة (على سبيل المثال، من خلال النقر بزر الماوس الأيمن على المشروع في IDE Visual Studio واختيار "إدارة حِزم NuGet"). تأكَّد من تفعيل حِزم الإصدارات التجريبية (على سبيل المثال، ضَع علامة في المربّع "تضمين الإصدار التجريبي" في واجهة مستخدم Visual Studio NuGet).

لتثبيت حزمة NuGet، يُرجى الانتقال إلىGoogle.Apis على NuGet.org.

مزيد من المعلومات:

تثبيت مكتبات عملاء Google API

مكتبات برامج Google API هي بديل لـ Cloud Client Libraries، وتوفر إمكانية الوصول الآلي إلى Chat API باستخدام موارد REST و methods. قد تفضّل استخدام مكتبات عميل واجهة برمجة تطبيقات Google إذا كنت تستخدم لغة لا تتضمّن مكتبة عميل سحابة إلكترونية، أو إذا كنت بصدد توسيع نطاق مشروع يستخدمها.

توفّر Chat API مكتبات Google API Client Libraries للغات التالية: اختَر اللغة التي تريد استخدامها:

"برمجة التطبيقات" ومكتبات العملاء

إنّ الطريقة المُقترَحة لمعظم المطوّرين للاتّصال بواجهة برمجة التطبيقات Google Chat API هي باستخدام مكتبات عملاء Cloud المتوافقة رسميًا بلغتك المفضّلة، مثل Python أو Java أو Node.js.

إذا كنت تُنشئ الرموز البرمجية باستخدام "برمجة تطبيقات Google"، استخدِمخدمة Chat المتقدّمةبدلاً من تثبيت مكتبة عملاء.

المصادقة

يتطلب الاتصال بواجهة برمجة التطبيقات Chat API المصادقة. تتطلّب كل طريقة في Chat API إما مصادقة المستخدم (لتنفيذ الإجراءات أو الوصول إلى البيانات نيابةً عن المستخدم) أو مصادقة التطبيق (لتنفيذ الإجراءات أو الوصول إلى البيانات بصفتك تطبيق Chat). تتيح بعض methods مصادقة المستخدم ومصادقة التطبيق.

لمزيد من المعلومات عن المصادقة في Chat، يُرجى الاطّلاع علىنظرة عامة على المصادقة.