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

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

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

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

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