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

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

اطلع أيضًا على تعليمات إعداد ProGuard التي تكون جزءًا من مكتبة برامج Google HTTP لوثائق جافا.

تنزيل المكتبة التي تحتوي على التبعيات

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

Android

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

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

  • google-api-client-2.0.0.jar
  • google-api-client-android-2.0.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
  • jackson-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.0.0.jar
  • google-api-client-appengine-2.0.0.jar
  • google-api-client-servlet-2.0.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
  • jackson-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.0.0.jar
  • google-api-client-servlet-2.0.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
  • jackson-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 للأغراض العامة ملفات jar التالية، أو الإصدارات المتوافقة الأحدث، من مجلد libs:

  • google-api-client-2.0.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
  • jackson-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.0.0</version>
</dependency>

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

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.0.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.0.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.0.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.0.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.0.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.0.0</version>
</dependency>

google-api-client-java6

إضافات Java 6 (والإصدارات الأعلى) بمكتبة برامج Google API للغة Java (google-api-client-java6). تعتمد هذه الوحدة على google-api-client وgoogle-oauth-client-java6.

استخدام Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-java6</artifactId>
  <version>2.0.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.0.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.0.0</version>
</dependency>