مكتبات عملاء واجهة Google Chat API

تعمل مكتبات العملاء على تحسين تجربة المطوّرين لطلب البيانات من 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

الاطّلاع على نماذج مكتبة برامج Cloud للحصول على Node.js.

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

• مستودع GitHub
• مرجع مكتبة عميل Cloud
• البدء بسرعة

Python

لتثبيت مكتبة البرامج:

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

الاطّلاع على نماذج مكتبة برامج Cloud للحصول على Python.

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

• مستودع GitHub
• مرجع مكتبة عميل Cloud
• البدء بسرعة

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"

الاطّلاع على نماذج مكتبة برامج Cloud للحصول على Java

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

• مستودع GitHub
• مرجع مكتبة عميل Cloud
• البدء بسرعة

البدء

يمكنك استيراد حزم Go لخدمات Google Cloud.

import "cloud.google.com/go"

لتثبيت الحزمة على النظام:

1. التغيير إلى دليل مشروعك: cd /my/cloud/project
2. احصل على الحزمة التي تريد استخدامها:

go get cloud.google.com/go/chat

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

• مستودع GitHub
• مرجع مكتبة عميل Cloud

Ruby

لتثبيت مكتبة البرامج:

gem install google-apps-chat

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

• مستودع GitHub
• مرجع مكتبة عميل Cloud

PHP

لتثبيت مكتبة البرامج:

1. إذا لزم الأمر، قم بتثبيت مدير التبعية الملحن:
2. من واجهة سطر الأوامر، شغِّل:

composer require google/apps-chat

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

• مستودع GitHub
• مرجع مكتبة عميل Cloud

NET.

لتثبيت مكتبة البرامج:

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

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

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

• مستودع GitHub
• مرجع مكتبة عميل Cloud

تثبيت مكتبات برامج 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) من بين علامات التبويب التالية:

Maven

أضِف ما يلي إلى ملف pom.xml:

راجِع جميع الإصدارات المتوفّرة في مستودع Maven المركزي.

Gradle

أضِف ما يلي إلى ملف build.gradle:

راجِع جميع الإصدارات المتوفّرة في مستودع Maven المركزي.

JavaScript

راجِع دليل المطوّر الخاص بمكتبة البرامج.

NET.

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

• تصفَّح المستندات المرجعية لنظام.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

التثبيت اليدوي

1. نزِّل مكتبة البرامج الأحدث للغة Python.
2. فُكَّ حزمة الرمز.
3. ثبِّت المكتبة:

   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، يُرجى الاطّلاع على نظرة عامة على المصادقة.