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