نظرة عامة

تتم استضافة مكتبة برامج Python على GitHub، وتتوفّر الحزمة على PyPI.

المتطلبات

تتوافق المكتبة مع الإصدارات من 3.9 إلى 3.14 من Python (>=3.9, <3.15، تمت إضافة التوافق مع الإصدار 3.14 من Python في v28.2.0). بما أنّ الإصدارَين 3.9 و3.10 من Python يُصدران تحذيرًا بشأن الإيقاف النهائي عند الاستيراد في الإصدار google-ads من v32.0.0 والإصدارات الأحدث، ننصح باستخدام الإصدار 3.11 من Python أو الإصدارات الأحدث.

المتطلبات الأساسية

قبل المتابعة في هذا الدليل، تحتاج إلى رقم تعريف العميل المكوّن من 10 أرقام لحسابك على "إعلانات Google".

التوافق مع بيئة التشغيل والتبعية

تحافظ مكتبة برامج Python على التوافق مع بيئات تشغيل Python في قسم الإصدارات المتوافقة الذي تنشره مؤسسة Python Software Foundation، باستثناء الإصدارات التي تحمل الحالة "ميزة" أو "إصدار تجريبي".

يهدف فريق Google Ads API إلى اعتماد إصدارات جديدة من وقت تشغيل Python فور إصدارها وإتاحتها رسميًا من قِبل Python Software Foundation.

لا تتوفّر بيئات تشغيل Python التي وصلت إلى نهاية عمرها الافتراضي (EOL) بعد تاريخ نهاية العمر الافتراضي في قسم الإصدارات غير المتوافقة على 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

مراجع إضافية

بعد أن تتمكّن من إرسال طلب بيانات من واجهة برمجة التطبيقات، انتقِل إلى استخدامات مكتبة العميل التالية: