تعمل مكتبات العملاء على تحسين تجربة المطوّر عند استدعاء 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/activatepip 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"
لتثبيت الحزمة على نظامك:
- انتقِل إلى دليل مشروعك:
cd /my/cloud/project. - احصل على الحزمة التي تريد استخدامها:
go get cloud.google.com/go/chatمزيد من المعلومات:
Ruby
لتثبيت مكتبة العميل:
gem install google-apps-chatمزيد من المعلومات:
PHP
لتثبيت مكتبة العميل:
- ثبِّت مدير التبعيات Composer إذا لزم الأمر.
- من واجهة سطر الأوامر، شغِّل:
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 للغة Go (الإصدار الأولي). راجِع دليل المطوّر الخاص بمكتبة البرامج.
Java
تحتوي هذه الصفحة على معلومات حول بدء استخدام Google Chat API من خلال مكتبة برامج Google API للغة Java. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:
- تصفَّح مرجع JavaDoc حول Google Chat API.
- اطَّلِع على دليل المطوّر لمكتبة برامج Google API للغة Java.
إضافة مكتبة البرامج إلى مشروعك
يمكنك اختيار بيئة الإصدار (Maven أو Gradle) من بين علامات التبويب التالية:
أضِف ما يلي إلى ملف pom.xml:
أضِف ما يلي إلى ملف build.gradle:
JavaScript
راجِع دليل المطوّر الخاص بمكتبة البرامج.
NET.
تحتوي هذه الصفحة على معلومات حول بدء استخدام Google Chat API من خلال مكتبة برامج Google API لنظام .NET. لمزيد من المعلومات، يمكنك الاطّلاع على المستندات التالية:
تنزيل المكتبة
ثبِّت حزمة NuGet: Google.Apis.
Node.js
يمكنك الحصول على أحدث مكتبة برامج خاصة بواجهة برمجة تطبيقات Google Chat لنظام Node.js. راجِع دليل المطوّر الخاص بمكتبة البرامج.
Obj-C
يمكنك الحصول على أحدث مكتبة برامج لواجهة برمجة التطبيقات Google Chat API للغة Objective-C. راجِع دليل المطوّر الخاص بمكتبة البرامج.
PHP
يمكنك الحصول على أحدث مكتبة برامج لواجهة برمجة تطبيقات Google Chat للغة PHP. راجِع دليل المطوّر الخاص بمكتبة البرامج.
Python
تحتوي هذه الصفحة على معلومات حول بدء استخدام Google Chat API من خلال مكتبة برامج Google API للغة Python. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:
- تصفَّح مرجع PyDoc حول Google Chat API.
- اطَّلِع على دليل المطوّر لمكتبة برامج Google API للغة Python.
متطلبات النظام
- أنظمة التشغيل:
- Linux
- Mac OS X
- Windows
- الإصدار 2.7 أو 3.4 أو الإصدارات اللاحقة من نظام Python
تثبيت مكتبة البرامج
يمكنك استخدام أداة إدارة الحِزم أو تنزيل مكتبة برامج Python يدويًا وتثبيتها:
التثبيت المُدار
استخدِم pip أو setuptools لإدارة التثبيت. قد تحتاج إلى تشغيل sudo أولاً.
- pip (يفضَّل استخدامها):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
التثبيت اليدوي
- نزِّل مكتبة البرامج الأحدث للغة Python.
- فُكَّ حزمة الرمز.
- ثبِّت المكتبة:
python setup.py install
App Engine
بما أنّ مكتبات برامج Python غير مثبَّتة في بيئة وقت تشغيل Python في App Engine، عليك نسخها إلى تطبيقك كما هي الحال مع مكتبات الجهات الخارجية.
Ruby
تحتوي هذه الصفحة على معلومات عن بدء استخدام Google Chat API من خلال مكتبة برامج Google API للغة Ruby. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:
- اطَّلِع على دليل البدء لمكتبة برامج Google API للغة Ruby.
تنزيل أداة google-api-client
وفقًا للنظام الذي تستخدمه، قد تحتاج إلى إضافة هذه الأوامر من خلال sudo.
في حال لم يسبق لك تثبيت مكتبة برامج Google API للغة Ruby، ثبِّتها باستخدام RubyGems:
gem install google-api-client
إذا سبق لك تثبيت الأداة، يمكن تحديثها إلى أحدث إصدار:
gem update -y google-api-client
بدء استخدام مكتبة برامج Google API للغة Ruby
للاطّلاع على كيفية تقديم طلبك الأول، راجِع دليل البدء.
"برمجة التطبيقات" ومكتبات العملاء
إنّ الطريقة المُقترَحة لمعظم المطوّرين للاتّصال بواجهة برمجة التطبيقات Google Chat API هي باستخدام مكتبات عملاء Cloud المتوافقة رسميًا بلغتك المفضّلة، مثل Python أو Java أو Node.js.
إذا كنت تُنشئ الرموز البرمجية باستخدام "برمجة تطبيقات Google"، استخدِم خدمة Chat المتقدّمة بدلاً من تثبيت مكتبة عملاء.
المصادقة
يتطلب الاتصال بواجهة برمجة التطبيقات Chat API المصادقة. تتطلّب كل طريقة في Chat API إما مصادقة المستخدم (لتنفيذ الإجراءات أو الوصول إلى البيانات نيابةً عن المستخدم) أو مصادقة التطبيق (لتنفيذ الإجراءات أو الوصول إلى البيانات بصفتك تطبيق Chat). تتيح بعض methods مصادقة المستخدم ومصادقة التطبيق.
لمزيد من المعلومات عن المصادقة في Chat، يُرجى الاطّلاع على نظرة عامة على المصادقة.