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 dành cho Java và các phần phụ thuộc của thư viện đó xuống dưới dạng tệp 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 Thư viện ứng dụng Google HTTP dành cho Java.

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

Tải xuống tệp zip mới nhất mà bạn có thể tìm thấy trên trang tải xuống và giải nén tệp trên máy tính của bạn. 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 mỗi 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 các biểu đồ phần phụ thuộc và giấy phép của các thư viện khác nhau trong thư mục phần phụ thuộc. Để biết thêm chi tiết về nội dung 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 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. Các ứng dụng Android yêu cầu các tệp jar sau hoặc phiên bản tương thích mới hơn từ thư mục 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

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

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

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

Thư viện đã tạo cho Google API

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. Maven groupId cho tất cả cấu phần phần mềm của thư viện này là com.google.api-client. Hướng dẫn cụ thể về 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 Java cho API của Google (google-api-client) được thiết kế để tương thích với tất cả các nền tảng Java được hỗ trợ, bao gồm cả Android.

Mức sử dụng Maven:

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

Trên Android, bạn cần 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.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

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

Mức sử dụng Maven:

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

google-api-client-servlet

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

Mức sử dụng Maven:

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

google-api-client-appengine

Các tiện ích của Google App Engine vào 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.

Mức sử dụng Maven:

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

google-api-client-gson

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

Mức sử dụng Maven:

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

google-api-client-jackson2

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

Mức sử dụng Maven:

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

google-api-client-java6

Các phần mở rộng của Java 6 (và cao hơn) vào Thư viện ứng dụng API của Google cho Java (google-api-client-java6). Mô-đun này phụ thuộc vào google-api-client và google- OAuth-client-java6.

Mức sử dụng Maven:

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

google-api-client-protobuf

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

Mức sử dụng Maven:

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

google-api-client-xml

Các phần mở rộng XML vào Thư viện ứng dụng API của Google cho Java (google-api-client-xml). Mô-đun này phụ thuộc vào google-api-client và google-http-client-xml.

Mức sử dụng Maven:

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