کتابخانه کلاینت Perl در GitHub میزبانی میشود و این بسته در CPAN موجود است.
این کتابخانه از نسخه ۵.۲۸.۱ یا بالاتر پرل پشتیبانی میکند.
پروتکل REST API
موجودیتهای کلاس - مانند سرویس، منبع، شمارش و خطا - در کتابخانه کلاینت پرل با تجزیه تعاریف بافر پروتکل تولید میشوند. برای کسب اطلاعات بیشتر در مورد نحوه سریالسازی دادههای ساختاریافته، به مستندات بافر پروتکل مراجعه کنید.
برای اتصال به API گوگل ادز، کتابخانه کلاینت یک درخواست HTTP در قالب JSON ایجاد میکند، آن را از طریق HTTP 1.1 به نقطه پایانی REST ارسال میکند، پاسخ را به عنوان یک شیء JSON از حالت سریال خارج میکند و نتایج را تفسیر میکند.
کتابخانه را نصب کنید
کتابخانه کلاینت Perl در GitHub میزبانی میشود و با استفاده از CPAN توزیع میشود.
کتابخانه را از گیتهاب کلون کنید:
git clone https://github.com/googleads/google-ads-perl.gitبه دایرکتوری
google-ads-perlبروید:cd google-ads-perlچند فایل و زیرشاخه مشاهده خواهید کرد:
-
Build.PL: فایل ساخت Perl که وابستگیها و انواع تست این پروژه را در خود جای داده است. -
lib: کد منبع کتابخانه. -
t: موارد آزمایشی کد کتابخانه. -
examples: مثالهای زیادی که نحوه استفاده از کتابخانه را برای اجرای موارد استفاده رایج با استفاده از API تبلیغات گوگل نشان میدهند. -
googleads.properties: فایل پیکربندی نمونه برای کتابخانه. -
log4perl.conf: نمونه فایل پیکربندی ثبت وقایع.
-
وابستگیهای مورد نیاز را نصب کنید. فایل
Build.PLتمام وابستگیهای مورد نیاز برای کتابخانه را فهرست میکند. میتوانید آنها را با اجرای دستورات زیر نصب کنید:cpan install Module::Build perl Build.PL perl Build installdeps
اولین فراخوانی API خود را انجام دهید
برای استفاده از API گوگل ادز، باید چندین مرحله را انجام دهید تا به API دسترسی پیدا کنید و حسابهای گوگل ادز خود را پیکربندی کنید. توصیه میکنیم راهنمای شروع سریع را دنبال کنید که شما را در تمام مراحل مهم از جمله تنظیم حسابهای گوگل ادز راهنمایی میکند.
کاربرد اولیه
برای کسب اطلاعات بیشتر در مورد نحوه استفاده از کتابخانه کلاینت Perl، به راهنمای استفاده اولیه مراجعه کنید.
احراز هویت و مجوز
کتابخانه کلاینت Perl از رویکردهای متعددی برای احراز هویت و مجوزدهی پشتیبانی میکند. برای کسب اطلاعات بیشتر به راهنمای احراز هویت و مجوزدهی مراجعه کنید.
پیکربندی و ثبت وقایع
کتابخانه کلاینت پرل googleads.properties برای پیکربندی و log4perl.conf برای ثبت وقایع استفاده میکند. میتوانید این فایلها را برای سفارشیسازی رفتار کتابخانه تغییر دهید. برای کسب اطلاعات بیشتر به راهنمای ثبت وقایع مراجعه کنید.
خدمات رفاهی
کتابخانه کلاینت Perl شامل چند کلاس کاربردی برای بهبود قابلیت استفاده از API است. برای کسب اطلاعات بیشتر به راهنماهای زیر مراجعه کنید:
عملکرد برنامه خود را به طور دقیق تنظیم کنید
برای توصیههایی در مورد چگونگی تنظیم دقیق عملکرد برنامه خود، به راهنمای عملکرد مراجعه کنید.