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

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

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

تنزيل المكتبة التي تتضمن عناصر تابعة

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

Android

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

إذا كنت تستخدم مكتبة برامج Google API للغة Java مع نظام التشغيل Android، من المهم معرفة الاعتماديات المتوافقة مع Android، وتحديدًا مستوى حزمة تطوير البرامج (SDK) لنظام التشغيل Android. تتطلّب تطبيقات Android توفُّر ملفات الجرة التالية أو الإصدارات المتوافقة الأحدث من مجلد 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
  • jackson-core-2.13.3.jar
  • jsr305-3.0.2.jar
  • Protobuf-java-3.21.4.jar

Google App Engine

تتطلب تطبيقات Google App Engine ملفات البرك التالية أو الإصدارات المتوافقة الأحدث من مجلد 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
  • 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

سرليت

تتطلب تطبيقات 5s-ملفات الجرف التالية - أو الإصدارات المتوافقة الأحدث - من مجلد 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
  • Shared-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 للأغراض العامة ملفات المخزون التالية أو الإصدارات المتوافقة الأحدث من مجلد 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
  • Shared-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) لتكون متوافقة مع جميع أنظمة 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

إن إضافات Servicelet وJDO في مكتبة برامج Google API لـ Java (google-api-client-serlet) تتيح استخدام تطبيقات الويب Java serlet. تعتمد هذه الوحدة على google-api-client وgoogle-oauth-client-serlet.

استخدام 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-servicelet و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>