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

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

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

مكتبة العميل المصدر التوزيع أمثلة على الرموز
Java google-ads-java Maven وtar.gz العرض على GitHub
.NET google-ads-dotnet nuget و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
لغة Perl google-ads-perl tar.gz، zip العرض على GitHub

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

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

لغة Java

واجهة برمجة التطبيقات وإصدارات جافا المتوافقة/الحد الأدنى المتوافقة
الإصدار 13 Min: 23-0-0
Max: -
الإصدار 12 Min: 22.0.0
Max: -
الإصدار 11 Min: 19,0.0
Max: -

C#‎

واجهة برمجة التطبيقات وإصدارات Min.Max.NET المدعومة
الإصدار 13 Min: 15-0-0
Max: -
الإصدار 12 Min: 14.2.0
Max: -
الإصدار 11 Min: 12.1.0
Max: -

لغة PHP

واجهة برمجة التطبيقات وإصدارات PHP ذات الحد الأدنى/الحد الأقصى المسموح به
الإصدار 13 Min: 18.0.0
Max: -
الإصدار 12 Min: 17.1.0
Max: -
الإصدار 11 Min: 15 -1-0
Max: -

لغة Python

واجهة برمجة التطبيقات وإصدارات Python/Max المتوافقة مع Python
الإصدار 13 Min: 20.0.0
Max: -
الإصدار 12 Min: 19,0.0
Max: -
الإصدار 11 Min: 17-0-0
Max: -
الإصدار 10 Min: 15.0.0
Max: 19.0.0

Ruby

واجهة برمجة التطبيقات وإصدارات Min/Max Ruby المدعومة
الإصدار 13 Min: 21,0-0
Max: -
الإصدار 12 Min: 20.0.0
Max: -
الإصدار 11 Min: 18.0.0
Max: -

Perl

واجهة برمجة التطبيقات وإصدارات Min/Max Perl المدعومة
الإصدار 13 Min: 15-0-0
Max: -
الإصدار 12 Min: 14.0.0
Max: -
الإصدار 11 Min: 12.0.0
Max: -

الإعدادات

توفر كل مكتبة عميل لإعلانات 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 JSON.
      • GOOGLE_ADS_IMPERSONATED_EMAIL : اضبط هذه القيمة على عنوان البريد الإلكتروني للحساب الذي تنتحل هويتك.
  • واجهة برمجة التطبيقات مع "إعلانات Google"
    • GOOGLE_ADS_DEVELOPER_TOKEN : اضبط هذا على الرمز المميز للمطوِّر.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : هذا هو الرقم التعريفي للعميل المُعتمَد للعميل لاستخدامه في الطلب بدون واصلات (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : هذا العنوان مطلوب فقط للطرق التي تحدِّث موارد الكيان عند الحصول على إذن من خلال الحسابات المرتبطة في واجهة مستخدم "إعلانات Google" (مورد AccountLink في Google Ads API). عيّن هذه القيمة على الرقم التعريفي للعميل التابع لموفر البيانات الذي يحدّث موارد الرقم التعريفي للعميل المحدد. يجب تعيينها بدون شُرط (-). لمعرفة المزيد حول الحسابات المرتبطة، يُرجى زيارة مركز المساعدة.