في ما يلي الاستخدام الأساسي لمكتبة برامج Java:
إنشاء مشروع جديد باستخدام Maven أو Gradle
أنشئ مشروع Maven أو Gradle جديدًا في بيئة التطوير المتكاملة التي تختارها. يتم نشر العناصر في مستودع Maven المركزي.
ننصحك باستخدام قائمة المواد (BOM) في واجهة برمجة التطبيقات Google Ads API لإدارة إصدارات التبعيات.
يمكنك أيضًا إنشاء التطبيق من المصدر. لأغراض هذا الدليل، من المفترض أن يكون لديك مشروع تم إعداده مع توفُّر التبعيات المطلوبة.
إذا كنت تنشئ التطبيق من المصدر، تأكَّد من تفعيل معالجة التعليقات التوضيحية في بيئة التطوير المتكاملة (IDE).
ضبط أذونات الوصول إلى واجهة برمجة التطبيقات
لربط Google Ads API، عليك تقديم بيانات اعتماد المصادقة والتفويض. راجِع دليل المصادقة والأذونات للحصول على تفاصيل حول بيانات الاعتماد المطلوبة وكيفية ضبط إعدادات مكتبة البرامج.
إجراء مكالمتك الأولى
بعد ضبط بيانات الاعتماد، يمكنك إجراء أول طلب بيانات من واجهة برمجة التطبيقات.
للتحقّق من صحة بيانات الاعتماد وإجراء طلبك الأول، سننفّذ مثال 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'