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

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

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