کتابخانه کارخواه Perl در GitHub میزبانی می‌شود و بسته در CPAN دردسترس است.
این کتابخانه از Perl نسخه ۵.۲۸.۱ یا بالاتر پشتیبانی می‌کند.
پروتکل REST API
موجودیت‌های کلاس—مانند سرویس، منبع، enum، و خطا—در کتابخانه کارخواه Perl با تجزیه کردن تعاریف میان‌گیر پروتکل تولید می‌شوند. برای کسب اطلاعات بیشتر درباره نحوه سریال‌سازی داده‌های ساختاریافته، به اسناد میان‌گیر پروتکل مراجعه کنید.
برای اتصال به Google Ads API، کتابخانه مشتری یک درخواست HTTP در JSON ایجاد می‌کند، آن را ازطریق HTTP 1.1 به نقطه پایانی REST ارسال می‌کند، پاسخ را به‌عنوان یک شیء 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
اولین تماس با API را برقرار کنید
برای استفاده از Google Ads API، باید چند مرحله را برای دسترسی به API و پیکربندی حساب‌های Google Ads خود انجام دهید. راهنمای شروع سریع را دنبال کنید که شما را در تمام مراحل مهم ازجمله راه‌اندازی حساب‌های Google Ads راهنمایی می‌کند.
استفاده پایه
برای کسب اطلاعات بیشتر درباره نحوه استفاده از کتابخانه مشتری Perl، به راهنمای استفاده پایه مراجعه کنید.
اصالت‌سنجی و صدور مجوز
کتابخانه کارخواه Perl از چندین رویکرد برای اصالت‌سنجی و صدور مجوز پشتیبانی می‌کند. برای کسب اطلاعات بیشتر، به راهنمای اصالت‌سنجی و صدور مجوز مراجعه کنید.
پیکربندی و ثبت گزارش
کتابخانه کارخواه Perl از googleads.properties برای پیکربندی و از
log4perl.conf برای ثبت گزارش استفاده می‌کند. می‌توانید این فایل‌ها را برای سفارشی‌سازی رفتار کتابخانه تغییر دهید. برای کسب اطلاعات بیشتر، به راهنماهای پیکربندی و
ثبت گزارش مراجعه کنید.
برنامه‌های کمکی
کتابخانه کارخواه Perl شامل کلاس‌های کاربردی برای بهبود قابلیت استفاده از API است. برای کسب اطلاعات بیشتر، به راهنماهای زیر مراجعه کنید:
تنظیم دقیق عملکرد برنامه
برای توصیه‌هایی درباره نحوه تنظیم دقیق عملکرد برنامه‌تان، به راهنمای عملکرد مراجعه کنید.