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