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

إذا كنت لا تريد كتابة الرمز البرمجي الخاص بك لإرسال طلبات HTTP وتحليل الاستجابات، عليك تنزيل مكتبة العميل.

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

إذا كنت تريد استخدام لغة غير معروضة أدناه، يمكنك الرجوع إلى مستندات مكتبة العميل لمعرفة ما إذا كانت هناك مكتبة للغتك.

ملاحظة: تتمثل إحدى المهام الرئيسية لمكتبات العملاء في التحويل بين ملف JSON والعناصر المضمّنة. في مكتبة Java، يتم ذلك من خلال مجموعة من الفئات التي يوفّرها ملف JAR. في Python، يتم تحويل تنسيق JSON مباشرةً إلى قاموس أو تجزئة.

Java

يتطلّب استخدام مكتبة برامج Google APIs للغة Java تنزيل مكتبة Java الأساسية ومكتبة Java لـ Google Drive Activity API.

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

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

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

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

Maven

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

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

Gradle

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

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

Python

يتطلّب استخدام مكتبة عملاء Google APIs للغة Python تنزيل مصدر Python وتثبيته.

تحتوي هذه الصفحة على معلومات حول بدء استخدام Drive Activity API من خلال مكتبة برمجة التطبيقات Google API لإصدار Python (الإصدار 1 أو الإصدار 2). لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:

• تصفَّح مرجع PyDoc حول Drive Activity API.
• اطّلِع على دليل المطوّر لمكتبة برامج Google API للغة Python (v1/v2).
• يمكنك التفاعل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام أداة "مستكشف واجهات برمجة التطبيقات" الخاصة بواجهة برمجة التطبيقات Drive Activity API.

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

• أنظمة التشغيل:
  • Linux
  • Mac OS X
  • Windows
• تتطلّب مكتبة البرامج v1 توفّر الإصدار 2.7 أو الإصدارات اللاحقة من نظام Python. أما مكتبة البرامج v2، فتتطلّب توفّر الإصدار 3.7 أو الإصدارات اللاحقة.

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

يمكنك استخدام أداة إدارة الحِزم أو تنزيل مكتبة برامج 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، عليك نسخها إلى تطبيقك كما هي الحال مع مكتبات الجهات الخارجية.

لإجراء ذلك، شغِّل الأوامر التالية:

$ hg clone https://google-api-python-client.googlecode.com/hg/ google-api-python-client
$ cd google-api-python-client
$ sudo python setup.py install

يمكنك الآن استيراد الفئات التي تحتاج إليها باستخدام العبارات التالية:

from apiclient.discovery import build
from apiclient.oauth import OAuthCredentials

import httplib2
import oauth2 as oauth

PHP

يتطلّب استخدام مكتبة برامج Google APIs للغة PHP تنزيل مصدر PHP وتثبيته.

لإجراء ذلك، شغِّل الأوامر التالية:

$ svn checkout http://google-api-php-client.googlecode.com/svn/trunk/ google-api-php-client-read-only
$ cd google-api-php-read-only
$ # Copy the src directory to your working directory.

يمكنك الآن استيراد الفئات التي تحتاج إليها باستخدام العبارات التالية:

require_once "../src/apiClient.php";

NET.

يتطلّب استخدام مكتبة برامج Google API لنظام ‎ .NET تنزيل مكتبة برامج ‎ .NET الأساسية ومكتبة ‎ .NET لـ Google Drive Activity API. نزِّل الملفات وأضِفها كمرجع إلى مشروعك:

• مكتبة العميل الأساسية
• مكتبة Google Drive Activity API

يمكنك الآن استيراد الفئات التي تحتاج إليها باستخدام العبارات التالية:

using Google.Apis.Authentication;
using Google.Apis.Authentication.OAuth2;