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

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

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

Скачайте библиотеку с зависимостями

Скачайте последнюю версию ZIP-файла со страницы скачивания и распакуйте его на компьютере. В этом ZIP-файле содержатся JAR-файлы классов клиентской библиотеки и связанные с ними JAR-файлы исходного кода для каждого артефакта и его зависимостей. Графики зависимостей и лицензии для разных библиотек можно найти в папке зависимостей. Подробные сведения о содержимом скачанного файла можно найти в файле readme.html.

Android

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

Если вы используете клиентскую библиотеку API Google для 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
  • 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.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

Сервлет

Для приложений сервлетов требуются следующие 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

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

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

Maven

Клиентская библиотека API Google для Java находится в центральном репозитории Maven. groupId Maven для всех артефактов этой библиотеки – com.google.api-client. Для каждого модуля ниже приведены отдельные инструкции по Maven.

Модули

Библиотека состоит из девяти модулей:

google-api-client

Клиентская библиотека API Google для 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

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

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

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