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

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

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

تنزيل المكتبة باستخدام المهام التابعة

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

Android

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

إذا كنت تستخدم "مكتبة برامج Google API" للغة Java مع Android، من المهم معرفة الارتباطات التابعة المتوافقة مع Android، وتحديدًا مستوى "حزمة تطوير البرامج" (SDK) لنظام التشغيل Android. تتطلب تطبيقات 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-app Engine-2.0.0.jar
  • google-api-client-servlet-2.0.0.jar
  • google-oauth-client-1.34.1.jar
  • google-oauth-client-app Engine-1.34.1.jar
  • google-oauth-client-servlet-1.34.1.jar
  • google-http-client-1.42.2.jar
  • google-http-client-app Engine-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
  • Common-logging-1.2.jar
  • gson-2.9.0.jar
  • http://client.4.5.13.jar
  • http://-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
  • Common-logging-1.2.jar
  • gson-2.9.0.jar
  • http://client.4.5.13.jar
  • http://-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

تم تصميم مكتبة برامج "واجهة 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) تتوافق مع تطبيقات Google 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-app Engine

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

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