Petunjuk Penyiapan

Jika tidak menggunakan library yang dibuat, 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 Library Klien HTTP Google untuk dokumentasi Java.

Mendownload library dengan dependensi

Download file zip terbaru, yang dapat Anda temukan di halaman download, dan ekstrak di komputer Anda. 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 di 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 tingkat Android SDK mana. Aplikasi Android memerlukan file jar berikut, atau versi yang lebih baru dan kompatibel, 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

Peringatan: Untuk Android, Anda harus menempatkan file .jar di direktori bernama "libs" agar packager APK dapat menemukannya. Jika tidak, Anda akan mendapatkan error NoClassDefFoundError saat runtime.

Google App Engine

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

• google-api-client-2.0.0.jar
• google-api-client-appengine-2.0.0.jar
• google-api-klien-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 yang lebih baru dan kompatibel, dari folder libs:

• google-api-client-2.0.0.jar
• google-api-klien-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 yang lebih baru dan kompatibel, 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. Petunjuk Maven tertentu diberikan untuk setiap modul (di bawah).

Modul

Library ini terdiri dari sembilan modul:

• klien-api-api
• google-api-klien-android
• google-api-client-appengine
• servis google-api-klien-
• Google-api-klien-gson
• google-api-klien-jackson2
• google-api-client-java6
• Google-api-klien-protobuf
• google-api-klien-xml

google-api-klien

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 secara eksplisit mengecualikan dependensi yang tidak digunakan:

<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-klien-android

Ekstensi untuk Library Klien Google API untuk Java (google-api-client-android) mendukung aplikasi Google Android Java (hanya untuk aplikasi 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>

layanan klien-google-api

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-klien-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-klien-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-klien-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-klien-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-klien-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-klien-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>