مشاريع النصوص البرمجية

يمثل مشروع النص البرمجي مجموعة من الملفات والموارد في لغة برمجة Google Apps، ويُشار إليها أحيانًا باسم "نص برمجي". مشروع نص يحتوي على ملف نص برمجي واحد أو أكثر يمكن أن يكون إما ملفات ترميز (يحتوي على .gs ) أو ملفات HTML (امتداد .html). يمكنك أيضًا تضمين JavaScript وCSS في ملفات HTML.

لدى محرر النصوص البرمجية دائمًا مشروع واحد فقط مفتوح في أي وقت. يمكنك فتح مشاريع متعدّدة في نوافذ أو علامات تبويب متصفّح متعددة.

إنشاء المشاريع وحذفها

يوضح هذا القسم كيفية إنشاء وحذف قوائم التشغيل المستقلة أو مشاريع برمجة التطبيقات المرتبطة بالحاويات.

إنشاء مشروع مستقل

لإنشاء مشروع مستقل من "برمجة تطبيقات Google"، اتّبِع الخطوات التالية:

  1. انتقِل إلى script.google.com.
  2. انقر على مشروع جديد.
  3. في أداة تعديل النصوص البرمجية، انقر على مشروع بلا عنوان.
  4. أدخِل اسمًا لمشروعك وانقر على إعادة تسمية.

إنشاء مشروع مستقل من Google Drive

  1. افتَح Google Drive.
  2. انقر على جديد > المزيد > برمجة تطبيقات Google.

إنشاء مشروع مرتبط بحاوية من "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"

  1. افتح مستندًا في "مستندات Google" أو جدول بيانات في "جداول بيانات Google" أو "العروض التقديمية من Google".
  2. انقر على الإضافات > برمجة تطبيقات Google.
  3. في أداة تعديل النصوص البرمجية، انقر على مشروع بلا عنوان.
  4. أدخِل اسمًا لمشروعك وانقر على إعادة تسمية.

إنشاء مشروع مرتبط بحاوية من "نماذج Google"

  1. افتح نموذجًا في "نماذج Google".
  2. انقر على رمز المزيد . > أداة تعديل النصوص البرمجية.
  3. في أداة تعديل النصوص البرمجية، انقر على مشروع بلا عنوان.
  4. أدخِل اسمًا لمشروعك وانقر على إعادة تسمية.

إنشاء مشروع مستقل باستخدام أداة سطر الأوامر clasp

clasp هي أداة سطر أوامر تتيح لك إنشاء التطبيقات وسحبها/دفعها ونشرها مشاريع النصوص البرمجية من الوحدة الطرفية

الاطّلاع على دليل سطر الأوامر باستخدام دليل clasp لمزيد من التفاصيل.

حذف مشروع مرتبط بالحاويات

  1. افتح مشروعك المرتبط بالحاويات باستخدام الطريقة المناسبة أعلاه.
  2. في أعلى يمين الصفحة، انقر على رمز نظرة عامة .
  3. في أعلى يسار الصفحة، انقر على رمز الإزالة >. الحذف نهائيًا.
.

حذف مشروع مستقل

  1. انتقِل إلى script.google.com.
  2. على يسار المشروع الذي تريد حذفه، انقر على "المزيد". إزالة > إزالة.

إدارة الملفات في مشروع

إنشاء ملف

  1. افتح مشروع "برمجة تطبيقات Google".
  2. على يمين الصفحة، انقر على أداة التعديل >. إضافة
  3. اختَر نوع الملف الذي تريد إنشاءه وأدخِل اسمًا له.

حذف ملف

  1. افتح مشروع "برمجة تطبيقات Google".
  2. على يمين الصفحة، انقر على رمز المحرِّر .
  3. بجانب الملف الذي تريد حذفه، انقر على "المزيد". حذف

تصدير الملفات خارج مشروع "برمجة تطبيقات Google"

لاستخراج ملفات الرموز من "برمجة تطبيقات Google"، يمكنك نسخ الرمز ولصقه. من كل ملف إلى محرر النصوص المفضل لديك أو استخدم المشبك في سطر الأوامر. لاستخدام المشبك، يمكنك الرجوع إلى مقالة تنزيل مشروع النص البرمجي.

تحديد المنطقة الزمنية لمشروع

يمكنك ضبط المنطقة الزمنية لمشروع "برمجة تطبيقات Google". الدوال التي تنفذها دالة البرنامج النصي هذه المنطقة الزمنية.

  1. افتح مشروع "برمجة تطبيقات Google".
  2. على يمين الصفحة، انقر على إعدادات المشروع (Project Settings). رمز إعدادات المشروع
  3. في قسم المنطقة الزمنية، اختَر المنطقة الزمنية التي تريد استخدامها.

إذا كنت تريد أن تستخدم دالة معينة منطقة زمنية مختلفة عن النص البرمجي المشروع، أدخل المنطقة الزمنية في دالتك بوضوح. على سبيل المثال، في العنصر أسفل النموذج، تنشئ كل دالة حدثًا جديدًا في تقويم 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 متعددة في آنٍ واحد، غير معتمد في Apps نص برمجي أو إضافات أو تطبيقات ويب.

  • إذا فتحت محرِّر "برمجة تطبيقات Google" أثناء تسجيل الدخول إلى أكثر من حساب، الطلبات من Google عليك اختيار الحساب الذي ترغب في مواصلة استخدامه.

  • إذا فتحت تطبيق ويب أو إضافة وواجهت مشاكل في تسجيل الدخول المتعدد، جرِّب إحدى الحلول التالية:

    • اخرج من جميع حسابات Google، ولا تسجِّل الدخول إلا إلى الحساب الذي يحتوي على أو إضافة أو تطبيق ويب تريد الوصول إليه.
    • افتح نافذة للتصفح المتخفي في Google Chrome، أو أي تصفح خاص مكافئ ، وقم بتسجيل الدخول إلى حساب Google الذي يتضمن الإضافة أو تطبيق الويب نريد الوصول إليها.