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

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

โปรดดูวิธีการตั้งค่า ProGuard ซึ่งเป็นส่วนหนึ่งของไลบรารีของไคลเอ็นต์ Google HTTP สําหรับ 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.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

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

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

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

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

Maven

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

โมดูล

ห้องสมุดนี้ประกอบด้วยโมดูล 9 รายการ ได้แก่

ไคลเอ็นต์ Google API

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

การใช้งาน Maven:

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

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

<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

ส่วนขยายไปยังไลบรารีของไคลเอ็นต์ 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.0.0</version>
</dependency>

google-api-client-servlet

ส่วนขยาย Servlet และ JDO ไปยังไลบรารีของไคลเอ็นต์ Google API สําหรับ 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.0.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.0.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.0.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.0.0</version>
</dependency>

google-api-client-java6

ส่วนขยาย Java 6 (และใหม่กว่า) ในไลบรารีของไคลเอ็นต์ Google API สําหรับ Java (google-api-client-java6) โมดูลนี้ขึ้นอยู่กับ google-api-client และ google-oauth-client-java6

การใช้งาน Maven:

<dependency>
  <groupId>com.google.api-client</groupId>
  <artifactId>google-api-client-java6</artifactId>
  <version>2.0.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.0.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.0.0</version>
</dependency>