تتم استضافة مكتبة عميل Python على GitHub، ويتوفّر الحزمة على PyPI.
المتطلبات
تتوافق المكتبة مع إصدارات Python من 3.9 إلى 3.14 (>=3.9, <3.15؛ تمت إضافة التوافق مع Python 3.14
في v28.2.0). بما أنّ Python 3.9 و3.10 يعرضان تحذيرًا بشأن الإيقاف نهائيًا
عند الاستيراد في google-ads v32.0.0 والإصدارات الأحدث، يُنصح باستخدام Python 3.11 أو
إصدار أحدث.
المتطلبات الأساسية
قبل مواصلة هذا الدليل، تحتاج إلى معرّف حساب العميل المكوّن من 10 أرقام في حسابك على "إعلانات Google".
التوافق مع وقت التشغيل والتبعيات
تحافظ مكتبة عميل Python على التوافق مع أوقات تشغيل Python في قسم الإصدارات المتوافقة الذي نشرته مؤسسة Python Software Foundation، باستثناء الإصدارات التي تحمل الحالة "ميزة" أو "إصدار تجريبي".
يهدف فريق العمل لواجهة برمجة التطبيقات 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
مراجع إضافية
بعد أن تتمكّن من إرسال طلب بيانات من واجهة برمجة التطبيقات، يمكنك الانتقال إلى حالات استخدام مكتبة العميل التالية: