تسهّل مكتبة العميل للغة Perl التفاعلات مع "واجهة برمجة التطبيقات لإعلانات Google"، مع الحد الأدنى من الإعدادات من جانبك. ومع ذلك، يعتمد الأداء بشكل كبير على كيفية استخدام المكتبة ودمجها.
تنطبق معظم أفضل الممارسات على جميع اللغات. يتناول هذا الدليل تلك التي تخص Perl.
إنشاء ملف تعريف لتطبيقك
يمكنك إنشاء ملف تعريف لتطبيقك من أجل رصد استخدام وحدة المعالجة المركزية والذاكرة وتحديد المؤثّرات السلبية في الأداء. Devel::NYTProf هي أداة قوية وغنية بالميزات لتحديد المشاكل في رمز المصدر Perl، ويمكنك استكشافها.
إصدار Perl
من الممارسات الجيدة الترقية بانتظام إلى إصدار أحدث من Perl لأنّه عادةً ما يتضمّن أداءً أفضل بشكل عام. يمكنك الانتقال إلى هذه الصفحة للاطّلاع على أحدث إصدار من Perl، والحد الأدنى للإصدار المطلوب للمكتبة في هذه الصفحة.
التسجيل
يمكن أن يؤدي التسجيل المطوَّل إلى فرض عقوبات كبيرة على وقت التنفيذ واستهلاك الذاكرة. ننصحك بضبط مستوى التسجيل على WARN لأي رمز في مرحلة الإنتاج.
راجِع دليل التسجيل للحصول على مزيد من التفاصيل حول إعداد أدوات تسجيل الملخّصات والتفاصيل.
طريقة Search أو SearchStream
توفّر Google Ads API طريقتَين رئيسيتَين لاسترداد العناصر، وهما
Search (التي تستخدم تقسيم النتائج إلى صفحات) و
SearchStream (التي تستخدم البث).
تقدّم طريقة SearchStream أداءً أفضل من طريقة Search، ولكن قد تكون هناك سيناريوهات معيّنة يُفضّل فيها استخدام طريقة Search.
يمكنك الاطّلاع على مزيد من المعلومات حول الطريقتَين هنا.
انتهت مهلة HTTP
توفّر مكتبة برامج Perl للعميل واجهة لضبط مهلات HTTP على مستوى العميل:
my $api_client = Google::Ads::GoogleAds::GoogleAdsClient->new({
# Set HTTP timeout to 5 minutes.
http_timeout => 300
});
يتم ضبط القيمة التلقائية استنادًا إلى الإعداد DEFAULT_HTTP_TIMEOUT في Constants.pm.
اضبط قيمة أقل إذا كنت بحاجة إلى فرض حدّ زمني أقصر على الحدّ الأقصى لمدة طلب البيانات من واجهة برمجة التطبيقات.
يمكنك ضبط المهلة على ساعتين أو أكثر، ولكن قد تنتهي مهلة واجهة برمجة التطبيقات مع الطلبات التي تستغرق وقتًا طويلاً جدًا وتعرض الخطأ DEADLINE_EXCEEDED.
في حال مواجهة هذا الخطأ، قسِّم الطلب ونفِّذ الأجزاء بالتوازي، ما يمنع حدوث عطل في طلب يستغرق وقتًا طويلاً، ويجنّبك الاضطرار إلى إعادة إرسال الطلب من البداية.