تشرح مبادئ التشغيل السريعة كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة التطبيقات في Google Workspace.
تستخدم الشركات الناشئة في Google Workspace مكتبات عملاء واجهة برمجة التطبيقات للتعامل مع بعض تفاصيل عملية المصادقة والترخيص. ننصح بما يلي: استخدام مكتبات البرامج لتطبيقاتك الخاصة. تستخدم هذه البدء السريع وهو نهج مصادقة مبسط مناسب للاختبار محددة. بالنسبة إلى بيئة الإنتاج، ننصحك بالاطّلاع على المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.
أنشِئ تطبيق سطر أوامر Python لإرسال طلبات إلى Google Chat API.
الأهداف
- إعداد البيئة.
- تثبيت مكتبة البرامج
- إعداد العيّنة
- نفِّذ النموذج.
المتطلبات الأساسية
لتشغيل هذا البدء السريع، تحتاج إلى المتطلبات الأساسية التالية:
- Python 3.10.7 أو أحدث
- النافذة ضمن النافذة أداة إدارة الحِزم
- مشروع على Google Cloud:
- حساب Business أو Enterprise على Google Workspace مع إمكانية الوصول إلى Google Chat
إعداد البيئة
لإكمال هذا البدء السريع، عليك إعداد البيئة الخاصة بك.
تفعيل واجهة برمجة التطبيقات
قبل استخدام Google APIs، يجب تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل Google Chat 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 Chat
لاستدعاء Google Chat API، يجب ضبط تطبيق Google Chat بالنسبة إلى أي طلبات كتابة، يمكن لتطبيق Google Chat تطبيق Google Chat على واجهة المستخدم باستخدام المعلومات التالية.
في Google Cloud Console، انتقِل إلى صفحة ضبط واجهة Chat API:
ضمن معلومات التطبيق، أدخِل المعلومات التالية:
- في الحقل اسم التطبيق، أدخِل
Chat API quickstart app
. - في حقل عنوان URL للصورة الرمزية، أدخل
https://developers.google.com/chat/images/quickstart-app-avatar.png
- في حقل الوصف، أدخِل
Quickstart for calling the Chat API
.
- في الحقل اسم التطبيق، أدخِل
ضمن الميزات التفاعلية، انقر على تفعيل الميزات التفاعلية. لإيقاف الميزات التفاعلية تطبيق Chat
انقر على حفظ.
تثبيت مكتبة برامج Google
تثبيت مكتبة برامج Google للغة Python:
pip install --upgrade google-apps-chat google-auth-httplib2 google-auth-oauthlib
ضبط النموذج
- في دليل العمل، أنشِئ ملفًا باسم "
quickstart.py
". أدرِج الرمز التالي في
quickstart.py
:
تنفيذ النموذج
في دليل العمل، أنشئ النموذج وشغِّله:
python3 quickstart.py
-
عند تشغيل النموذج لأول مرة، يطالبك بتفويض الوصول:
- إذا لم تكن مسجِّلاً الدخول إلى حسابك على Google، سجِّل الدخول عندما يُطلب منك ذلك. في حال حذف سجّلت الدخول إلى حسابات متعددة، اختَر حسابًا واحدًا لاستخدامه في عملية التفويض.
- انقر على قبول.
عند تشغيل تطبيق Python، يطلب منك Google Chat API.
يتم تخزين معلومات التفويض في نظام الملفات، لذا عندما تقوم بتشغيل النموذج في المرة التالية الرمز، فلن يُطلب منك منح الإذن.