يمكنك إنشاء إضافات Google Workspace في Cloud Functions باستخدام وقت تشغيل Node.js.
الأهداف
- إعداد البيئة
- إنشاء دالة Cloud ونشرها.
- إنشاء الإضافة ونشرها.
- ثبِّت الإضافة.
المتطلبات الأساسية
- مشروع على Google Cloud:
- تأكَّد من تفعيل الفوترة لمشروعك على Google Cloud. تعرَّف على كيفية التحقّق من حالة الفوترة لمشاريعك.
- تم ضبط SDK للسحابة الإلكترونية مع المشروع على السحابة الإلكترونية
إعداد البيئة
فتح مشروعك على Google Cloud في Google Cloud Console
- في Google Cloud Console، انتقِل إلى صفحة اختيار مشروع.
- اختَر مشروع Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات الظاهرة على الشاشة. إذا أنشأت مشروعًا على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
تتطلّب إضافات Google Workspace إعداد شاشة طلب الموافقة. عند ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth في الإضافة، يتم تحديد ما تعرضه Google للمستخدمين.
- في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.
- في حقل نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
- املأ نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج مؤسسة Google Workspace، عليك تغيير نوع المستخدم إلى خارجي، ثم إضافة نطاقات التفويض التي يتطلبها تطبيقك.
- مراجعة ملخص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو جيدًا، انقر على الرجوع إلى لوحة البيانات.
إنشاء دالة Cloud ونشرها
في وحدة طرفية محلية، فعِّل Cloud Functions وCloud Build وGoogle Workspace Add-ons API:
gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
في دليل فارغ، أنشِئ الملف
function.js
باستخدام الرمز النموذجي التالي:/** * Cloud Function that loads the homepage for a * Google Workspace Add-on. * * @param {Object} req Request sent from Google * @param {Object} res Response to send back */ exports.loadHomePage = function addonsHomePage (req, res) { res.send(createAction()); }; /** Creates a card with two widgets. */ function createAction() { return { "action": { "navigations": [ { "pushCard": { "header": { "title": "Cats!" }, "sections": [ { "widgets": [ { "textParagraph": { "text": "Your random cat:" } }, { "image": { "imageUrl": "https://cataas.com/cat" } } ] } ] } } ] } }; }
نشر الدالة:
gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http
حدِّد أنك لا تسمح بالاستدعاءات غير المُصدَّق عليها للدالة، إذا طُلب منك ذلك. قد يستغرق نشر الدالة بضع دقائق.
إنشاء عملية نشر إضافة
ابحث عن البريد الإلكتروني لحساب الخدمة للإضافة:
gcloud workspace-add-ons get-authorization
منح حساب الخدمة الدور "
cloudfunctions.invoker
":gcloud functions add-iam-policy-binding loadHomePage \ --role roles/cloudfunctions.invoker \ --member serviceAccount:SERVICE_ACCOUNT_EMAIL
احصل على عنوان URL للدالة المنشورة. للحصول على عنوان URL، شغِّل الأمر التالي وابحث عن الحقل
url
ضمن القسمhttpsTrigger
:gcloud functions describe loadHomePage
أنشئ الملف
deployment.json
باستخدام الرمز النموذجي التالي. استبدِلURL
بعنوان URL للدالة المنشورة من الخطوة السابقة.{ "oauthScopes": ["https://www.googleapis.com/auth/gmail.addons.execute"], "addOns": { "common": { "name": "My HTTP Add-on", "logoUrl": "https://raw.githubusercontent.com/webdog/octicons-png/main/black/beaker.png", "homepageTrigger": { "runFunction": "URL" } }, "gmail": {}, "drive": {}, "calendar": {}, "docs": {}, "sheets": {}, "slides": {} } }
إنشاء عملية النشر:
gcloud workspace-add-ons deployments create quickstart \ --deployment-file=deployment.json
تثبيت الإضافة
تثبيت النشر في وضع التطوير:
gcloud workspace-add-ons deployments install quickstart
افتح Gmail أو أعِد تحميله لعرض الإضافة. في شريط الأدوات على اليمين، ابحث عن أيقونة دورق.
انقر على الرمز لفتح الإضافة. امنح الإذن الإضافي إذا طُلب منك ذلك.
اختياري: إخلاء مساحة تخزين
لتجنب تكبد رسوم على حسابك، احذف الموارد التي أنشأتها:
إلغاء تثبيت الإضافة من حسابك على Google:
gcloud workspace-add-ons deployments uninstall quickstart
لتجنب تكبد رسوم مقابل الموارد المستخدمة في هذا البدء السريع، احذف المشروع Cloud:
gcloud projects delete PROJECT_ID
استبدِل PROJECT_ID بمعرّف المشروع على السحابة الإلكترونية الذي استخدمته للبدء السريع. يمكنك العثور على رقم تعريف المشروع على Google Cloud في "وحدة تحكُّم Google Cloud" في صفحة لوحة البيانات.
الخطوات التالية
لإضافة المزيد من الوظائف إلى "إضافة Google Workspace"، يُرجى الاطّلاع على الأدلة التالية: