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