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

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

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

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

ดาวน์โหลดไฟล์ ZIP ล่าสุด ซึ่งดูได้ในหน้าดาวน์โหลด และแตกไฟล์ในคอมพิวเตอร์ ไฟล์ ZIP นี้มีไฟล์ Jar ของคลาสไลบรารีของไคลเอ็นต์และไฟล์ Jar แหล่งที่มาที่เกี่ยวข้องสำหรับอาร์ติแฟกต์แต่ละรายการและทรัพยากร 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
  • แจ็กสัน-คอร์-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
  • แจ็กสัน-คอร์-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
  • แจ็กสัน-คอร์-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
  • แจ็กสัน-คอร์-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 ส่วนกลาง Maven groupId สำหรับอาร์ติแฟกต์ทั้งหมดสำหรับไลบรารีนี้คือ 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 สำหรับ Java (google-api-client-servlet) สนับสนุนเว็บแอปพลิเคชันของ Java servlet โมดูลนี้ขึ้นอยู่กับ 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) รองรับแอปพลิเคชัน Google App Engine สำหรับ Java โมดูลนี้ขึ้นอยู่กับ 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-ctrbuf) โมดูลนี้ขึ้นอยู่กับ google-http-client-ctrbuf และ 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>