مكتبات العملاء

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

مكتبة العميل المصدر التوزيع أمثلة على الرموز
Java google-ads-java Maven وtar.gz العرض على GitHub
.NET google-ads-dotnet tar.gz، zip العرض على GitHub
PHP google-ads-php tar.gz العرض على GitHub
Python google-ads-python tar.gz، zip العرض على GitHub
روبية google-ads-ruby gem وtar.gz وzip العرض على GitHub
بيرل google-ads-perl tar.gz، zip العرض على GitHub

إصدارات واجهة برمجة التطبيقات المتوافقة

يسرد الجدول أدناه إصدارات المكتبة المحدّدة التي تتوافق مع كل إصدار متاح من واجهات برمجة التطبيقات.

Java

واجهة برمجة التطبيقات وإصدارات Java المتوافقة مع الحد الأدنى/الأقصى
الإصدار 12 Min: 22.0.0
Max: -
الإصدار 11 Min: 19.0.0
Max: -
الإصدار 10 Min: 17.0.0
Max: -

#C

واجهة برمجة التطبيقات وإصدارات NET.Max/Max. المتوافقة
الإصدار 12 Min: 14.2.0
Max: -
الإصدار 11 Min: 12.1.0
Max: -
الإصدار 10 Min: 11.0.0
Max: -

PHP

واجهة برمجة التطبيقات وإصدارات PHP المتوافقة/الحد الأدنى
الإصدار 12 Min: 17.1.0
Max: -
الإصدار 11 Min: 15.1.0
Max: -
الإصدار 10 Min: 14.0.0
Max: -

Python

واجهة برمجة التطبيقات وإصدارات Python المتوافقة مع الحد الأدنى أو الأقصى
الإصدار 12 Min: 19.0.0
Max: -
الإصدار 11 Min: 17.0.0
Max: -
الإصدار 10 Min: 15.0.0
Max: -

Ruby

واجهة برمجة التطبيقات وإصدارات Min/Max Ruby المتوافقة
الإصدار 12 Min: 20.0.0
Max: -
الإصدار 11 Min: 18.0.0
Max: -
الإصدار 10 Min: 16.0.0
Max: -

Perl

واجهة برمجة التطبيقات وإصدارات Min/Max Perl المتوافقة
الإصدار 12 Min: 14.0.0
Max: -
الإصدار 11 Min: 12.0.0
Max: -
الإصدار 10 Min: 10.0.0
Max: -

الإعدادات

وتوفّر كل مكتبة عميل في Ads API إعدادات ضبط مختلفة وطرق تحميل يمكنك استخدامها لتخصيص سلوكها.

في ما يلي متغيّرات البيئة الشائعة في جميع مكتبات العملاء والتي يمكن تحميلها لضبط إعدادات الضبط:

  • مكتبة العملاء
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: المسار إلى ملف الإعداد.
  • OAuth2
    • وضع التطبيق
      • GOOGLE_ADS_CLIENT_ID : اضبط هذه القيمة على معرِّف عميل OAuth2.
      • GOOGLE_ADS_CLIENT_SECRET: اضبط هذه القيمة على سر عميل OAuth2.
      • GOOGLE_ADS_REFRESH_TOKEN : اضبط هذه القيمة على رمز مميّز معدّل لإعادة تحميل OAuth2 إذا كنت تريد إعادة استخدام الرموز المميزة لبروتوكول OAuth2. هذا الإعداد اختياري.
    • وضع حساب الخدمة
      • GOOGLE_ADS_JSON_KEY_FILE_PATH : اضبط هذه القيمة على مسار ملف إعداد OAuth2 التلقائي.
      • GOOGLE_ADS_IMPERSONATED_EMAIL : اضبط هذه القيمة على عنوان البريد الإلكتروني للحساب الذي يتم انتحال هويته.
  • Google Ads API
    • GOOGLE_ADS_DEVELOPER_TOKEN: اضبط هذه السمة على الرمز المميّز لمطوّر البرامج.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID: هذا هو الرقم التعريفي للعميل للعميل المفوَّض لاستخدامه في الطلب، بدون واصلات (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : هذا العنوان مطلوب فقط للطرق التي تعدّل موارد الكيان عند الحصول على إذن من خلال الحسابات المرتبطة في واجهة مستخدم "إعلانات Google" (مورد AccountLink في Google Ads API). اضبط هذه القيمة على الرقم التعريفي للعميل لموفّر البيانات الذي يعدّل موارد الرقم التعريفي للعميل المحدّد. يجب ضبطها بدون واصلات (-). للاطّلاع على مزيد من المعلومات حول الحسابات المرتبطة، يُرجى الانتقال إلى مركز المساعدة.