في ما يلي الاستخدام الأساسي لمكتبة برامج 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'