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

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

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

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

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

Android

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

หากคุณใช้ไลบรารีของไคลเอ็นต์ 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

บริการ

แอปพลิเคชัน Servlet ต้องใช้ไฟล์ 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 API

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

Maven

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Java อยู่ใน Maven Repository กลาง 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) support 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 สำหรับ Java (google-api-client-servlet) รองรับเว็บแอปพลิเคชัน 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

ส่วนขยาย Protocol Buffer สำหรับไลบรารีของไคลเอ็นต์ 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>