تشرح مبادئ التشغيل السريعة كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة التطبيقات في Google Workspace.
تستخدم الشركات الناشئة في Google Workspace مكتبات عملاء واجهة برمجة التطبيقات للتعامل مع بعض تفاصيل عملية المصادقة والترخيص. ننصح بما يلي: استخدام مكتبات البرامج لتطبيقاتك الخاصة. تستخدم هذه البدء السريع وهو نهج مصادقة مبسط مناسب للاختبار محددة. بالنسبة إلى بيئة الإنتاج، ننصحك بالاطّلاع على المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.
أنشئ تطبيق سطر أوامر بايثون يقدم الطلبات إلى واجهة برمجة تطبيقات "مستندات Google".
الأهداف
- إعداد البيئة.
- تثبيت مكتبة البرامج
- إعداد العيّنة
- نفِّذ النموذج.
المتطلبات الأساسية
لتشغيل هذا البدء السريع، تحتاج إلى المتطلبات الأساسية التالية:
- Python 3.10.7 أو أحدث
- النافذة ضمن النافذة أداة إدارة الحِزم
- مشروع على Google Cloud:
- حساب Google
إعداد البيئة
لإكمال هذا البدء السريع، عليك إعداد البيئة الخاصة بك.
تفعيل واجهة برمجة التطبيقات
قبل استخدام Google APIs، يجب تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في وحدة تحكُّم Google Cloud، فعِّل Google Docs API.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
إذا كنت تستخدم مشروعًا جديدًا على Google Cloud لإكمال هذه البدء السريع، عليك ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth وإضافة نفسك كمستخدم تجريبي. إذا كنت قد قمت بالفعل أكملت هذه الخطوة لمشروعك على السحابة الإلكترونية، انتقِل إلى القسم التالي.
- في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات الخدمات > شاشة موافقة OAuth. .
- بالنسبة إلى نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
- أكمِل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج Google Workspace، عليك تغيير نوع المستخدم إلى خارجي، وبعد ذلك أضِف نطاقات الأذونات التي يتطلبها تطبيقك.
- مراجعة ملخّص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان التطبيق التسجيل يبدو على ما يرام، انقر على الرجوع إلى لوحة التحكم.
مصادقة بيانات الاعتماد لتطبيق سطح المكتب
لمصادقة المستخدمين النهائيين والوصول إلى بيانات المستخدمين في تطبيقك، عليك إجراء ما يلي: إنشاء معرِّف عميل OAuth 2.0 واحد أو أكثر. يُستخدم معرف العميل لتحديد تطبيقًا واحدًا بخوادم OAuth في Google. إذا كان تطبيقك يعمل على أنظمة أساسية متعدّدة عليك إنشاء معرِّف عميل منفصل لكل منصّة.- في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات الخدمات > بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
- انقر على نوع التطبيق > تطبيق الكمبيوتر المكتبي.
- في حقل الاسم، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في وحدة تحكُّم Google Cloud.
- انقر على إنشاء. تظهر الشاشة التي تم إنشاؤها من خلال عميل OAuth، وتعرض معرِّف العميل الجديد وسر العميل.
- انقر على موافق. تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن معرّفات عميل OAuth 2.0.
- احفظ ملف JSON الذي تم تنزيله باسم
credentials.json
، وانقل إلى دليل العمل.
تثبيت مكتبة برامج Google
تثبيت مكتبة برامج Google للغة Python:
pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib
ضبط النموذج
- في دليل العمل، أنشِئ ملفًا باسم "
quickstart.py
". أدرِج الرمز التالي في
quickstart.py
:
تنفيذ النموذج
في دليل العمل، أنشئ النموذج وشغِّله:
python3 quickstart.py
-
عند تشغيل النموذج لأول مرة، يطالبك بتفويض الوصول:
- إذا لم تكن مسجِّلاً الدخول إلى حسابك على Google، سجِّل الدخول عندما يُطلب منك ذلك. في حال حذف سجّلت الدخول إلى حسابات متعددة، اختَر حسابًا واحدًا لاستخدامه في عملية التفويض.
- انقر على قبول.
عند تشغيل تطبيق Python، يطلب منك Google Docs API.
يتم تخزين معلومات التفويض في نظام الملفات، لذا عندما تقوم بتشغيل النموذج في المرة التالية الرمز، فلن يُطلب منك منح الإذن.
الخطوات التالية
- تحديد مشاكل المصادقة والترخيص وحلّها
- المستندات المرجعية لواجهة برمجة التطبيقات في "مستندات Google"
- مستندات برنامج Google APIs للغة Python
- مستندات PyDoc لواجهة برمجة تطبيقات "مستندات Google"