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

مكتبة برامج Perl

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

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

بروتوكول REST API

بروتوكول JSON REST عبر HTTP 1.1.

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

للتواصل مع 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
./Build installdeps
./Build
./Build install
```

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

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

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

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

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

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

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

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

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

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

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

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