Petunjuk Penyiapan

Jika tidak menggunakan library yang dihasilkan, Anda dapat mendownload Library Klien Google API untuk Java dan dependensinya dalam file zip, atau Anda dapat menggunakan Maven.

Lihat juga petunjuk penyiapan ProGuard yang merupakan bagian dari dokumentasi Library Klien HTTP Google untuk Java.

Mendownload library dengan dependensi

Download file zip terbaru, yang dapat Anda temukan di halaman download, lalu ekstrak di komputer. File ZIP ini berisi file jar class library klien dan file jar sumber terkait untuk setiap artefak dan dependensinya. Anda dapat menemukan lisensi dan grafik dependensi untuk berbagai library dalam folder dependensi. Untuk detail selengkapnya tentang konten download, lihat file readme.html.

Android

Jika Anda mengembangkan aplikasi untuk Android, dan Google API yang ingin Anda gunakan disertakan dalam library Layanan Google Play, gunakan library Layanan Google Play untuk mendapatkan performa dan pengalaman terbaik.

Jika Anda menggunakan Library Klien Google API untuk Java dengan Android, penting untuk mengetahui dependensi mana yang kompatibel dengan Android, khususnya level Android SDK. Aplikasi Android memerlukan file jar berikut, atau versi kompatibel yang lebih baru, dari folder 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

Aplikasi Google App Engine memerlukan file jar berikut, atau versi kompatibel yang lebih baru, dari folder libs:

  • google-api-client-2.0.0.jar
  • google-api-client-appengine-2.0.0.jar
  • google-api-client-servlet-2.0.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

Servlet

Aplikasi servlet memerlukan file jar berikut, atau versi kompatibel yang lebih baru, dari folder 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
  • 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 Generik

Aplikasi Java tujuan umum memerlukan file jar berikut, atau versi kompatibel yang lebih baru, dari folder 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
  • 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

Library yang dihasilkan untuk Google API

Repositori library yang dihasilkan memiliki petunjuk tentang cara menggunakan setiap versi API.

Maven

Library Klien Google API untuk Java ada di repositori Maven pusat. groupId Maven untuk semua artefak untuk library ini adalah com.google.api-client. Instruksi Maven spesifik diberikan untuk setiap modul (di bawah).

Modul

Library ini terdiri dari sembilan modul:

google-api-client

Library Klien Google API untuk Java (google-api-client) dirancang agar kompatibel dengan semua platform Java yang didukung, termasuk Android.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client</artifactId>
  <version>2.0.0</version>
</dependency>

Di Android, Anda perlu mengecualikan dependensi yang tidak digunakan secara eksplisit:

<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

Ekstensi ke Library Klien Google API untuk Java (google-api-client-android) mendukung aplikasi Java Google Android (hanya untuk SDK >= 2.1). Modul ini bergantung pada google-api-client dan google-http-client-android.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-android</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-servlet

Ekstensi Servlet dan JDO ke Library Klien Google API untuk Java (google-api-client-servlet) mendukung aplikasi web servlet Java. Modul ini bergantung pada google-api-client dan google-oauth-client-servlet.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-servlet</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-appengine

Ekstensi Google App Engine ke Library Klien Google API untuk Java (google-api-client-appengine) mendukung aplikasi Google App Engine Java. Modul ini bergantung pada google-api-client, google-api-client-servlet, google-oauth-client-appengine, dan google-http-client-appengine.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-appengine</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-gson

Ekstensi GSON ke Library Klien Google API untuk Java (google-api-client-gson). Modul ini bergantung pada google-api-client dan google-http-client-gson.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-gson</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-jackson2

Ekstensi Jackson2 ke Library Klien Google API untuk Java (google-api-client-jackson2). Modul ini bergantung pada google-api-client dan google-http-client-jackson2.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-jackson2</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-java6

Ekstensi Java 6 (dan yang lebih tinggi) ke Library Klien Google API untuk Java (google-api-client-java6). Modul ini bergantung pada google-api-client dan google-oauth-client-java6.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-java6</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-protobuf

Ekstensi Buffering protokol ke Library Klien Google API untuk Java (google-api-client-protobuf). Modul ini bergantung pada google-http-client-protobuf dan google-api-client.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-protobuf</artifactId>
  <version>2.0.0</version>
</dependency>

google-api-client-xml

Ekstensi XML ke Library Klien Google API untuk Java (google-api-client-xml). Modul ini bergantung pada google-api-client dan google-http-client-xml.

Penggunaan Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-xml</artifactId>
  <version>2.0.0</version>
</dependency>