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

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

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

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

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

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

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

لربط حسابك بواجهة برمجة التطبيقات الخاصة بـ "إعلانات Google"، عليك تقديم بيانات اعتماد المصادقة والتفويض. راجِع دليل المصادقة والتفويض للحصول على تفاصيل حول بيانات الاعتماد المطلوبة وكيفية ضبط مكتبة البرامج.

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

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

للتحقّق من صحة بيانات الاعتماد وإجراء مكالمتك الأولى باستخدام مستودع 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'