คำแนะนำการตั้งค่า

หากไม่ได้ใช้ไลบรารีที่สร้างขึ้น คุณ สามารถดาวน์โหลดไลบรารีของไคลเอ็นต์ Google API สำหรับ Java และทรัพยากร Dependency ใน ZIP หรือใช้ Maven ได้

โปรดดูวิธีการตั้งค่า ProGuard ที่เป็นส่วนหนึ่งของเอกสารประกอบของ Google HTTP Client Library สำหรับ Java

ดาวน์โหลดไลบรารีที่มีทรัพยากร Dependency

ดาวน์โหลดไฟล์ ZIP ล่าสุดซึ่งดูได้ในหน้าดาวน์โหลด และแตกไฟล์ในคอมพิวเตอร์ ไฟล์ ZIP นี้ประกอบด้วยไฟล์ Jar ของคลาสไลบรารีของไคลเอ็นต์ และไฟล์ Jar ต้นทางที่เกี่ยวข้องสำหรับอาร์ติแฟกต์แต่ละรายการและทรัพยากร Dependency คุณสามารถดูกราฟทรัพยากร Dependency และใบอนุญาตสำหรับไลบรารีต่างๆ ได้ในโฟลเดอร์ทรัพยากร Dependency โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับเนื้อหาในการดาวน์โหลดได้ที่ไฟล์ readme.html

Android

หากคุณพัฒนาสำหรับ Android และ Google API ที่คุณต้องการใช้นั้นรวมอยู่ในไลบรารีบริการ Google Play โปรดใช้ไลบรารีบริการ Google Play เพื่อประสิทธิภาพและประสบการณ์การใช้งานที่ดีที่สุด

หากใช้ไลบรารีของไคลเอ็นต์ Google API สำหรับ Java กับ Android คุณควรทราบว่าทรัพยากร Dependency ใดใช้ได้กับ Android โดยเฉพาะ Android SDK ระดับใด แอปพลิเคชัน Android ต้องใช้ไฟล์ Jar ต่อไปนี้หรือเวอร์ชันที่เข้ากันได้ที่ใหม่กว่าจากโฟลเดอร์ 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

แอปพลิเคชัน Google App Engine ต้องใช้ไฟล์ jar ต่อไปนี้ หรือเวอร์ชันที่เข้ากันได้ที่ใหม่กว่าจากโฟลเดอร์ 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

บริการ

แอปพลิเคชันเซิร์ฟเวอร์ต้องการไฟล์ Jar ต่อไปนี้หรือเวอร์ชันที่เข้ากันได้ที่ใหม่กว่าจากโฟลเดอร์ 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 ทั่วไป

แอปพลิเคชัน Java สำหรับจุดประสงค์ทั่วไปต้องใช้ไฟล์ Jar ต่อไปนี้หรือเวอร์ชันที่เข้ากันได้ที่ใหม่กว่าจากโฟลเดอร์ 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

ไลบรารีที่สร้างขึ้นสำหรับ Google APIs

ที่เก็บของไลบรารีที่สร้างขึ้น มีคําแนะนําเกี่ยวกับวิธีใช้ API แต่ละเวอร์ชัน

Maven

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Java อยู่ในที่เก็บ Maven ส่วนกลาง groupIdของ Maven สำหรับอาร์ติแฟกต์ทั้งหมดของไลบรารีนี้คือ com.google.api-client โดยจะมีวิธีการที่เฉพาะเจาะจงสำหรับ Maven สำหรับแต่ละโมดูล (ด้านล่าง)

โมดูล

ไลบรารีนี้ประกอบด้วยโมดูลต่างๆ 9 โมดูล ดังนี้

google-api-client

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Java (google-api-client) ได้รับการออกแบบมาให้สามารถทำงานร่วมกับแพลตฟอร์ม Java ทั้งหมดที่มีการสนับสนุน รวมถึง Android ด้วย

การใช้งาน Maven:

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

ใน Android คุณจะต้องยกเว้นทรัพยากร Dependency ที่ไม่ได้ใช้อย่างชัดเจน

<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

ส่วนขยายไปยังไลบรารีของไคลเอ็นต์ Google API สำหรับ Java (google-api-client-android) สนับสนุน Java Google Android (สำหรับแอปพลิเคชัน SDK >= 2.1) เท่านั้น โมดูลนี้ขึ้นอยู่กับ google-api-client และ google-http-client-android

การใช้งาน Maven:

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

google-api-client-servlet

ส่วนขยาย Servlet และ JDO ไปยังไลบรารีของไคลเอ็นต์ Google API for Java (google-api-client-servlet) จะรองรับเว็บแอปพลิเคชันเซิร์ฟเล็ต Java โมดูลนี้ขึ้นอยู่กับ google-api-client และ google-oauth-client-servlet

การใช้งาน Maven:

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

google-api-client-appengine

ส่วนขยายของ Google App Engine ไปยังไลบรารีของไคลเอ็นต์ Google API สำหรับ Java (google-api-client-appengine) รองรับแอปพลิเคชัน Java Google App Engine โมดูลนี้ขึ้นอยู่กับ google-api-client, google-api-client-servlet, google-oauth-client-appengine และ google-http-client-appengine

การใช้งาน Maven:

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

google-api-client-gson

ส่วนขยาย GSON ไปยังไลบรารีของไคลเอ็นต์ Google API สำหรับ Java (google-api-client-gson) โมดูลนี้ขึ้นอยู่กับ google-api-client และ google-http-client-gson

การใช้งาน Maven:

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

google-api-client-jackson2

ส่วนขยาย Jackson2 ไปยังไลบรารีของไคลเอ็นต์ Google API สำหรับ Java (google-api-client-jackson2) โมดูลนี้ขึ้นอยู่กับ google-api-client และ google-http-client-jackson2

การใช้งาน Maven:

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

google-api-client-protobuf

บัฟเฟอร์โปรโตคอล ไปยังไลบรารีของไคลเอ็นต์ Google API สำหรับ Java (google-api-client-protobuf) โมดูลนี้ขึ้นอยู่กับ google-http-client-protobuf และ google-api-client

การใช้งาน Maven:

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

google-api-client-xml

ส่วนขยาย XML ไปยังไลบรารีของไคลเอ็นต์ Google API สำหรับ Java (google-api-client-xml) โมดูลนี้ขึ้นอยู่กับ google-api-client และ google-http-client-xml

การใช้งาน Maven:

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