في ما يلي الاستخدام الأساسي لمكتبة برامج Java:
إنشاء مشروع جديد باستخدام Maven أو Gradle
أنشئ مشروع Maven أو Gradle جديدًا في بيئة التطوير المتكاملة التي تختارها. يتم نشر العناصر في مستودع Maven المركزي.
ننصحك باستخدام قائمة المواد (BOM) في واجهة برمجة التطبيقات الخاصة بـ "إعلانات Google" لإدارة إصدارات التبعيات.
يمكنك أيضًا إنشاء التطبيق من المصدر. لأغراض هذا الدليل، سنفترض أنّ لديك مشروعًا تم إعداده مع توفُّر التبعيات المطلوبة.
إذا كنت تنشئ التطبيق من المصدر، تأكَّد من تفعيل معالجة التعليقات التوضيحية في بيئة التطوير المتكاملة (IDE).
ضبط أذونات الوصول إلى واجهة برمجة التطبيقات
لربط حسابك بواجهة برمجة التطبيقات الخاصة بـ "إعلانات Google"، عليك تقديم بيانات اعتماد المصادقة والتفويض. راجِع دليل المصادقة والأذونات للحصول على تفاصيل حول بيانات الاعتماد المطلوبة وكيفية ضبط إعدادات مكتبة البرامج للعملاء.
إجراء مكالمتك الأولى
بعد ضبط بيانات الاعتماد، يمكنك إجراء طلب البيانات الأول من واجهة برمجة التطبيقات.
للتحقّق من بيانات الاعتماد وإجراء مكالمتك الأولى، سننفّذ مثال GetCampaigns.
أولاً، انتقِل إلى الدليل google-ads-examples.
cd google-ads-examples
يتطلّب هذا المثال المَعلمة --customerId التي تكون قيمتها رقم تعريف عميل حسابك على "إعلانات Google" بدون شرطات.
للتشغيل باستخدام Gradle، اتّبِع الخطوات التالية:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
استكشاف أمثلة أخرى
تحتوي حزمة examples في google-ads-examples
على العديد من الأمثلة المفيدة. تتطلّب معظم الأمثلة مَعلمات. يمكنك إما تمرير المَعلمات كوَسائط (يُنصح بذلك) أو تعديل قيم INSERT_XXXXX_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'