دستورالعمل های راه اندازی

اگر از کتابخانه تولید شده استفاده نمی‌کنید، می‌توانید Google API Client Library برای جاوا و وابستگی‌های آن را در یک فایل فشرده دانلود کنید یا می‌توانید از Maven استفاده کنید.

همچنین دستورالعمل‌های راه‌اندازی ProGuard را که بخشی از Google HTTP Client Library برای اسناد جاوا هستند، ببینید.

دانلود کتابخانه با وابستگی

آخرین فایل فشرده را که می توانید در صفحه دانلودها پیدا کنید، دانلود کنید و آن را در رایانه خود استخراج کنید. این فایل فشرده حاوی فایل‌های jar کلاس کتابخانه مشتری و فایل‌های jar منبع مرتبط برای هر مصنوع و وابستگی‌های آن است. می توانید نمودارهای وابستگی و مجوزهای کتابخانه های مختلف را در پوشه وابستگی ها پیدا کنید. برای جزئیات بیشتر در مورد محتویات دانلود به فایل readme.html مراجعه کنید.

اندروید

اگر در حال توسعه برای Android هستید و API Google که می‌خواهید استفاده کنید در کتابخانه خدمات Google Play گنجانده شده است، از کتابخانه خدمات Google Play برای بهترین عملکرد و تجربه استفاده کنید.

اگر از Google API Client Library برای جاوا با Android استفاده می‌کنید، مهم است که بدانید کدام وابستگی‌ها با 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 به فایل‌های 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

جاوا عمومی

برنامه‌های جاوا با هدف عمومی به فایل‌های 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 ها دارد.

ماون

Google API Client Library برای جاوا در مخزن مرکزی Maven قرار دارد. Maven groupId برای همه مصنوعات این کتابخانه com.google.api-client است. دستورالعمل های Maven خاص برای هر ماژول (در زیر) داده شده است.

ماژول ها

این کتابخانه از نه ماژول تشکیل شده است:

google-api-client

Google API Client Library برای جاوا (google-api-client) به گونه‌ای طراحی شده است که با تمام پلتفرم‌های جاوا پشتیبانی‌شده، از جمله Android، سازگار باشد.

استفاده از Maven:

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

در Android، باید وابستگی های استفاده نشده را به صراحت حذف کنید:

<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 Client Library برای جاوا (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 Client برای جاوا (google-api-client-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 Client Library برای جاوا (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 برای جاوا (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 Client برای جاوا (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 برای جاوا (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 Client برای جاوا (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>