Инструкции по установке

Если вы не используете сгенерированную библиотеку , вы можете загрузить клиентскую библиотеку API Google для Java и ее зависимости в zip-файле или использовать Maven.

Также ознакомьтесь с инструкциями по установке ProGuard , которые входят в документацию по клиентской библиотеке Google HTTP для Java.

Загрузите библиотеку с зависимостями

Загрузите последнюю версию zip-файла, который вы можете найти на странице загрузок , и распакуйте его на свой компьютер. Этот zip-файл содержит jar-файлы классов клиентской библиотеки и связанные с ними исходные jar-файлы для каждого артефакта и его зависимостей. Вы можете найти графики зависимостей и лицензии для различных библиотек в папке зависимостей. Более подробную информацию о содержимом загрузки см. в файле readme.html.

Андроид

Если вы разрабатываете приложение для Android и API Google, который вы хотите использовать, включен в библиотеку Сервисов Google Play , используйте библиотеку Сервисов Google Play для обеспечения максимальной производительности и удобства работы.

Если вы используете клиентскую библиотеку Google API для Java с Android, важно знать, какие зависимости совместимы с Android, в частности, какой уровень Android SDK. Приложениям 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
  • Джексон-ядро-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
  • Джексон-ядро-2.13.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.21.4.jar
  • транзакция-api-1.1.jar
  • xpp3-1.1.4c.jar

Сервлет

Приложениям сервлетов требуются следующие файлы 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
  • Джексон-ядро-2.13.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.21.4.jar
  • транзакция-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
  • Джексон-ядро-2.13.3.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.21.4.jar
  • xpp3-1.1.4c.jar

Сгенерированные библиотеки для Google API

В репозитории сгенерированных библиотек есть инструкции по использованию каждой версии API.

Мавен

Клиентская библиотека Google API для Java находится в центральном репозитории Maven . groupId Maven для всех артефактов этой библиотеки — 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.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-клиент-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-клиент-сервлет

Расширения сервлетов и JDO клиентской библиотеки Google API для Java (google-api-client-servlet) поддерживают веб-приложения сервлетов Java. Этот модуль зависит от 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-клиент-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-клиент-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-клиент-protobuf

Расширения буфера протокола для клиентской библиотеки API Google для 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-клиент-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>