استفاده پایه

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

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

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

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

همچنین می‌توانید از منبع (source) آن را بسازید . برای اهداف این راهنما، فرض بر این است که شما یک پروژه راه‌اندازی شده با وابستگی‌های مورد نیاز دارید.

اگر از منبع برنامه می‌سازید، مطمئن شوید که پردازش حاشیه‌نویسی را در IDE خود فعال کرده‌اید.

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

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

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

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

برای اعتبارسنجی اعتبارنامه‌های شما و برقراری اولین فراخوانی، مثال GetCampaigns را اجرا خواهیم کرد.

ابتدا، به دایرکتوری google-ads-examples بروید.

cd google-ads-examples

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

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

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

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

بسته‌ی مثال‌ها در google-ads-examples شامل چندین مثال مفید است. اکثر مثال‌ها به پارامتر نیاز دارند. می‌توانید پارامترها را به عنوان آرگومان ارسال کنید (توصیه می‌شود) یا مقادیر INSERT_XXXXX_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'