مكتبة برامج Perl

تتم استضافة مكتبة Perl للعملاء على GitHub، وتتوفّر الحزمة على CPAN.

تتوافق المكتبة مع الإصدار 5.28.1 أو الإصدارات الأحدث من Perl.

بروتوكول REST API

يتم إنشاء عناصر الفئات، مثل الخدمة والمورد والقائمة المحدودة والخطأ، في مكتبة Perl للعميل من خلال تحليل تعريفات مخزن البروتوكولات المؤقتة. لمزيد من المعلومات حول كيفية تسلسل البيانات المنظَّمة، راجِع مستندات بروتوكول buffer.

للتواصل مع Google Ads API، تنشئ مكتبة البرامج طلب HTTP بتنسيق JSON، وترسله إلى نقطة نهاية REST عبر HTTP 1.1، وتزيل تسلسل الرد ككائن JSON، وتفسّر النتائج.

تثبيت المكتبة

تتم استضافة مكتبة Perl للعملاء على GitHub وتوزيعها باستخدام CPAN.

  1. استنسِخ المكتبة من GitHub:

    git clone https://github.com/googleads/google-ads-perl.git

  2. انتقِل إلى الدليل google-ads-perl:

    cd google-ads-perl

    ستظهر لك بعض الملفات والمجلدات الفرعية:

    • ‫Build.PL: ملف إنشاء Perl الذي يحتوي على التبعيات وأنواع الاختبارات لهذا المشروع
    • ‫lib: رمز المصدر للمكتبة
    • ‫t: حالات اختبار رمز المكتبة
    • examples: العديد من الأمثلة التي توضّح كيفية استخدام المكتبة لتنفيذ حالات الاستخدام الشائعة باستخدام Google Ads API.
    • ‫googleads.properties: ملف إعدادات النموذج للمكتبة
    • log4perl.conf: ملف إعداد تسجيل العيّنات.

  3. ثبِّت العناصر التابعة المطلوبة. يسرد ملف Build.PL جميع التبعيات المطلوبة للمكتبة. يمكنك تثبيتها من خلال تنفيذ الأوامر التالية:

    cpan install Module::Build
perl Build.PL
perl Build installdeps

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

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

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

راجِع دليل الاستخدام الأساسي لمعرفة المزيد حول كيفية استخدام مكتبة Perl للعملاء.

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

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

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

تستخدم مكتبة عميل Perl googleads.properties للإعداد وlog4perl.conf لتسجيل البيانات. يمكنك تعديل هذه الملفات لتخصيص سلوك المكتبة. يُرجى الرجوع إلى دليل تسجيل البيانات لمعرفة المزيد.

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

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

تحسين أداء تطبيقك

راجِع دليل الأداء للحصول على اقتراحات حول كيفية تحسين أداء تطبيقك.