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