‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

کتابخانه مشتری Perl

کتابخانه کارخواه Perl در GitHub میزبانی می‌شود و بسته در CPAN دردسترس است.

این کتابخانه از Perl نسخه ۵.۲۸.۱ یا بالاتر پشتیبانی می‌کند.

پروتکل REST API

موجودیت‌های کلاس—مانند سرویس، منبع، enum، و خطا—در کتابخانه کارخواه Perl با تجزیه کردن تعاریف میان‌گیر پروتکل تولید می‌شوند. برای کسب اطلاعات بیشتر درباره نحوه سریال‌سازی داده‌های ساختاریافته، به اسناد میان‌گیر پروتکل مراجعه کنید.

برای اتصال به Google Ads API، کتابخانه مشتری یک درخواست HTTP در JSON ایجاد می‌کند، آن را ازطریق HTTP 1.1 به نقطه پایانی REST ارسال می‌کند، پاسخ را به‌عنوان یک شیء 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، باید چند مرحله را برای دسترسی به API و پیکربندی حساب‌های Google Ads خود انجام دهید. راهنمای راه‌اندازی سریع را دنبال کنید که شما را در تمام مراحل مهم، ازجمله راه‌اندازی حساب‌های Google Ads، راهنمایی می‌کند.

استفاده پایه

‫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 شامل کلاس‌های کاربردی برای بهبود قابلیت استفاده از API است. برای کسب اطلاعات بیشتر، به راهنماهای زیر مراجعه کنید:

تنظیم دقیق عملکرد برنامه

برای توصیه‌هایی درباره نحوه تنظیم دقیق عملکرد برنامه‌تان، به راهنمای عملکرد مراجعه کنید.