با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
کتابخانه مشتری Perl در GitHub میزبانی می شود و بسته در CPAN در دسترس است.
این کتابخانه از پرل نسخه 5.28.1 یا بالاتر پشتیبانی می کند. برای استفاده از این کتابخانه، ابتدا پیش نیازها را تکمیل کنید.
پروتکل REST API
موجودیت های کلاس - مانند سرویس، منبع، enum و خطا - در کتابخانه مشتری Perl با تجزیه تعاریف بافر پروتکل تولید می شوند. برای کسب اطلاعات بیشتر در مورد نحوه سریال سازی داده های ساخت یافته، به مستندات بافر پروتکل مراجعه کنید.
برای ارتباط با Google Ads API، کتابخانه مشتری یک درخواست HTTP در JSON ایجاد می‌کند، آن را از طریق HTTP 1.1 به نقطه پایانی REST ارسال می‌کند، پاسخ را به‌عنوان یک شی JSON غیرمستقیم می‌کند و نتایج را تفسیر می‌کند.
استفاده
برای شروع استفاده از این کتابخانه به شروع و استفاده اولیه مراجعه کنید.
برای دریافت نشانه‌های تازه‌سازی OAuth2، به راهنماهای زیر مراجعه کنید:
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Perl client library for the Google Ads API is available on GitHub and CPAN, supporting Perl version 5.28.1 or greater.\u003c/p\u003e\n"],["\u003cp\u003eThis library uses the JSON REST protocol over HTTP 1.1 since gRPC is not supported with Perl.\u003c/p\u003e\n"],["\u003cp\u003eClient library classes are generated from protocol buffer definitions, enabling structured data serialization.\u003c/p\u003e\n"],["\u003cp\u003eUsage instructions and OAuth2 authentication guides are available in the provided links for various application flows.\u003c/p\u003e\n"]]],[],null,["# The Perl Client Library\n\nThe Perl client library is hosted on [GitHub](https://github.com/googleads/google-ads-perl), and the package is\navailable on [CPAN](//metacpan.org/release/Google-Ads-GoogleAds-Client).\n\nThe library supports Perl version 5.28.1 or greater. To use this library, first\ncomplete the [prerequisites](/google-ads/api/docs/get-started/introduction).\n\nREST API protocol\n-----------------\n\n| **Note:** The Google Ads API exposes both standard JSON REST endpoints and a high-performance [gRPC](//grpc.io) interface. Since Perl is not a [supported\n| language](//grpc.io/docs) in the gRPC stack, this client library is implemented on the JSON REST protocol over HTTP 1.1.\n\nClass entities---such as service, resource, enum, and error---in the\nPerl client library are generated by parsing the [protocol buffer\ndefinitions](//github.com/googleapis/googleapis/tree/master/google/ads/googleads).\nTo learn more about how structured data is serialized, refer to the [protocol\nbuffer documentation](/protocol-buffers/docs/overview).\n\nTo connect with the Google Ads API, the client library creates an HTTP request in\n[JSON](//www.json.org/json-en.html), sends it to the REST endpoint over HTTP\n1.1, deserializes the response as a JSON object, and interprets the results.\n\nUsage\n-----\n\nSee [Getting\nstarted](https://github.com/googleads/google-ads-perl/blob/HEAD/README.md#getting-started) and [Basic\nusage](https://github.com/googleads/google-ads-perl/blob/HEAD/README.md#basic-usage) to start using this\nlibrary.\n\nTo get OAuth2 refresh tokens, refer to the following guides:\n\n- [OAuth desktop application flow](/google-ads/api/docs/client-libs/perl/oauth-desktop)\n- [OAuth web application flow](/google-ads/api/docs/client-libs/perl/oauth-web)\n\nTo make API calls using OAuth2 service accounts, see the [OAuth service\naccount flow](/google-ads/api/docs/client-libs/perl/oauth-service) guide."]]
