تعليمات الإعداد

إذا كنت لا تستخدم مكتبة تم إنشاؤها، يمكنك تنزيل مكتبة برامج Google API للغة Java وتبعياتها في ملف ZIP، أو يمكنك استخدام Maven.

يمكنك أيضًا الاطّلاع على تعليمات إعداد ProGuard التي تُعد جزءًا من مكتبة عملاء HTTP من Google لمستندات Java.

تنزيل المكتبة التي تتضمن ملحقات

نزِّل أحدث ملف ZIP، الذي يمكنك العثور عليه في صفحة التنزيلات، ثم استخرِجه على جهاز الكمبيوتر. يحتوي ملف ZIP هذا على ملفات jar لفئة مكتبة العملاء وملفات jar المصدر المرتبطة لكل أداة وتبعياتها. يمكنك العثور على الرسوم البيانية والتراخيص للتبعية للمكتبات المختلفة في مجلد التبعيات. لمزيد من التفاصيل عن محتوى عملية التنزيل، يُرجى الاطّلاع على ملف readme.html.

Android

إذا كنت تطوِّر نظام التشغيل Android، وكانت Google API التي تريد استخدامها مضمّنة في مكتبة خدمات Google Play، يمكنك استخدام مكتبة "خدمات Google Play" للحصول على أفضل أداء وتجربة.

إذا كنت تستخدم مكتبة برامج Google API للغة Java على نظام التشغيل Android، من المهم معرفة التبعيات المتوافقة مع Android، وتحديدًا مستوى حزمة تطوير البرامج (SDK) لنظام التشغيل Android. تتطلب تطبيقات Android ملفات jar التالية، أو الإصدارات المتوافقة الأحدث، من مجلد libs:

  • google-api-client-2.4.0.jar
  • google-api-client-android-2.4.0.jar
  • google-oauth-client-1.34.1.jar
  • google-http-client-1.42.2.jar
  • google-http-client-android-1.42.2.jar
  • gson-2.9.0.jar
  • gason-core-2.13.3.jar
  • jsr305-3.0.2.jar
  • Protobuf-java-3.21.4.jar

Google App Engine

تتطلب تطبيقات Google App Engine ملفات jar التالية، أو الإصدارات المتوافقة الأحدث، من مجلد libs:

  • google-api-client-2.4.0.jar
  • google-api-client-appengine-2.4.0.jar
  • google-api-client-servlet-2.4.0.jar
  • google-oauth-client-1.34.1.jar
  • google-oauth-client-appengine-1.34.1.jar
  • google-oauth-client-servlet-1.34.1.jar
  • google-http-client-1.42.2.jar
  • google-http-client-appengine-1.39.2.jar
  • gson-2.9.0.jar
  • gason-core-2.13.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • Protobuf-java-3.21.4.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

سيرفليت

تتطلب تطبيقات Servlet ملفات jar التالية، أو الإصدارات المتوافقة الأحدث، من مجلد libs:

  • google-api-client-2.4.0.jar
  • google-api-client-servlet-2.4.0.jar
  • google-oauth-client-1.34.1.jar
  • google-oauth-client-servlet-1.34.1.jar
  • google-http-client-1.42.2.jar
  • commons-logging-1.2.jar
  • gson-2.9.0.jar
  • httpclient-4.5.13.jar
  • httpcore-4.4.12.jar
  • gason-core-2.13.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • Protobuf-java-3.21.4.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

لغة Java عامة

تتطلب تطبيقات Java للأغراض العامة ملفات الجار التالية، أو الإصدارات المتوافقة الأحدث، من مجلد libs:

  • google-api-client-2.4.0.jar
  • google-oauth-client-1.34.1.jar
  • google-http-client-1.42.2.jar
  • google-http-client-jackson2-1.39.2.jar
  • commons-logging-1.2.jar
  • gson-2.9.0.jar
  • httpclient-4.5.13.jar
  • httpcore-4.4.12.jar
  • gason-core-2.13.3.jar
  • jsr305-3.0.2.jar
  • Protobuf-java-3.21.4.jar
  • xpp3-1.1.4c.jar

المكتبات التي تم إنشاؤها لـ Google APIs

يتضمن مستودع المكتبات التي تم إنشاؤها تعليمات حول كيفية استخدام كل إصدار من إصدارات واجهات برمجة التطبيقات.

Maven

تتوفر مكتبة برامج Google API للغة Java في مستودع Maven المركزي. قيمة groupId Maven لجميع العناصر في هذه المكتبة هي com.google.api-client. تتوفر تعليمات محددة من Maven لكل وحدة (أدناه).

الوحدات

وتتألف هذه المكتبة من تسع وحدات:

google-api-client

تم تصميم مكتبة برامج Google API للغة Java (google-api-client) لتكون متوافقة مع جميع الأنظمة الأساسية المتوافقة مع Java، بما في ذلك Android.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.4.0</version>
</dependency>

على Android، يجب استبعاد التبعيات غير المستخدمة بشكل صريح:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.4.0</version>
  <exclusions>
    <exclusion>
      <artifactId>xpp3</artifactId>
      <groupId>xpp3</groupId>
    </exclusion>
    <exclusion>
      <artifactId>httpclient</artifactId>
      <groupId>org.apache.httpcomponents</groupId>
    </exclusion>
    <exclusion>
      <artifactId>junit</artifactId>
      <groupId>junit</groupId>
    </exclusion>
    <exclusion>
      <artifactId>android</artifactId>
      <groupId>com.google.android</groupId>
    </exclusion>
  </exclusions>
</dependency>

google-api-client-android

الإضافات لمكتبة برامج Google API لنظام Java (google-api-client-android) تتوافق مع تطبيقات Java Google Android (فقط لحزمة SDK >= 2.1). تعتمد هذه الوحدة على google-api-client وgoogle-http-client-android.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-android</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-servlet

تدعم إضافات Servlet وJDO إلى مكتبة عملاء Google API للغة Java (google-api-client-servlet) تطبيقات الويب Java servlet. تعتمد هذه الوحدة على google-api-client وgoogle-oauth-client-servlet.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-servlet</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-appengine

تتوافق إضافات Google App Engine إلى مكتبة عملاء Google API لـ Java (google-api-client-appengine) بتطبيقات Java لـ Google App Engine. تعتمد هذه الوحدة على google-api-client وgoogle-api-client-servlet وgoogle-oauth-client-appengine وgoogle-http-client-appengine.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-appengine</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-gson

إضافات GSON لمكتبة برامج Google API للغة Java (google-api-client-gson). تعتمد هذه الوحدة على google-api-client وgoogle-http-client-gson.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-gson</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-jackson2

إضافات Jackson2 إلى مكتبة برامج Google API للغة Java (google-api-client-jackson2). تعتمد هذه الوحدة على google-api-client وgoogle-http-client-jackson2.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-jackson2</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-protobuf

إضافات المخزن المؤقت للبروتوكولات إلى مكتبة عميل واجهة Google API للغة Java (google-api-client-protobuf). تعتمد هذه الوحدة على google-http-client-protobuf وgoogle-api-client.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-protobuf</artifactId>
  <version>2.4.0</version>
</dependency>

google-api-client-xml

إضافات XML إلى مكتبة برامج Google API للغة Java (google-api-client-xml). تعتمد هذه الوحدة على google-api-client وgoogle-http-client-xml.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-xml</artifactId>
  <version>2.4.0</version>
</dependency>