هذه هي مكتبة عميل Google API Python لواجهات برمجة التطبيقات المستندة إلى اكتشاف Google. للبدء، يرجى الاطلاع على مجلد المستندات.
تعتبر هذه المكتبة كاملة وهي في وضع الصيانة. وهذا يعني أننا سنعالج الأخطاء الحرجة والمشكلات الأمنية ولكننا لن نضيف أي ميزات جديدة.
هذه المكتبة مدعومة رسميًا من قبل Google. ومع ذلك، يوصي المشرفون على هذا المستودع باستخدام Cloud Client Libraries لـ Python، حيثما أمكن، لتطوير تعليمات برمجية جديدة. لمزيد من المعلومات، يرجى زيارة مكتبات العميل الموضحة.
يتضمن الإصدار 2.0 من google-api-python-client
تحسينًا كبيرًا في الموثوقية، مقارنةً بالإصدار 1.x، حيث يتم الآن تخزين مستندات الاكتشاف مؤقتًا في المكتبة بدلاً من جلبها ديناميكيًا. يوصى بشدة بالترقية من الإصدار v1.x إلى الإصدار v2.x.
يتم دعم إصدار python 3.7 والأحدث فقط. إذا لم تتمكن من ترقية python، فيرجى الاستمرار في استخدام الإصدار 1.x لأننا سنواصل دعم python 2.7+ في الإصدار 1.
لن يتم استرداد مستندات الاكتشاف ديناميكيًا بعد الآن عند استدعاء discovery.build()
. سيتم بدلاً من ذلك استرداد مستندات الاكتشاف من مكتبة العميل مباشرةً. يتم إصدار إصدارات جديدة من هذه المكتبة أسبوعيًا. نتيجة للتخزين المؤقت لمستندات الاكتشاف، أصبح حجم هذه الحزمة أكبر بمقدار 50 ميجا بايت على الأقل مقارنة بالإصدار السابق.
يرجى الاطلاع على دليل الهجرة لمزيد من المعلومات.
راجع مجلد المستندات للحصول على تعليمات أكثر تفصيلاً ووثائق إضافية.
يوصي المشرفون على هذا المستودع باستخدام Cloud Client Libraries لـ Python، حيثما أمكن، لتطوير تعليمات برمجية جديدة للأسباب التالية:
مع مكتبات Cloud Client لـ Python:
google-api-python-client
عبارة عن مكتبة عميل واحدة لجميع واجهات برمجة التطبيقات. ونتيجة لذلك، يتجاوز الحجم الإجمالي للحزمة google-api-python-client
50 ميغابايت.لمزيد من المعلومات، يرجى زيارة مكتبات العميل الموضحة.
على الرغم من وجود العديد من الفوائد للانتقال إلى Cloud Client Libraries for Python، إلا أن المشرفين يريدون التأكيد على أن google-api-python-client
سيستمر في الدعم.
بالنسبة إلى Google Ads API، نوصي باستخدام مكتبة عملاء Google Ads API للغة Python.
بالنسبة إلى Google Firebase Admin API، نوصي باستخدام Firebase Admin Python SDK.
قم بتثبيت هذه المكتبة في Virtualenv باستخدام النقطة. Virtualenv هي أداة لإنشاء بيئات بايثون معزولة. المشكلة الأساسية التي يعالجها هي مشكلة التبعيات والإصدارات والأذونات بشكل غير مباشر.
باستخدام virtualenv، من الممكن تثبيت هذه المكتبة دون الحاجة إلى أذونات تثبيت النظام، ودون التعارض مع تبعيات النظام المثبتة.
pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client
pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client
يتم دعم واختبار Python 3.7 و3.8 و3.9 و3.10 و3.11 و3.12 بشكل كامل. قد تعمل هذه المكتبة على الإصدارات الأحدث من الإصدار 3، ولكننا لا نقوم حاليًا بإجراء اختبارات على تلك الإصدارات.
بايثون <3.7
سيتم تثبيت المكتبات التالية عند تثبيت مكتبة العميل:
للتطوير ستحتاج أيضًا إلى المكتبات التالية:
يرجى الاطلاع على دليل المساهمة لدينا. على وجه الخصوص، نحن نحب طلبات السحب - ولكن يرجى التأكد من التوقيع على اتفاقية ترخيص المساهم.