نظرة عامة

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

قدَّم الإصدار 10.0.0 من مكتبة البرامج عددًا من التغييرات في الواجهة التي وثّقناها في إصدار المكتبة 10.0.0 .

المتطلبات

تتطلب المكتبة توفُّر الإصدار Python 3.8 أو إصدار أحدث.

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

قبل تثبيت المكتبة، ستحتاج إلى رمز مميز للمطوِّر معرف العميل الخاص بالعميل. وقد تم توضيح التعليمات حول كيفية الحصول عليها في المتطلبات الأساسية. تجدر الإشارة إلى أنّه سيتم إنشاء رموز OAuth2 المميزة الأخرى المطلوبة في الخطوات اللاحقة.

تثبيت

اتّبع التعليمات الواردة في التثبيت. لتثبيت المكتبة من PyPi والعودة إلى هذه الصفحة.

الإعداد

بعد تثبيت المكتبة، عليك ضبط إعدادات بها. وهناك العديد من الطرق لتهيئة المكتبة، كما هو موضح في التكوين.

المصادقة

بعد اختيار نوع الإعداد، يمكنك متابعة إنشاء رموز OAuth2 المميزة المتبقية واللازمة لتقديم طلبات إلى واجهة برمجة التطبيقات. هناك العديد من مسارات OAuth2 المتوافقة، والموثَّقة في القائمة أدناه. للحصول على تفاصيل حول الاختلافات بين التدفقات وتساعد في تحديد الأفضل الاطلاع على وثائق OAuth.

• مسارات بروتوكول OAuth لسطح المكتب وتطبيق الويب
• مسار حساب خدمة OAuth

تقديم طلب بيانات من واجهة برمجة التطبيقات

بعد دمج رموز OAuth2 المميزة في التهيئة، تصبح على استعداد لتقديم طلب واجهة برمجة التطبيقات. ارجع إلى مثال على الحصول على حملات طريقة بسيطة لاختبار تهيئة المكتبة بشكل صحيح لجعل واجهة برمجة التطبيقات الطلبات.

لتشغيل النموذج get_campaigns.py، في الدليل الجذر من جهازك تم تثبيت مكتبة برامج googleads-python، شغِّل الأمر التالي:

$ python examples/basic_operations/get_campaigns.py -c \
  INSERT_YOUR_CUSTOMER_ID_HERE

مراجع إضافية

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

• التسجيل
• أقنعة الميدان
• أسماء الموارد
• أدوات استرداد Proto
• ضبط حقول رسائل فارغة