設定の手順

Java 用 Google OAuth クライアント ライブラリとその依存関係を zip ファイルでダウンロードするか、Maven を使用できます。

また、Java 用 Google HTTP クライアント ライブラリのドキュメントにある ProGuard のセットアップ手順もご覧ください。

依存関係を含むライブラリをダウンロードする

最新の zip ファイル(ダウンロード ページ)をダウンロードして、パソコンに展開します。この ZIP ファイルには、クライアント ライブラリのクラスの JAR ファイルと、各アーティファクトとその依存関係に関連するソースの JAR ファイルが含まれています。さまざまなライブラリの依存関係グラフとライセンスは、 dependencies フォルダにあります。ダウンロードの内容の詳細については、readme.html ファイルをご覧ください。

Android

Android 向けの開発を行っており、使用する Google API が Google Play 開発者サービス ライブラリに含まれている場合は、Google Play 開発者サービス ライブラリを使用すると、最適なパフォーマンスとエクスペリエンスを実現できます。

Android で Java 用 Google OAuth クライアント ライブラリを使用する場合は、どの依存関係が Android と互換性があるか、特に Android SDK レベルを把握することが重要です。Android アプリでは、libs フォルダに次の jar ファイル、または互換性のある新しいバージョンが必要です。

  • google-oauth-client-1.30.4.jar
  • google-http-client-1.32.1.jar
  • google-http-client-android-1.32.1jar
  • gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar

Google Apps Engine

Google App Engine アプリケーションでは、libs フォルダに次の jar ファイル、またはそれより新しい互換性のあるバージョンが必要です。

  • google-oauth-client-1.30.4.jar
  • google-oauth-client-appengine-1.30.4.jar
  • google-oauth-client-servlet-1.30.4.jar
  • google-http-client-1.32.1.jar
  • google-http-client-appengine-1.32.1.jar
  • gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

サーブレット

サーブレット アプリケーションには、libs フォルダに次の jar ファイル、または新しい互換性のあるバージョンが必要です。

  • google-oauth-client-1.30.4.jar
  • google-oauth-client-servlet-1.32.1.jar
  • google-http-client-1.32.1.jar
  • commons-logging-1.2.0.jar
  • gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • httpclient-4.5.9.jar
  • httpcore-4.4.11.jar
  • jackson-core-2.1.3.jar
  • jdo2-api-2.3-eb.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar
  • transaction-api-1.1.jar
  • xpp3-1.1.4c.jar

汎用 Java

汎用 Java アプリケーションでは、libs フォルダに次の jar ファイル、または新しい互換性のあるバージョンが必要です。

  • google-oauth-client-1.30.4.jar
  • google-http-client-1.32.1.jar
  • commons-logging-1.2.0.jar
  • gson-2.8.5.jar
  • jackson-core-2.9.5.jar
  • httpclient-4.5.9.jar
  • httpcore-4.4.11.jar
  • jsr305-3.0.2.jar
  • protobuf-java-3.6.1.jar
  • xpp3-1.1.4c.jar

Maven

Java 用の Google OAuth クライアント ライブラリは、中央の Maven リポジトリにあります。このライブラリのすべてのアーティファクトの Maven groupIdcom.google.oauth-client です。各モジュールの詳細については、Maven の具体的な手順を参照してください(下記)。

モジュール

このライブラリは、次の 5 つのモジュールで構成されています。

google-oauth-client

Java 用 Google OAuth クライアント ライブラリ(google-oauth-client)は、Android を含む、サポートされているすべての Java プラットフォームと互換性を持つように設計されています。

Maven の使用方法:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client</artifactId>
  <version>1.30.4</version>
</dependency>

Android では、未使用の依存関係を明示的に除外する必要があります。

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client</artifactId>
  <version>1.30.4</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-oauth-client-servlet

Java 用 Google OAuth クライアント ライブラリ(google-oauth-client-サーブレット)のサーブレットと WebView の拡張機能は、Java サーブレット ウェブ アプリケーションをサポートしています。このモジュールは google-oauth-client に依存します。

Maven の使用方法:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-servlet</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-appengine

Java 用 Google OAuth クライアント ライブラリの Google App Engine 拡張機能(google-oauth-client-appengine)は、Java Google App Engine アプリケーションをサポートしています。このモジュールは google-oauth-client と google-oauth-client-サーブレットを使用します。

Maven の使用方法:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-appengine</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-java6

Java 用 Google OAuth クライアント ライブラリの Java 6(およびそれ以降)拡張機能(google-oauth-client-java6)は、Java6+ アプリケーションをサポートしています。このモジュールは google-oauth-client に依存しています。

Maven の使用方法:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-java6</artifactId>
  <version>1.30.4</version>
</dependency>

google-oauth-client-jetty

Java 用 Google OAuth クライアント ライブラリ(google-oauth-client-jetty)の Jetty 拡張機能は、インストール済みアプリケーションの認可コードフローをサポートします。このモジュールは google-oauth-client-java6 に依存しています。

Maven の使用方法:

<dependency>
  <groupId>com.google.oauth-client</groupId>
  <artifactId>google-oauth-client-jetty</artifactId>
  <version>1.30.4</version>
</dependency>