مستوى الترميز: متوسط
المدة: 30 دقيقة
نوع المشروع: إضافة Google Workspace
الأهداف
- فهم ما يفعله الحلّ.
- فهم ما تفعله خدمات برمجة التطبيقات ضمن الحلّ.
- إعداد البيئة
- قم بإعداد النص البرمجي.
- شغِّل النص البرمجي.
لمحة عن هذا الحلّ
قد يستغرق نسخ وحدات ماكرو "جداول بيانات Google" يدويًا من جدول بيانات إلى آخر وقتًا طويلاً ويكون عرضة للخطأ. تنسخ "إضافة Google Workspace" هذه مشروع نص برمجي تلقائيًا ويرفقه بجدول بيانات حدّده المستخدم. على الرغم من أنّ هذا الحل يركز على وحدات ماكرو "جداول بيانات Google"، يمكنك استخدامه لنسخ أي نص برمجي مرتبط بحاوية ومشاركته.
آلية العمل
ينسخ النص البرمجي مشروع "برمجة تطبيقات Google" المرتبط بجدول البيانات الأصلي وينشئ مشروعًا مكرّرًا في "برمجة تطبيقات Google" مرتبط بجدول البيانات الذي يحدده المستخدم.
خدمات "برمجة تطبيقات Google"
يستخدم هذا الحلّ الخدمات التالية:
- خدمة جلب عنوان URL - تتصل بواجهة برمجة تطبيقات برمجة التطبيقات لنسخ المشروع المصدر وإنشاء نسخة.
- خدمة النص البرمجي: يتم تفويض واجهة برمجة التطبيقات لبرمجة التطبيقات لتجنُّب طلب تفويض ثانٍ.
- خدمة جدول البيانات - تفتح جدول البيانات المستهدف لإضافة مشروع "برمجة تطبيقات Google" الذي تم نسخه.
- خدمة البطاقة: تنشئ واجهة مستخدم الإضافة.
المتطلبات الأساسية
لاستخدام هذا النموذج، يجب استيفاء المتطلبات الأساسية التالية:
- حساب على Google (قد تتطلب حسابات Google Workspace موافقة المشرف).
متصفح ويب يمكنه الوصول إلى الإنترنت.
تم تفعيل Google Apps Script API في إعدادات لوحة بيانات "برمجة تطبيقات Google".
إعداد البيئة
فتح مشروعك على Google Cloud في Google Cloud Console
إذا لم يكن المشروع مفتوحًا، افتح المشروع الذي تنوي استخدامه في هذا النموذج من خلال الخطوات التالية:
- في Google Cloud Console، انتقِل إلى صفحة اختيار مشروع.
- اختَر مشروع Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات الظاهرة على الشاشة. إذا أنشأت مشروعًا على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.
تفعيل واجهة برمجة التطبيقات لبرمجة Google Apps
تستخدم مرحلة البدء السريع هذه واجهة برمجة التطبيقات Google Apps Script API.
قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في مشروعك على Google Cloud، فعِّل واجهة برمجة التطبيقات Google Apps Script API.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
تتطلّب إضافات Google Workspace إعداد شاشة طلب الموافقة. عند ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth في الإضافة، يتم تحديد ما تعرضه Google للمستخدمين.
- في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.
- في حقل نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
- املأ نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج مؤسسة Google Workspace، عليك تغيير نوع المستخدم إلى خارجي، ثم إضافة نطاقات التفويض التي يتطلبها تطبيقك.
- مراجعة ملخص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو جيدًا، انقر على الرجوع إلى لوحة البيانات.
إعداد النص البرمجي
إنشاء مشروع "برمجة تطبيقات Google"
- انقر على الزر التالي لفتح مشروع مشاركة وحدة ماكرو
في "برمجة تطبيقات Google".
فتح المشروع - انقر على رمز نظرة عامة .
- في صفحة النظرة العامة، انقر على رمز إنشاء نسخة .
نسخ رقم المشروع على Google Cloud
- في Google Cloud Console، انتقِل إلى القائمة > إدارة الهوية وإمكانية الوصول والمشرف > الإعدادات.
- في حقل رقم المشروع، انسخ القيمة.
ضبط مشروع السحابة الإلكترونية لمشروع برمجة التطبيقات
- في مشروع برمجة التطبيقات المنسوخ، انقر على إعدادات المشروع .
- ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
- في رقم مشروع Google Cloud Platform، الصِق رقم مشروع Google Cloud.
- انقر على ضبط المشروع.
تثبيت نشر تجريبي
- في مشروع "برمجة تطبيقات Google" الذي تم نسخه، انقر على محرِّر .
- افتح ملف
UI.gs
وانقر على Run (تشغيل). امنح الإذن للنص البرمجي عندما يُطلب منك ذلك. - انقر على نشر > اختبار عمليات النشر.
- انقر على تثبيت > تم.
الحصول على معلومات جدول البيانات والنصوص البرمجية للماكرو
- افتح جدول بيانات في "جداول بيانات Google" يحتوي على وحدة ماكرو ولديك إذن بتعديله. لاستخدام نموذج جدول بيانات، أنشئ نسخة من جدول بيانات نموذج ماكرو.
- انقر على الإضافات > برمجة التطبيقات.
- في مشروع "برمجة تطبيقات Google"، انقر على إعدادات المشروع .
- ضمن رقم تعريف النص البرمجي، انقر على نسخ.
- خصِّص رقم تعريف النص البرمجي لاستخدامه في خطوة لاحقة.
- افتح أو أنشئ جدول بيانات جديدًا تريد إضافة وحدة الماكرو إليه. يجب أن يكون لديك إذن لتحرير جدول البيانات.
- انسخ عنوان URL لجدول البيانات واتركه جانبًا لاستخدامه في خطوة لاحقة.
تشغيل النص البرمجي
تأكّد من أن واجهة برمجة التطبيقات Google Apps Script API مُفعَّلة في إعدادات لوحة البيانات. خذ الخطوات الواردة في الأقسام التالية لتشغيل النص البرمجي.
نسخ وحدة الماكرو
- في "جداول بيانات Google"، افتح الإضافة "مشاركة ماكرو" على الشريط الجانبي الأيسر.
- ضمن ماكرو المصدر، الصِق رقم تعريف النص البرمجي.
- ضمن جدول البيانات المستهدَف، الصِق عنوان URL لجدول البيانات.
- انقر على مشاركة ماكرو.
- انقر على تفويض الوصول وتفويض الإضافة.
- كرر الخطوات من 2 إلى 4.
افتح وحدة الماكرو المنسوخة.
- وإذا لم يكن مفتوحًا من قبل، افتح جدول البيانات الذي نسخت وحدة الماكرو إليه.
- انقر على الإضافات > برمجة التطبيقات.
- إذا لم يظهر لك مشروع "برمجة تطبيقات Google" المنسوخ، تأكَّد من أنّ واجهة برمجة التطبيقات لبرمجة تطبيقات Google مُفعَّلة في إعدادات لوحة البيانات وكرِّر الخطوات الواردة ضمن نسخ الماكرو.
مراجعة الرمز
لمراجعة رمز برمجة التطبيقات لهذا الحلّ، انقر على عرض رمز المصدر أدناه:
عرض رمز المصدر
Code.gs
UI.gs
appsscript.json
المساهمون
تحتفظ Google بهذا النموذج بمساعدة خبراء التطوير في Google.