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

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

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

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

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

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

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

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

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

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

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

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

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

إنشاء ملف

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

حذف ملف

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

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

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

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

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

  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 وسجِّل الدخول فقط إلى الحساب الذي يتضمن الإضافة أو تطبيق الويب المطلوب الوصول إليهما.
    • افتح نافذة التصفح المتخفي في Google Chrome أو نافذة تصفح خاص مكافئة، وسجّل الدخول إلى حساب Google الذي يتضمن الإضافة أو تطبيق الويب الذي تريد الوصول إليه.