مستوى البرمجة: متوسّط
المدة: 30 دقيقة
نوع المشروع: إضافة Google Workspace
الأهداف
- فهم وظيفة الحلّ
- فهم وظيفة خدمات "برمجة تطبيقات Google" ضِمن الحلّ
- إعداد البيئة
- إعداد النص البرمجي
- تشغيل النص البرمجي
لمحة عن هذا الحلّ
يمكن أن يستغرق نسخ وحدات ماكرو "جداول بيانات Google" يدويًا من جدول بيانات إلى آخر وقتًا طويلاً وقد يؤدي إلى حدوث أخطاء. تنسخ إضافة Google Workspace هذه تلقائيًا مشروع نص برمجي وترفقه بجدول بيانات يحدّده المستخدم. على الرغم من أنّ هذا الحلّ يركّز على وحدات ماكرو "جداول بيانات Google"، يمكنك استخدامه لنسخ أي نص برمجي مرتبط بالحاوية ومشاركته.

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