استفاده پایه

استفاده پایه از کتابخانه کارخواه جاوا به‌صورت زیر است:

ایجاد پروژه جدید Maven یا Gradle

پروژه Maven یا Gradle جدیدی در IDE انتخابی‌تان ایجاد کنید. مصنوعات در مخزن Maven Central منتشر می‌شوند.

از Google Ads API Bill of Materials (BOM) برای مدیریت نسخه‌های وابستگی استفاده کنید.

اگر می‌خواهید نمونه‌های کد ازپیش بسته‌بندی‌شده موجود در google-ads-examples واحد را اجرا کنید، google-ads-java مخزن را از GitHub شبیه‌سازی کنید یا از منبع بسازید. اگر از منبع می‌سازید، مطمئن شوید که پردازش حاشیه‌نویسی را در IDE خود فعال کرده‌اید.

پیکربندی دسترسی میانای برنامه‌سازی کاربردی

برای متصل شدن به Google Ads API، باید اطلاعات کاربری اصالت‌سنجی و صدور مجوز را ارائه دهید. برای جزئیات مربوط به اعتبارنامه‌های لازم و نحوه پیکربندی کتابخانه مشتری، راهنمای اصالت‌سنجی و صدور مجوز را ببینید.

اولین تماس را برقرار کنید

پس‌از پیکربندی اطلاعات اعتباری، آماده‌اید اولین تماس API خود را برقرار کنید.

برای اعتبارسنجی اعتبارنامه‌هایتان و برقراری اولین تماس بااستفاده از مخزن شبیه‌سازی‌شده google-ads-java، نمونهGetCampaigns را اجرا کنید.

ابتدا، به فهرست راهنمای google-ads-examples بروید:

cd google-ads-examples

این مثال به پارامتر --customerId نیاز دارد که مقدار آن شناسه مشتری حساب Google Ads شما بدون خط تیره (-) است.

برای اجرا با Gradle:

./gradlew -q runExample \
  --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

برای اجرا با Maven:

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

کاوش نمونه‌های دیگر

بسته مثال‌ها در google-ads-examples شامل چندین مثال مفید است. اکثر مثال‌ها به پارامتر نیاز دارند. می‌توانید پارامترها را به‌عنوان آرگومان ارسال کنید (توصیه‌شده) یا مقادیر جای‌بان INSERT_..._HERE را در کد منبع ویرایش کنید. برای دیدن بیانیه استفاده برای مثال، --help را به‌عنوان تنها آرگومان ارسال کنید.

با Gradle:

./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

همچنین می‌توانید از تکلیف listExamples در Gradle برای فهرست کردن همه نمونه‌ها، نمونه‌های موجود در زیرفهرست راهنما، یا نمونه‌هایی که شرح آن‌ها شامل عبارت جستجو است استفاده کنید:

# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'