يمثّل مشروع النص البرمجي مجموعة من الملفات والموارد في Google Apps Script، ويُشار إليه أحيانًا ببساطة باسم "نص برمجي". يحتوي مشروع البرنامج النصي على ملف واحد أو أكثر من ملفات البرامج النصية التي يمكن أن تكون ملفات رموز برمجية (تحتوي على الإضافة .gs) أو ملفات HTML (تحتوي على الإضافة .html). يمكنك أيضًا تضمين JavaScript وCSS في ملفات HTML.
تتضمّن أداة تعديل النصوص البرمجية مشروعًا واحدًا فقط مفتوحًا في أي وقت. يمكنك فتح مشاريع متعددة في نوافذ أو علامات تبويب متعددة في المتصفّح.
إنشاء المشاريع وحذفها
يوضّح هذا القسم كيفية إنشاء مشاريع Apps Script مستقلة أو مرتبطة بحاوية وحذفها.
إنشاء مشروع مستقل
لإنشاء مشروع مستقل من "برمجة تطبيقات Google"، اتّبِع الخطوات التالية:
- انتقِل إلى
script.google.com. - انقر على مشروع جديد.
- في محرّر النصوص البرمجية، انقر على مشروع بلا عنوان.
- أدخِل اسمًا لمشروعك وانقر على إعادة التسمية.
إنشاء مشروع مستقل من Google Drive
- افتح Google Drive.
- انقر على جديد > المزيد > برمجة تطبيقات Google.
إنشاء مشروع مرتبط بحاوية من "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"
- افتح مستندًا في "مستندات Google" أو جدول بيانات في "جداول بيانات Google" أو عرضًا تقديميًا في "العروض التقديمية من Google".
- انقر على الإضافات > برمجة تطبيقات Google.
- في محرّر النصوص البرمجية، انقر على مشروع بلا عنوان.
- أدخِل اسمًا لمشروعك وانقر على إعادة التسمية.
إنشاء مشروع مرتبط بحاوية من "نماذج Google"
- افتح نموذجًا في "نماذج Google".
- انقر على "المزيد" > محرّر النصوص البرمجية.
- في محرّر النصوص البرمجية، انقر على مشروع بلا عنوان.
- أدخِل اسمًا لمشروعك وانقر على إعادة التسمية.
إنشاء مشروع مستقل باستخدام أداة سطر الأوامر clasp
clasp هي أداة سطر أوامر تتيح لك إنشاء مشاريع Apps Script وسحبها/دفعها ونشرها من وحدة طرفية.
يمكنك الاطّلاع على دليل واجهة سطر الأوامر باستخدام clasp للحصول على مزيد من التفاصيل.
حذف مشروع مرتبط بحاوية
- افتح مشروعك المرتبط بالحاوية باستخدام الطريقة المناسبة أعلاه.
- في أعلى يمين الصفحة، انقر على نظرة عامة .
- في أعلى يسار الصفحة، انقر على "إزالة" > الحذف نهائيًا.
حذف مشروع مستقل
- انتقِل إلى
script.google.com. - على يسار المشروع الذي تريد حذفه، انقر على "المزيد" > إزالة > إزالة.
إدارة الملفات في مشروع
إنشاء ملف
- افتح مشروعك في "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على أداة التعديل > إضافة .
- اختَر نوع الملف الذي تريد إنشاءه وأدخِل اسمًا له.
حذف ملف
- افتح مشروعك في "برمجة تطبيقات Google".
- على يمين الشاشة، انقر على أداة التعديل .
- بجانب الملف الذي تريد حذفه، انقر على "المزيد" > حذف.
تصدير الملفات من مشروع "برمجة تطبيقات Google"
لإخراج ملفات الرموز البرمجية من Apps Script، يمكنك نسخ الرمز البرمجي ولصقه من كل ملف في محرّر النصوص المفضّل لديك أو استخدام clasp على سطر الأوامر. لاستخدام clasp، يُرجى الرجوع إلى تنزيل مشروع نص برمجي.
ضبط المنطقة الزمنية لمشروع
يمكنك ضبط المنطقة الزمنية لمشروع "برمجة التطبيقات". تستخدِم الدوال التي ينفّذها النص البرمجي هذه المنطقة الزمنية.
- افتح مشروعك في "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على إعدادات المشروع
. - في قسم المنطقة الزمنية، اختَر المنطقة الزمنية التي تريد استخدامها.
إذا كنت تريد أن تستخدم دالة معيّنة منطقة زمنية مختلفة عن المنطقة الزمنية لمشروع النص البرمجي، أدخِل المنطقة الزمنية بشكل صريح في الدالة. على سبيل المثال، في النموذج أدناه، تنشئ كل دالة حدثًا جديدًا في "تقويم Google". تكون المنطقة الزمنية التلقائية للدالة الأولى هي المنطقة الزمنية للمشروع. تحدّد الدالة الثانية المنطقة الزمنية لتوقيت المحيط الهادئ، وبالتالي يتم تحديد موعد الحدث وفقًا لتوقيت المحيط الهادئ، بغض النظر عن المنطقة الزمنية للمشروع.
function createEvent(){ // Creates an event in the script project's time zone and logs the ID var event = CalendarApp.getDefaultCalendar().createEvent('New test event', new Date('December 20, 2022 17:00:00'), new Date('December 20, 2022 18:00:00')); console.log('Event ID: ' + event.getId()); } function createEventPacific(){ // Creates an event with a specified time zone and logs the event ID. var event = CalendarApp.getDefaultCalendar().createEvent('New sample event', new Date('December 20, 2022 17:00:00 PDT'), new Date('December 20, 2022 18:00:00 PDT')); console.log('Event ID: ' + event.getId()); } حلّ المشاكل المتعلّقة بحسابات Google المتعددة
إذا سجّلت الدخول إلى حسابات متعددة على Google في الوقت نفسه، قد تواجه مشاكل في الوصول إلى الإضافات وتطبيقات الويب. لا يتوفر تسجيل الدخول المتعدد أو تسجيل الدخول إلى حسابات Google متعددة في الوقت نفسه لمشاريع برمجة التطبيقات أو الإضافات أو تطبيقات الويب.
إذا فتحت محرّر "برمجة تطبيقات Google" أثناء تسجيل الدخول إلى أكثر من حساب واحد، سيطلب منك Google اختيار الحساب الذي تريد المتابعة باستخدامه.
إذا فتحت تطبيق ويب أو إضافة وواجهت مشاكل في تسجيل الدخول المتعدد، جرِّب أحد الحلول التالية:
- سجِّل الخروج من جميع حساباتك على Google وسجِّل الدخول إلى الحساب الذي يحتوي على الإضافة أو تطبيق الويب الذي تريد الوصول إليه فقط.
- افتح نافذة للتصفُّح المتخفي في Google Chrome أو نافذة تصفُّح بخصوصيّة تامّة، وسجِّل الدخول إلى حساب Google الذي يتضمّن الإضافة أو تطبيق الويب الذي تريد الوصول إليه.