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

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

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

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

يوضِّح هذا القسم كيفية إنشاء مشاريع Apps Script مستقلة أو مرتبطة بحاويات وحذفها.

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

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

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

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

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

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

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

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

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

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

‫clasp هي أداة سطر أوامر تتيح لك إنشاء مشاريع Apps Script وسحبها أو دفعها ونشرها من وحدة طرفية.

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

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

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

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

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

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

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

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

إنشاء ملف

1. افتح مشروعك في Apps Script.
2. على يمين الصفحة، انقر على أداة التعديل > إضافة .
3. اختَر نوع الملف الذي تريد إنشاؤه وامنحه اسمًا.

حذف ملف

لا يمكن استرداد الملفات المحذوفة.

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

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

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

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

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

1. افتح مشروعك في Apps Script.
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 متعددة في الوقت نفسه لمشاريع برمجة التطبيقات أو الإضافات أو تطبيقات الويب.

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

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

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