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

يمثّل مشروع النص البرمجي مجموعة من الملفات والموارد في برمجة تطبيقات Google، ويُشار إليه أحيانًا باسم "نص برمجي". يحتوي مشروع نص برمجي على ملف واحد أو أكثر من ملفات البرامج النصية التي يمكن أن تكون ملفات تعليمات برمجية (تحتوي على إضافة .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 هي أداة سطر أوامر تتيح إنشاء مشاريع برمجة تطبيقات وسحبها/دفعها ونشرها من Terminal.

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

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

بعد حذف مشروع برمجة تطبيقات مرتبط بحاوية، لا يمكن استعادته.

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

يمكن لمالك الحاوية فقط رؤية خيارات قائمة الحذف.

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

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

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

يوضّح هذا القسم كيفية إضافة الملفات وحذفها وتصديرها ضمن مشروع برمجة تطبيقات.

إنشاء ملف

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

حذف ملف

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

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

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

ضبط المنطقة الزمنية لمشروع

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

  1. افتح مشروعك في "برمجة تطبيقات Google".
  2. على يمين الصفحة، انقر على إعدادات المشروع رمز إعدادات المشروع.
  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 في الوقت نفسه لمشاريع برمجة التطبيقات أو الإضافات أو تطبيقات الويب.

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

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

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