پروژه های اسکریپت

یک پروژه اسکریپت مجموعه‌ای از فایل‌ها و منابع را در Google Apps Script نشان می‌دهد که گاهی اوقات به سادگی به عنوان یک اسکریپت شناخته می‌شود. یک پروژه اسکریپت دارای یک یا چند فایل اسکریپت است که می تواند فایل های کد (با پسوند .gs ) یا فایل های HTML (پسوند .html ) باشد. همچنین می توانید جاوا اسکریپت و CSS را در فایل های HTML قرار دهید.

ویرایشگر اسکریپت همیشه یک و تنها یک پروژه را در هر زمان مشخص دارد. می توانید چندین پروژه را در چندین پنجره مرورگر یا تب باز کنید.

ایجاد و حذف پروژه ها

این بخش نحوه ایجاد و حذف پروژه های Apps Script مستقل یا محدود به کانتینر را توضیح می دهد.

یک پروژه مستقل ایجاد کنید

برای ایجاد یک پروژه مستقل از Apps Script:

  1. به script.google.com بروید.
  2. روی پروژه جدید کلیک کنید.
  3. در ویرایشگر اسکریپت، روی پروژه Untitled کلیک کنید.
  4. به پروژه خود یک نام بدهید و روی تغییر نام کلیک کنید.

یک پروژه مستقل از Google Drive ایجاد کنید

  1. Google Drive را باز کنید.
  2. روی New > More > Google Apps Script کلیک کنید.

یک پروژه محدود به کانتینر از Google Docs، Sheets یا Slides ایجاد کنید

  1. یک سند Docs، یک صفحه گسترده Sheets یا ارائه اسلایدها را باز کنید.
  2. روی برنامه‌های افزودنی > اسکریپت برنامه‌های Google کلیک کنید.
  3. در ویرایشگر اسکریپت، روی پروژه Untitled کلیک کنید.
  4. به پروژه خود یک نام بدهید و روی تغییر نام کلیک کنید.

یک پروژه محدود به کانتینر از Google Forms ایجاد کنید

  1. یک فرم را در Google Forms باز کنید.
  2. روی More > ویرایشگر اسکریپت کلیک کنید.
  3. در ویرایشگر اسکریپت، روی پروژه Untitled کلیک کنید.
  4. به پروژه خود یک نام بدهید و روی تغییر نام کلیک کنید.

با استفاده از ابزار خط فرمان clasp یک پروژه مستقل ایجاد کنید

clasp یک ابزار خط فرمان است که به شما امکان می‌دهد پروژه‌های Apps Script را از ترمینال ایجاد، بکشید/فشار دهید و مستقر کنید.

برای جزئیات بیشتر به رابط خط فرمان با استفاده از راهنمای clasp مراجعه کنید.

یک پروژه محدود به کانتینر را حذف کنید

  1. پروژه کانتینری خود را با استفاده از روش مناسب بالا باز کنید.
  2. در بالا سمت راست، روی نمای کلی کلیک کنید.
  3. در بالا سمت چپ، روی حذف > حذف برای همیشه کلیک کنید.

یک پروژه مستقل را حذف کنید

  1. به script.google.com بروید.
  2. در سمت راست پروژه ای که می خواهید حذف کنید، روی More > Remove > Remove کلیک کنید.

مدیریت فایل ها در یک پروژه

یک فایل ایجاد کنید

  1. پروژه Apps Script خود را باز کنید.
  2. در سمت چپ، روی ویرایشگر > افزودن کلیک کنید.
  3. نوع فایل را برای ایجاد انتخاب کنید و نامی برای آن بگذارید.

یک فایل را حذف کنید

  1. پروژه Apps Script خود را باز کنید.
  2. در سمت چپ، روی ویرایشگر کلیک کنید.
  3. در کنار فایلی که می‌خواهید حذف کنید، روی More > حذف کلیک کنید.

فایل‌ها را از پروژه Apps Script صادر کنید

برای خارج کردن فایل‌های کد از Apps Script، می‌توانید کد را از هر فایل در ویرایشگر متن دلخواه خود کپی و جای‌گذاری کنید یا از clasp در خط فرمان استفاده کنید. برای استفاده از clasp، به دانلود پروژه اسکریپت مراجعه کنید.

منطقه زمانی یک پروژه را تنظیم کنید

می توانید منطقه زمانی را برای پروژه Apps Script تنظیم کنید. توابع انجام شده توسط اسکریپت از این منطقه زمانی استفاده می کنند.

  1. پروژه Apps Script خود را باز کنید.
  2. در سمت چپ، روی تنظیمات پروژه کلیک کنید نماد تنظیمات پروژه .
  3. در بخش Time Zone ، منطقه زمانی را که می خواهید استفاده کنید انتخاب کنید.

اگر می خواهید یک تابع خاص از منطقه زمانی متفاوتی نسبت به پروژه اسکریپت استفاده کند، منطقه زمانی را به صراحت در تابع خود وارد کنید. به عنوان مثال، در نمونه زیر، هر تابع یک رویداد جدید در تقویم گوگل ایجاد می کند. تابع اول به طور پیش فرض منطقه زمانی پروژه است. تابع دوم منطقه زمانی اقیانوس آرام را مشخص می کند، بنابراین رویداد بدون توجه به منطقه زمانی پروژه در زمان اقیانوس آرام برنامه ریزی می شود.

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 شوید که دارای افزونه یا برنامه وب است که می خواهید به آن دسترسی داشته باشید.