تشرح مبادئ التشغيل السريعة كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة التطبيقات في Google Workspace.
تستخدم الشركات الناشئة في Google Workspace مكتبات عملاء واجهة برمجة التطبيقات للتعامل مع بعض تفاصيل عملية المصادقة والترخيص. ننصح بما يلي: استخدام مكتبات البرامج لتطبيقاتك الخاصة. تستخدم هذه البدء السريع وهو نهج مصادقة مبسط مناسب للاختبار محددة. بالنسبة إلى بيئة الإنتاج، ننصحك بالاطّلاع على المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.
إنشاء برمجة تطبيقات Google التي ترسل طلبات إلى Google Chat API.
الأهداف
- اضبط البيئة.
- أنشئ النص البرمجي واضبطه.
- شغِّل النص البرمجي.
المتطلبات الأساسية
- حساب Business أو Enterprise على Google Workspace مع إمكانية الوصول إلى Google Chat
ضبط إعدادات مشروعك على Google Cloud
في حال استخدام مشروع جديد على Google Cloud لإكمال هذه البداية السريعة، عليك إجراء ما يلي: وتهيئته وإضافة نفسك كمستخدم تجريبي. إذا كنت قد قمت بالفعل هذه الخطوات لمشروعك على السحابة الإلكترونية، انتقِل إلى القسم التالي.
فتح مشروعك على Google Cloud في "وحدة تحكُّم Google Cloud"
افتح المشروع على Google Cloud الذي تريد استخدامه إذا لم يكن مفتوحًا. لهذا النموذج:
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة اختيار مشروع.
- اختَر المشروع على Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات الظاهرة على الشاشة. في حال إنشاء مشروع على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.
تفعيل Chat API
قبل استخدام Google APIs، يجب تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل Google Chat API.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات الخدمات > شاشة موافقة OAuth. .
- بالنسبة إلى نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
- أكمِل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج Google Workspace، عليك تغيير نوع المستخدم إلى خارجي، وبعد ذلك أضِف نطاقات الأذونات التي يتطلبها تطبيقك.
- مراجعة ملخّص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان التطبيق التسجيل يبدو على ما يرام، انقر على الرجوع إلى لوحة التحكم.
ضبط تطبيق 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
انقر على حفظ.
إنشاء النص البرمجي
- أنشِئ نصًا برمجيًا جديدًا من خلال الانتقال إلى script.google.com/create.
- استبدل محتوى محرر النصوص البرمجية بالرمز التالي:
- انقر على "حفظ"
.
- انقر على مشروع بلا عنوان، واكتب التشغيل السريع، والنقر على إعادة تسمية
ضبط النص البرمجي
نسخ رقم المشروع على Google Cloud
- في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > إدارة الهوية وإمكانية الوصول و المشرف > الإعدادات. .
- في حقل رقم المشروع، انسخ القيمة.
ربط مشروعك على Google Cloud
- افتح مشروع "برمجة تطبيقات Google".
- انقر على رمز إعدادات المشروع .
- ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
- في رقم مشروع Google Cloud Platform، الصِق رقم مشروع Google Cloud.
- انقر على ضبط المشروع.
تفعيل Google Chat API
- افتح مشروع "برمجة تطبيقات Google".
- انقر على رمز إعدادات المشروع .
- ضمن الإعدادات العامة، فعِّل الخيار عرض "appsscript.json" ملف البيان في المحرِّر.
- انقر على رمز المحرِّر
appscript.json
، واستبدل المحتويات بالتعليمة البرمجية التالية:
، ثم اختَر
الملف
تنفيذ النموذج
في محرِّر "برمجة تطبيقات Google"، انقر على تشغيل.
عند تشغيل النموذج لأول مرة، يطالبك بتفويض الوصول:
- انقر على مراجعة الأذونات.
- اختر حسابًا.
- انقر على سماح.
يظهر سجلّ تنفيذ النص البرمجي في أسفل النافذة.