استفاده اساسی

کاربرد اساسی کتابخانه کلاینت جاوا به شرح زیر است:

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

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

برای مدیریت نسخه‌های وابستگی ، از فهرست مواد (BOM) API تبلیغات گوگل استفاده کنید.

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

پیکربندی دسترسی API

برای اتصال به 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"

نمونه‌های دیگر را بررسی کنید

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

با گریدل:

./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'