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

مكتبة برامج Perl

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

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

بروتوكول REST API

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

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

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

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

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

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

انتقِل إلى الدليل google-ads-perl:
```
cd google-ads-perl
```
ستظهر لك بعض الملفات والمجلدات الفرعية:
- ‫Build.PL: ملف إنشاء Perl الذي يحتوي على التبعيات وأنواع الاختبارات الخاصة بهذا المشروع
- ‫lib: رمز المصدر للمكتبة
- ‫t: حالات اختبار رمز المكتبة
- examples: العديد من الأمثلة التي توضّح كيفية استخدام المكتبة لتنفيذ حالات الاستخدام الشائعة باستخدام Google Ads API.
- ‫googleads.properties: ملف إعدادات النموذج للمكتبة
- log4perl.conf: ملف إعداد تسجيل العيّنات.
ثبِّت العناصر التابعة المطلوبة. يسرد ملف 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 للعملاء بعض فئات الأدوات المساعدة لتحسين سهولة استخدام واجهة برمجة التطبيقات. يُرجى الرجوع إلى الأدلة التالية لمعرفة المزيد:

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

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