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

تم إنشاء واجهة برمجة تطبيقات "الأشخاص" استنادًا إلى HTTP وJSON، ما يتيح لأي عميل HTTP عادي إرسال طلبات إليه وتحليل الردود.

ولكن مكتبات عملاء واجهة Google API توفر لغة أفضل الدمج وتحسين الأمان على تقديم طلبات البيانات من واجهة برمجة التطبيقات عبر HTTP. تتوفر مكتبات العملاء في عدد من لغات البرمجة باستخدامها، يمكنك تجنب الحاجة إلى تحديد طلبات HTTP وتحليل الاستجابات.

للبدء، اختَر لغة البرمجة التي تستخدمها في التطوير.

البدء

يمكنك الحصول على أحدث مكتبة لبرامج People API للغة Go (الإصدار الأولي). راجِع دليل المطوّر الخاص بمكتبة البرامج.

Java

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

• تصفَّح مرجع JavaDoc حول People API.
• اطَّلِع على دليل المطوّر لمكتبة برامج Google API للغة Java.
• تفاعَل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام أداة "مستكشف واجهات برمجة التطبيقات" الخاصة بـ People API.

إضافة مكتبة البرامج إلى مشروعك

يمكنك اختيار بيئة الإصدار (Maven أو Gradle) من بين علامات التبويب التالية:

Maven

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

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

Gradle

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

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

JavaScript

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

NET.

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

• تصفَّح المستندات المرجعية لنظام.NET حول People API.
• اطَّلِع على دليل المطوّر لمكتبة برامج Google API لنظام ‎NET.
• تفاعَل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام أداة "مستكشف واجهات برمجة التطبيقات" الخاصة بـ People API.

تنزيل المكتبة

ثبِّت حزمة NuGet:‫ Google.Apis.

Node.js

يمكنك الحصول على أحدث مكتبة برامج خاصة بواجهة برمجة تطبيقات "الأشخاص" لنظام Node.js. راجِع دليل المطوّر الخاص بمكتبة البرامج.

Obj-C

يمكنك الحصول على أحدث مكتبة برامج لواجهة People API للغة Objective-C. راجِع دليل المطوّر الخاص بمكتبة البرامج.

PHP

يمكنك الحصول على أحدث مكتبة برامج لواجهة People API للغة PHP. راجِع دليل المطوّر الخاص بمكتبة البرامج.

Python

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

• تصفَّح مرجع PyDoc حول People API.
• اطَّلِع على دليل المطوّر لمكتبة برامج Google API للغة Python.
• تفاعَل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام أداة "مستكشف واجهات برمجة التطبيقات" الخاصة بـ People API.

متطلبات النظام

• أنظمة التشغيل:
  • 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

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

• اطَّلِع على دليل البدء لمكتبة برامج Google API للغة Ruby.
• تفاعَل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام أداة "مستكشف واجهات برمجة التطبيقات" الخاصة بـ People API.

تنزيل أداة google-api-client

وفقًا للنظام الذي تستخدمه، قد تحتاج إلى إضافة هذه الأوامر من خلال sudo.

إذا لم يسبق لك تثبيت مكتبة برامج Google API للغة Ruby، ثبِّتها باستخدام RubyGems:

gem install google-api-client

إذا سبق لك تثبيت الأداة، يمكن تحديثها إلى أحدث إصدار:

gem update -y google-api-client

بدء استخدام مكتبة برامج Google API للغة Ruby

للاطّلاع على كيفية تقديم طلبك الأول، راجِع دليل البدء.

طرق أخرى للوصول إلى People API

يسرد الجدول التالي طرقًا أخرى للوصول إلى People API:

طريقة الدخول	الوصف
مستكشف واجهات برمجة التطبيقات	أداة تفاعلية تتيح لك تجربة Google APIs من متصفّحك مباشرةً.
برمجة التطبيقات	لغة برمجة نصية تستند إلى JavaScript على السحابة الإلكترونية لتنفيذ المهام بشكل آلي في منتجات Google والخدمات التابعة لجهات خارجية.