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

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

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

تثبيت

استخدِم قائمة المواد (BOM) في 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.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>

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

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

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

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

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

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

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

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

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

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

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

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

تحسين تطبيقك

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