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

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

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

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

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

Android

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

إذا كنت تستخدم مكتبة Google API Client Library للغة 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

تحذير: بالنسبة إلى نظام التشغيل Android، يجب وضع ملفات ‎ .jar في دليل باسم "libs" حتى يتمكّن برنامج حزم APK من العثور عليها. بخلاف ذلك، سيظهر لك خطأ NoClassDefFoundError في وقت التشغيل.

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
• 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

تتطلّب تطبيقات 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
• 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.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
• jackson-core-2.13.3.jar
• jsr305-3.0.2.jar
• protobuf-java-3.21.4.jar
• xpp3-1.1.4c.jar

المكتبات التي تم إنشاؤها لواجهات برمجة تطبيقات Google

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

Maven

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

الوحدات

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

• google-api-client
• google-api-client-android
• google-api-client-appengine
• google-api-client-servlet
• google-api-client-gson
• google-api-client-jackson2
• google-api-client-protobuf
• google-api-client-xml

عميل واجهة برمجة تطبيقات Google

تم تصميم مكتبة برامج 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 للغة Java‏ (google-api-client-android) دعمًا لتطبيقات Java Google Android (لنظام التشغيل 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 للغة Java (google-api-client-servlet) مع تطبيقات ويب Servlet من Java. تعتمد هذه الوحدة على 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 للغة 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 للغة 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

إضافات تنسيق Protocol Buffer إلى مكتبة عميل 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>