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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

إنشاء مشروع من Google Drive

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

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

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

إنشاء مشروع من "نماذج Google"

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

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

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

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

إنشاء مشروع من الإصدار الكلاسيكي من "مواقع Google"

  1. افتح موقعًا كلاسيكيًا مصممًا في مواقع Google.
  2. انقر على المزيد واختَر إدارة الموقع الإلكتروني.
  3. على يمين الصفحة، انقر على برمجة التطبيقات &gt؛ إضافة نص برمجي جديد.
  4. في أعلى يمين محرّر النص البرمجي، انقر على مشروع بلا عنوان.
  5. أدخِل اسمًا لمشروعك وانقر على إعادة تسمية.

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

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

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

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

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

إنشاء ملف

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

حذف ملف

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

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

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