الاستخدام الأساسي

في ما يلي الاستخدام الأساسي لمكتبة برامج Java:

إنشاء مشروع جديد باستخدام Maven أو Gradle

أنشِئ مشروع Maven أو Gradle جديدًا في بيئة التطوير المتكاملة (IDE) التي تختارها. يتم نشر العناصر في مستودع Maven المركزي.

استخدِم قائمة المواد (BOM) في Google Ads API لإدارة إصدارات التبعيات.

إذا أردت تشغيل أمثلة الرموز البرمجية المجمّعة مسبقًا والمضمّنة في وحدة google-ads-examples، يمكنك استنساخ مستودع google-ads-java من GitHub أو إنشاؤه من المصدر. إذا كنت تنشئ التطبيق من المصدر، تأكَّد من تفعيل معالجة التعليقات التوضيحية في بيئة التطوير المتكاملة (IDE).

ضبط إمكانية الوصول إلى واجهة برمجة التطبيقات

لربط تطبيقك بـ Google Ads API، عليك تقديم بيانات اعتماد المصادقة والتفويض. يُرجى الاطّلاع على دليل المصادقة والتفويض للحصول على تفاصيل حول بيانات الاعتماد المطلوبة وكيفية ضبط مكتبة البرامج.

إجراء مكالمتك الأولى

بعد إعداد بيانات الاعتماد، يمكنك إجراء طلب بيانات من واجهة برمجة التطبيقات الأول.

للتحقّق من بيانات الاعتماد وإجراء أول طلب باستخدام مستودع google-ads-java المستنسَخ، شغِّل مثال GetCampaigns.

أولاً، انتقِل إلى دليل google-ads-examples:

cd google-ads-examples

يتطلّب هذا المثال مَعلمة --customerId حيث تكون القيمة هي الرقم التعريفي لعميل حسابك على "إعلانات Google" بدون واصلات (-).

للتشغيل باستخدام 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 كوسيطة وحيدة.

باستخدام 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'