کتابخانه مشتری برای Java در GitHub میزبانی می‌شود و ازطریق Maven Central توزیع می‌شود. این کتابخانه چندین ویژگی ارائه می‌دهد تا به شما کمک کند از میانای برنامه‌سازی کاربردی استفاده کنید، ازجمله مدیریت آسان‌تر اطلاعات اعتباری و ایجاد کارخواه‌های سرویس میانای برنامه‌سازی کاربردی Google Ads.
این کتابخانه به 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.0.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>
همچنین می‌توانید کتابخانه را از منبع بسازید.
اولین تماس با API را برقرار کنید
برای استفاده از Google Ads API، باید چند مرحله را برای دسترسی به API و پیکربندی حساب‌های Google Ads خود انجام دهید. راهنمای شروع سریع را دنبال کنید، این راهنما شما را در تمام مراحل مهم ازجمله راه‌اندازی حساب‌های Google Ads راهنمایی می‌کند.
استفاده پایه
برای آشنایی با نحوه راه‌اندازی پروژه، نمونه‌سازی کارخواه‌های سرویس، و اجرای نمونه‌های کد با کتابخانه کارخواه Java، به راهنمای استفاده پایه مراجعه کنید.
اصالت‌سنجی و صدور مجوز
کتابخانه کارخواه Java از رویکردهای متعددی برای اصالت‌سنجی و صدور مجوز پشتیبانی می‌کند، ازجمله جریان‌های برنامه وب و رایانه OAuth 2.0، حساب‌های سرویس، و «اعتبارنامه‌های پیش‌فرض برنامه». برای کسب اطلاعات بیشتر، به راهنمای اصالت‌سنجی و صدور مجوز مراجعه کنید.
پیکربندی و گزارش‌گیری
کتابخانه کارخواه جاوا از چندین گزینه پیکربندی (ازجمله فایل‌های ads.properties، متغیرهای محیطی، و پیکربندی برنامه‌ریزی‌شده) و قابلیت‌های گزارش‌گیری برای ردیابی درخواست‌ها و پاسخ‌های «میانای برنامه‌سازی کاربردی» پشتیبانی می‌کند.
برنامه‌های کمکی
کتابخانه کارخواه Java شامل کلاس‌های کمکی برای بهبود قابلیت استفاده از API است. برای کسب اطلاعات بیشتر، به راهنماهای زیر مراجعه کنید:
- FieldMasks: کمک‌کننده‌ها برای ساختن و محاسبه کردن ماسک‌های فیلد به‌روزرسانی.
- ResourceNames: ابزارهای کمکی برای قالب‌بندی رشته‌های نام منبع نهاد.
- عملیات طولانی‌مدت: دستیارهایی برای نظارت و مدیریت عملیات ناهم‌زمان میانای برنامه‌سازی کاربردی.
تنظیم دقیق برنامه
برای توصیه‌هایی درباره نحوه تنظیم دقیق مهلت‌های زمانی برنامه، تنظیمات تلاش مجدد، تأخیر راه‌اندازی، و مدیریت وابستگی، به راهنمای استفاده پیشرفته مراجعه کنید.