إذا كنت لا تستخدم مكتبة تم إنشاؤها، يمكنك تنزيل مكتبة برامج Google API للغة Java وتبعياتها في ملف ZIP، أو يمكنك استخدام Maven.
يمكنك أيضًا الاطّلاع على تعليمات إعداد ProGuard التي تُعد جزءًا من مكتبة عملاء HTTP من Google لمستندات Java.
تنزيل المكتبة التي تتضمن ملحقات
نزِّل أحدث ملف ZIP، الذي يمكنك العثور عليه في صفحة التنزيلات، ثم استخرِجه على جهاز الكمبيوتر. يحتوي ملف ZIP هذا على ملفات jar لفئة مكتبة العملاء وملفات jar المصدر المرتبطة لكل أداة وتبعياتها. يمكنك العثور على الرسوم البيانية والتراخيص للتبعية للمكتبات المختلفة في مجلد التبعيات. لمزيد من التفاصيل عن محتوى عملية التنزيل، يُرجى الاطّلاع على ملف readme.html.
Android
إذا كنت تطوِّر نظام التشغيل Android، وكانت Google API التي تريد استخدامها مضمّنة في مكتبة خدمات Google Play، يمكنك استخدام مكتبة "خدمات Google Play" للحصول على أفضل أداء وتجربة.
إذا كنت تستخدم مكتبة برامج Google API للغة Java على نظام التشغيل Android، من المهم معرفة التبعيات المتوافقة مع Android، وتحديدًا مستوى حزمة تطوير البرامج (SDK) لنظام التشغيل Android. تتطلب تطبيقات Android ملفات jar التالية، أو الإصدارات المتوافقة الأحدث، من مجلد 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
- gason-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.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
- gason-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.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
- gason-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
- commons-logging-1.2.jar
- gson-2.9.0.jar
- httpclient-4.5.13.jar
- httpcore-4.4.12.jar
- gason-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-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-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.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
تدعم إضافات 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.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-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.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>