Hướng dẫn thiết lập

Nếu không dùng thư viện đã tạo, bạn có thể tải Thư viện ứng dụng API của Google cho Java xuống và các phần phụ thuộc của thư viện này trong một zip hoặc bạn có thể dùng Maven.

Ngoài ra, hãy xem hướng dẫn thiết lập ProGuard trong tài liệu về Thư viện ứng dụng HTTP của Google dành cho Java.

Tải thư viện có phần phụ thuộc xuống

Tải tệp zip mới nhất xuống mà bạn có thể tìm thấy trên trang tải xuống rồi giải nén trên máy tính. Tệp zip này chứa các tệp jar của lớp thư viện ứng dụng và các tệp jar nguồn được liên kết cho từng cấu phần phần mềm và các phần phụ thuộc của cấu phần phần mềm đó. Bạn có thể tìm thấy biểu đồ và giấy phép phần phụ thuộc cho nhiều thư viện trong thư mục phần phụ thuộc. Để biết thêm chi tiết về nội dung của tệp tải xuống, hãy xem tệp readme.html.

Android

Nếu bạn đang phát triển cho Android và API Google mà bạn muốn sử dụng có trong thư viện Dịch vụ Google Play, hãy sử dụng thư viện Dịch vụ Google Play để có hiệu suất và trải nghiệm tốt nhất.

Nếu đang sử dụng Thư viện ứng dụng API của Google dành cho Java với Android, bạn cần phải biết phần phụ thuộc nào tương thích với Android, cụ thể là cấp SDK Android nào. Ứng dụng Android yêu cầu các tệp jar sau hoặc các phiên bản tương thích mới hơn, từ thư mục 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

Các ứng dụng Google App Engine yêu cầu các tệp jar sau hoặc các phiên bản tương thích mới hơn, từ thư mục 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

Servlet

Các ứng dụng Servlet yêu cầu các tệp jar sau hoặc các phiên bản tương thích mới hơn, từ thư mục 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 chung

Các ứng dụng Java thông thường yêu cầu các tệp jar sau hoặc các phiên bản tương thích mới hơn, từ thư mục 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

Các thư viện đã tạo cho API của Google

Kho lưu trữ của các thư viện đã tạo có hướng dẫn về cách sử dụng từng phiên bản API.

Maven

Thư viện ứng dụng API của Google dành cho Java nằm trong kho lưu trữ Maven trung tâm. groupId của Maven cho tất cả cấu phần phần mềm của thư viện này là com.google.api-client. Các hướng dẫn cụ thể của Maven được cung cấp cho từng mô-đun (ở bên dưới).

Mô-đun

Thư viện này bao gồm 9 mô-đun:

google-api-client

Thư viện ứng dụng API của Google dành cho Java (google-api-client) được thiết kế để tương thích với tất cả nền tảng Java được hỗ trợ, bao gồm cả Android.

Cách sử dụng Maven:

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

Trên Android, bạn cần phải loại trừ một cách rõ ràng các phần phụ thuộc không dùng đến:

<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

Các tiện ích dành cho Thư viện ứng dụng API của Google dành cho Java (google-api-client-android) hỗ trợ ứng dụng Java Google Android (chỉ dành cho SDK >= 2.1). Mô-đun này phụ thuộc vào google-api-client và google-http-client-android.

Cách sử dụng Maven:

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

google-api-client-servlet

Các phần mở rộng Servlet và JDO cho Thư viện ứng dụng API của Google dành cho Java (google-api-client-servlet) hỗ trợ các ứng dụng web servlet Java. Mô-đun này phụ thuộc vào google-api-client và google-oauth-client-servlet.

Cách sử dụng Maven:

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

google-api-client-appengine

Các phần mở rộng của Google App Engine dành cho Thư viện ứng dụng API của Google dành cho Java (google-api-client-appengine) hỗ trợ các ứng dụng Java Google App Engine. Mô-đun này phụ thuộc vào google-api-client, google-api-client-servlet, google-oauth-client-appengine và google-http-client-appengine.

Cách sử dụng Maven:

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

google-api-client-gson

Các đuôi GSON cho Thư viện ứng dụng API của Google cho Java (google-api-client-gson). Mô-đun này phụ thuộc vào google-api-client và google-http-client-gson.

Cách sử dụng Maven:

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

google-api-client-jackson2

Các tiện ích Jackson2 dành cho Thư viện ứng dụng API của Google dành cho Java (google-api-client-jackson2). Mô-đun này phụ thuộc vào google-api-client và google-http-client-jackson2.

Cách sử dụng Maven:

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

google-api-client-protobuf

Vùng đệm giao thức các tiện ích mở rộng cho Thư viện ứng dụng API của Google dành cho Java (google-api-client-protobuf). Mô-đun này phụ thuộc vào google-http-client-protobuf và google-api-client.

Cách sử dụng Maven:

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

google-api-client-xml

Đuôi XML cho Thư viện ứng dụng API của Google dành cho Java (google-api-client-xml). Mô-đun này phụ thuộc vào google-api-client và google-http-client-xml.

Cách sử dụng Maven:

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