إذا كنت لا تستخدم مكتبة تم إنشاؤها، يمكنك تنزيل "مكتبة عملاء 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-client
- google-api-client-android
- google-api-client-app Engine
- google-api-client-servlet
- google-api-client-gson
- google-api-client- Jackson2
- google-api-client-java6
- google-api-client-protobuf
- google-api-client-xml
عميل 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>