کتابخانه کارخواه برای Java در GitHub میزبانی می‌شود و ازطریق Maven Central توزیع می‌شود. این کتابخانه چندین ویژگی برای کمک به شما در استفاده از API ارائه می‌دهد، ازجمله مدیریت آسان‌تر اطلاعات کاربری و ایجاد کارخواه‌های سرویس Google Ads API.
این کتابخانه به Java 8 یا جدیدتر نیاز دارد.
نصب
از Google Ads API Bill of Materials (BOM) در فایل pom.xml یا build.gradle خود برای مدیریت نسخه‌های وابستگی استفاده کنید:
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>48.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
همچنین می‌توانید کتابخانه را از منبع بسازید.
اولین فراخوانی میانای برنامه‌سازی کاربردی را انجام دهید
برای استفاده از Google Ads API، باید چند مرحله را برای دسترسی به API انجام دهید و حساب‌های Google Ads خود را پیکربندی کنید. راهنمای راه‌اندازی سریع را دنبال کنید که شما را در تمام مراحل مهم، ازجمله راه‌اندازی حساب‌های Google Ads، راهنمایی می‌کند.
استفاده پایه
برای آشنایی با نحوه راه‌اندازی پروژه، نمونه‌سازی کارخواه‌های سرویس، و اجرای نمونه‌های کد با کتابخانه کارخواه Java، به راهنمای استفاده پایه مراجعه کنید.
اصالت‌سنجی و صدور مجوز
کتابخانه کارخواه Java از چندین رویکرد برای اصالت‌سنجی و صدور مجوز پشتیبانی می‌کند، ازجمله جریان‌های برنامه وب و رایانه OAuth 2.0، حساب‌های سرویس، و «اعتبارنامه‌های پیش‌فرض برنامه». برای کسب اطلاعات بیشتر، به راهنمای اصالت‌سنجی و صدور مجوز مراجعه کنید.
پیکربندی و ثبت گزارش
کتابخانه کارخواه Java از چندین گزینه پیکربندی (ازجمله فایل‌های ads.properties، متغیرهای محیطی، و پیکربندی برنامه‌ای) و قابلیت‌های ثبت وقایع برای ردیابی درخواست‌ها و پاسخ‌های میانای برنامه‌سازی کاربردی پشتیبانی می‌کند.
برنامه‌های کمکی
کتابخانه کارخواه Java شامل کلاس‌های کمکی برای بهبود قابلیت استفاده از API است. برای کسب اطلاعات بیشتر، به راهنماهای زیر مراجعه کنید:
- FieldMasks: کمک‌کننده‌هایی برای ساختن و محاسبه کردن پوشش‌های فیلد به‌روزرسانی.
- ResourceNames: ابزارهای کمکی برای قالب‌بندی رشته‌های نام منبع نهاد.
- عملیات طولانی‌مدت: کمک‌کننده‌هایی برای پایش و مدیریت عملیات ناهمگام API.
تنظیم دقیق برنامه
برای توصیه‌هایی درباره نحوه تنظیم دقیق زمان‌های اتمام مهلت برنامه، تنظیمات تکرار مجدد، تأخیر راه‌اندازی، و مدیریت وابستگی، به راهنمای استفاده پیشرفته مراجعه کنید.