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