مكتبة برامج Google Ads API للغة Java

تتم استضافة مكتبة البرامج للغة Java على GitHub وتوزيعها من خلال Maven Central. وتوفّر هذه المكتبة العديد من الميزات التي تساعدك في استخدام واجهة برمجة التطبيقات، بما في ذلك تسهيل إدارة بيانات الاعتماد وإنشاء برامج خدمة Google Ads API.

تتطلّب المكتبة الإصدار 8 من Java أو إصدارًا أحدث.

تثبيت

استخدِم قائمة مواد 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>46.1.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>

يمكنك أيضًا إنشاء المكتبة من المصدر.

إجراء أول طلب بيانات من واجهة برمجة التطبيقات

مكتبة الفيديوهات: بدء استخدام مكتبة برامج Java

لاستخدام Google Ads API، عليك اتّخاذ عدّة خطوات للحصول على إذن الوصول إلى واجهة برمجة التطبيقات وإعداد حساباتك على "إعلانات Google". اتّبِع دليل البدء السريع الذي يوجّهك خلال جميع الخطوات المهمة، بما في ذلك إعداد حساباتك على "إعلانات Google".

الاستخدام الأساسي

راجِع دليل الاستخدام الأساسي لمعرفة كيفية إعداد مشروع وإنشاء مثيلات لبرامج خدمة العملاء وتشغيل أمثلة الرموز باستخدام مكتبة عميل Java.

المصادقة والتفويض

تتيح مكتبة برامج Java للعميل عدة طرق للمصادقة والتفويض، بما في ذلك مسارات تطبيقات الويب وسطح المكتب في OAuth 2.0 وحسابات الخدمة وبيانات الاعتماد التلقائية للتطبيق. لمزيد من المعلومات، يُرجى الرجوع إلى دليل المصادقة والتفويض.

الإعداد والتسجيل

تتيح مكتبة برامج Java للعميل خيارات إعداد متعددة (بما في ذلك ملفات ads.properties ومتغيرات البيئة والإعداد الآلي) وإمكانات تسجيل لتتبُّع طلبات واجهة برمجة التطبيقات وردودها.

الأدوات المساعدة

تتضمّن مكتبة برامج Java فئات أدوات لتحسين سهولة استخدام واجهة برمجة التطبيقات. يُرجى الرجوع إلى الأدلة التالية لمعرفة المزيد:

  • FieldMasks: أدوات مساعدة لإنشاء أقنعة حقول التعديل واحتسابها.
  • ResourceNames: أدوات مساعدة لتنسيق سلاسل أسماء موارد الكيانات.
  • العمليات الطويلة: أدوات مساعدة لمراقبة عمليات واجهة برمجة التطبيقات غير المتزامنة وإدارتها.

تحسين تطبيقك

راجِع دليل الاستخدام المتقدّم للحصول على اقتراحات حول كيفية توليف مهلات تطبيقك وإعدادات إعادة المحاولة ووقت الاستجابة عند بدء التشغيل وإدارة الاعتماديات.