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

مكتبة برامج Perl

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

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

بروتوكول REST API

يتم إنشاء كيانات الفئات، مثل الخدمة والمورد والتعداد والخطأ، في مكتبة عملاء 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 فئات خدمات لتحسين سهولة استخدام واجهة برمجة التطبيقات. يُرجى الرجوع إلى الأدلة التالية لمزيد من المعلومات:

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

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