تستضيف GitHub مكتبة برامج Java المستضافة على GitHub، ويتم توزيعها من خلال Maven Central. وتوفّر هذه المكتبة عدة ميزات لمساعدتك في استخدام واجهة برمجة التطبيقات، بما في ذلك إدارة بيانات الاعتماد وإنشاء عملاء خدمة Google Ads API بسهولة أكبر.
تتطلّب المكتبة Java 8 أو إصدارًا أحدث.
تثبيت
استخدِم قائمة مواد Google Ads API في ملف pom.xml أو
build.gradle لإدارة إصدارات التبعيات:
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>48.0.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
يمكنك أيضًا إنشاء المكتبة من المصدر.
إجراء أول طلب بيانات من واجهة برمجة التطبيقات
لاستخدام Google Ads API، عليك تنفيذ عدة خطوات للوصول إلى واجهة برمجة التطبيقات وضبط حساباتك على "إعلانات Google". اتّبِع دليل البدء السريع الذي يرشدك خلال جميع الخطوات المهمة، بما في ذلك إعداد حساباتك على "إعلانات Google".
الاستخدام الأساسي
يُرجى الرجوع إلى دليل الاستخدام الأساسي لمعرفة كيفية إعداد مشروع وإنشاء مثيلات لعملاء الخدمة وتشغيل أمثلة الرموز البرمجية باستخدام مكتبة برامج Java.
المصادقة والتفويض
تتوافق مكتبة برامج Java مع طرق متعددة للمصادقة والتفويض، بما في ذلك مسارات تطبيقات سطح المكتب والويب في OAuth 2.0 وحسابات الخدمة وبيانات الاعتماد التلقائية للتطبيق. لمزيد من المعلومات، يُرجى الرجوع إلى دليل المصادقة والتفويض.
الضبط والتسجيل
تتوافق مكتبة برامج Java مع خيارات الضبط المتعددة
(بما في ذلك ملفات ads.properties ومتغيّرات البيئة والضبط البرمجي
) وإمكانات التسجيل لتتبُّع طلبات البيانات من واجهة برمجة التطبيقات
والردود عليها.
الأدوات المساعدة
تتضمّن مكتبة برامج Java فئات الأدوات المساعدة لتحسين سهولة استخدام واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الرجوع إلى الأدلة التالية:
- FieldMasks: أدوات مساعدة لإنشاء أقنعة حقول التعديل وحسابها
- ResourceNames: أدوات مساعدة لـ تنسيق سلاسل أسماء موارد الكيانات
- العمليات الطويلة الأمد: أدوات مساعدة لـ مراقبة عمليات واجهة برمجة التطبيقات غير المتزامنة وإدارتها
تحسين تطبيقك
يُرجى الرجوع إلى دليل الاستخدام المتقدّم للحصول على اقتراحات حول كيفية تحسين مهلات تطبيقك وإعدادات إعادة المحاولة ووقت استجابة بدء التشغيل وإدارة التبعيات.