تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتم استضافة مكتبة Perl للعملاء على GitHub، وتتوفّر الحزمة على CPAN.
تتوافق المكتبة مع الإصدار 5.28.1 أو الإصدارات الأحدث من Perl. لاستخدام هذه المكتبة، يجب أولاً استيفاء المتطلبات الأساسية.
بروتوكول REST API
باستخدام بروتوكول JSON REST عبر HTTP 1.1.
يتم إنشاء عناصر الفئات، مثل الخدمة والمورد والقائمة المحدودة والخطأ، في مكتبة برامج Perl للعملاء من خلال تحليل تعريفات بروتوكول المخزن المؤقت.
لمزيد من المعلومات حول كيفية تسلسل البيانات المنظَّمة، راجِع مستندات بروتوكول
buffer.
للتواصل مع Google Ads API، تنشئ مكتبة البرامج طلب HTTP بتنسيق JSON، وترسله إلى نقطة نهاية REST عبر HTTP 1.1، وتزيل تسلسل الرد ككائن JSON، وتفسّر النتائج.
تاريخ التعديل الأخير: 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."]]
