تتم استضافة مكتبة برامج Python على GitHub، وتتوفّر الحزمة على PyPI.
المتطلبات
تتطلّب المكتبة الإصدار 3.9 من Python أو إصدارًا أحدث.
المتطلبات الأساسية
قبل المتابعة باستخدام هذا الدليل، يجب أن يتوفّر لك رمز مميز للمطوِّر لاستخدامه مع Google Ads API، ورقم تعريف العميل المكوّن من 10 أرقام لحسابك على "إعلانات Google".
التوافق مع وقت التشغيل والتبعيات
تحافظ مكتبة برامج Python على توافقها مع أوقات تشغيل Python المذكورة في قسم الإصدارات المتوافقة الذي نشرته مؤسسة Python Software Foundation، باستثناء الإصدارات التي تحمل الحالة "ميزة" أو "إصدار تجريبي".
نحرص على استخدام أحدث إصدارات وقت تشغيل Python فور طرحها واعتمادها رسميًا من مؤسسة Python Software Foundation.
لا تتوافق بيئات تشغيل Python التي انتهت مدة دعمها مع الإصدارات التي تلي تاريخ انتهاء مدة الدعم المذكور في قسم الإصدارات غير المتوافقة على موقع python.org. لا يمكننا ضمان التوافق مع أوقات التشغيل التي انتهى عمرها الافتراضي، لأنّه قد نصدر إصدارًا من المكتبة غير متوافق معها في أي وقت بعد تاريخ انتهاء عمرها الافتراضي.
بالنسبة إلى التبعيات (وتحديدًا أي حِزم تحتفظ بها Google ومدرَجة على أنّها مطلوبة من خلال مكتبة برامج Python)، سنحافظ على التوافق مع الحِزم التي تحتفظ بها Google والتي تُعدّ "متوافقة" وفقًا لسياسة التغيير غير المتوافق في برامج المصادر المفتوحة من Google.
للحصول على قائمة كاملة بأوقات تشغيل Python والتبعيات المتوافقة، راجِع صفحة التبعيات.
تثبيت
يوضّح دليل التثبيت جميع الطرق المختلفة لتثبيت المكتبة. أبسط طريقة (وننصح بها) لتثبيت المكتبة في تطبيقك هي استخدام pip:
$ python -m pip install google-ads
التهيئة
بعد تثبيت المكتبة، عليك إعدادها. تتوفّر عدّة طرق لإعداد المكتبة، وهي موضّحة في دليل الإعداد.
المصادقة
بعد اختيار طريقة الإعداد، يمكنك ضبط إعدادات المصادقة. للحصول على تعليمات تفصيلية، يُرجى الاطّلاع على دليل مصادقة مكتبة برامج عميل Python، وللحصول على معلومات أساسية أكثر عمومية، يُرجى الاطّلاع على نظرة عامة على OAuth.
تقديم طلب بيانات من واجهة برمجة التطبيقات
بعد إعداد خيار المصادقة، يمكنك تقديم طلب بيانات من واجهة برمجة التطبيقات. راجِع مثال get campaigns للتعرّف على طريقة سريعة لاختبار ما إذا كانت المكتبة معدّة بشكل صحيح لإجراء طلبات إلى واجهة برمجة التطبيقات.
لتشغيل نموذج get_campaigns.py، نفِّذ الأمر التالي في الدليل الجذر لمكتبة برنامج googleads-python المثبّتة على جهازك:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
مراجع إضافية
بعد أن تتمكّن من تقديم طلب بيانات من واجهة برمجة التطبيقات، يمكنك الانتقال إلى استخدامات مكتبة العميل التالية: