تعمل مكتبات العملاء على تحسين تجربة المطوّرين لطلب البيانات من Google Chat API. عن طريق تقليل الرمز النموذجي الذي يجب كتابته. يقدم هذا الدليل مكتبات العملاء ويشرح كيفية تثبيتها.
تتضمّن واجهة Chat API gRPC أو REST والواجهات مكتبات العملاء التي تدعم كليهما. دعم مكتبات عملاء Cloud gRPC وREST فإن مكتبات عملاء Google API لا تتوافق إلا مع واجهة REST، ولكن استخدام مكتبتي العملاء في نفس المشروع. اختياريًا، إذا لا تلبي مكتبات العملاء المقدمة احتياجاتك، فيمكنك كتابة مكتبات العملاء التي تستخدم واجهة gRPC أو REST.
لمزيد من المعلومات حول وأنواع مكتبات العملاء المتوافقة مع Google، يمكنك الاطّلاع على شرح مكتبات البرامج:
تثبيت Cloud Client Libraries (إجراء يُنصح به)
مكتبات عميل Cloud أحدث مكتبات العملاء الموصى بها لإجراء مكالمات واجهة برمجة التطبيقات Chat تدعم "مكتبات عميل Cloud" كلاً من gRPC وREST. من الواجهات.
توفّر واجهة برمجة التطبيقات Chat API "مكتبات عميل Cloud" للّغات التالية. اختَر اللغة التي تريد استخدامها:
Node.js
لتثبيت مكتبة البرامج:
npm install @google-apps/chat
مزيد من المعلومات:
Java
اختَر بيئة التصميم من علامات التبويب التالية. أيًا كان استخدامه، تذكر تحديث الإصدار إلى أحدث إصدار متاح في GitHub.
Maven with 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"
مزيد من المعلومات:
Python
على نظام التشغيل Mac أو Linux، شغِّل من واجهة سطر الأوامر:
python3 -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
على نظام التشغيل Windows، من واجهة سطر الأوامر، شغِّل:
py -m venv <your-env>
.\<your-env>\Scripts\activate
pip install google-apps-chat
مزيد من المعلومات:
البدء
يمكنك استيراد حزم 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 require google/apps-chat
مزيد من المعلومات:
NET.
لتثبيت مكتبة البرامج:
ثبِّت حزمة Google.Apps.Chat.V1
من NuGet. إضافته إلى
مشروعك بالطريقة العادية (على سبيل المثال عن طريق النقر بزر الماوس الأيمن
فوق المشروع في
Visual Studio واختيار "إدارة حزم NuGet..."). تأكد من
تفعيل الحزم التجريبية (على سبيل المثال، في قسم Visual Studio NuGet
واجهة المستخدم، فتحقق من القسم "تضمين الإصدار التجريبي" ).
لتثبيت حزمة NuGet، انتقل إلى Google.Apis على الموقع الإلكتروني NuGet.org
مزيد من المعلومات:
تثبيت مكتبات برامج Google API
وكبديل لـ Cloud Client Libraries مكتبات عملاء Google API توفير إمكانية الوصول الآلي إلى واجهة Chat API باستخدام موارد REST الطرق. قد تفضل استخدام مكتبات برامج Google API، إذا كنت تستخدم لغة لا تحتوي على Cloud Client Library، أو في حال توسيع نطاق مشروع تستخدمه حاليًا
توفّر واجهة برمجة التطبيقات Chat مكتبات عملاء Google API لما يلي: اللغات. اختَر اللغة التي تريد استخدامها:
البدء
يمكنك الحصول على أحدث مكتبة لبرامج 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 API لنظام Node.js. راجِع دليل المطوّر الخاص بمكتبة البرامج.
Obj-C
يمكنك الحصول على أحدث مكتبة برامج لواجهة Google Chat API للغة Objective-C. راجِع دليل المطوّر الخاص بمكتبة البرامج.
PHP
يمكنك الحصول على أحدث مكتبة برامج لواجهة Google Chat API للغة PHP. راجِع دليل المطوّر الخاص بمكتبة البرامج.
Python
تضم هذه الصفحة معلومات حول بدء استخدام Google Chat API باستخدام مكتبة برامج Google API للغة بايثون. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:
- تصفَّح مرجع 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 المصادقة. على كل تتطلب طريقة Chat API أيًا مما يلي: مصادقة المستخدم (لتنفيذ الإجراءات أو الوصول البيانات نيابةً عن المستخدم) أو مصادقة التطبيقات (لتنفيذ الإجراءات أو الوصول إلى البيانات كتطبيق Chat) بعض الإشعارات مصادقة المستخدم ومصادقة التطبيقات.
لمزيد من المعلومات حول المصادقة في Chat، يُرجى الاطّلاع على نظرة عامة على المصادقة.