تستخدم 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.

التثبيت من CPAN

ثبِّت توزيعة Google::Ads::GoogleAds::Client مباشرةً من CPAN باستخدام cpanm (أو cpan):

cpanm Google::Ads::GoogleAds::Client

إنشاء من المصدر وتشغيل الأمثلة

لتشغيل أمثلة الرموز البرمجية المجمّعة أو إنشاء المكتبة من المصدر:

استنسِخ المكتبة من 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".

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

ابدأ إعداد Google::Ads::GoogleAds::Client (الذي يحمّل بيانات الاعتماد من ~/googleads.properties أو GOOGLE_ADS_CONFIGURATION_FILE_PATH تلقائيًا) واستخدِم SearchStreamHandler لبث صفوف الحملة:

use strict;
use warnings;
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
use Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;

my $api_client = Google::Ads::GoogleAds::Client->new();
my $google_ads_service = $api_client->GoogleAdsService();

my $search_stream_request =
  Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
  ->new({
    customerId => "INSERT_CUSTOMER_ID_HERE",
    query      =>
      "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
  });

my $search_stream_handler =
  Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
    service => $google_ads_service,
    request => $search_stream_request
  });

$search_stream_handler->process_contents(
  sub {
    my $google_ads_row = shift;
    printf "Campaign with ID %d and name '%s' was found.\n",
      $google_ads_row->{campaign}{id},
      $google_ads_row->{campaign}{name};
  });

يُرجى الرجوع إلى دليل الاستخدام الأساسي لمعرفة المزيد عن كيفية استخدام مكتبة برامج Perl.

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

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

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

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

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

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

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

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