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

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

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

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

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

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

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

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

إنشاء ملف

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

حذف ملف

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

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

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

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

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

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