یک پروژه اسکریپت مجموعهای از فایلها و منابع در Google Apps Script را نشان میدهد که گاهی اوقات به سادگی به عنوان "اسکریپت" نامیده میشود. یک پروژه اسکریپت دارای یک یا چند فایل اسکریپت است که میتوانند فایلهای کد (با پسوند .gs ) یا فایلهای HTML (با پسوند .html ) باشند. همچنین میتوانید جاوا اسکریپت و CSS را در فایلهای HTML قرار دهید.
ویرایشگر اسکریپت همیشه و در هر زمان فقط یک پروژه را باز دارد. میتوانید چندین پروژه را در چندین پنجره یا تب مرورگر باز کنید.
ایجاد و حذف پروژهها
این بخش نحوه ایجاد و حذف پروژههای Apps Script مستقل یا وابسته به کانتینر را توضیح میدهد.
ایجاد یک پروژه مستقل
برای ایجاد یک پروژه مستقل از Apps Script:
- به
script.google.comبروید. - روی پروژه جدید کلیک کنید.
- در ویرایشگر اسکریپت، روی پروژه بدون عنوان کلیک کنید.
- برای پروژه خود یک نام انتخاب کنید و روی «تغییر نام» کلیک کنید.
ایجاد یک پروژه مستقل از گوگل درایو
- گوگل درایو را باز کنید.
- روی جدید > بیشتر > اسکریپت برنامههای گوگل کلیک کنید.
ایجاد یک پروژه متصل به کانتینر از Google Docs، Sheets یا Slides
- یک سند Docs، یک صفحه گسترده Sheets یا یک ارائه Slides را باز کنید.
- روی افزونهها > اسکریپت برنامههای گوگل کلیک کنید.
- در ویرایشگر اسکریپت، روی پروژه بدون عنوان کلیک کنید.
- برای پروژه خود یک نام انتخاب کنید و روی «تغییر نام» کلیک کنید.
ایجاد یک پروژه متصل به کانتینر از Google Forms
- یک فرم را در گوگل فرم باز کنید.
- روی More > ویرایشگر اسکریپت کلیک کنید.
- در ویرایشگر اسکریپت، روی پروژه بدون عنوان کلیک کنید.
- برای پروژه خود یک نام انتخاب کنید و روی «تغییر نام» کلیک کنید.
ایجاد یک پروژه مستقل با استفاده از ابزار خط فرمان clasp
clasp یک ابزار خط فرمان است که به شما امکان میدهد پروژههای Apps Script را از طریق ترمینال ایجاد، دریافت/ارسال و مستقر کنید.
برای جزئیات بیشتر به راهنمای رابط خط فرمان با استفاده clasp مراجعه کنید.
حذف یک پروژه متصل به کانتینر
- پروژه متصل به کانتینر خود را با استفاده از روش مناسب بالا باز کنید.
- در بالا سمت چپ، روی نمای کلی کلیک کنید.
- در بالا سمت راست، روی > حذف برای همیشه کلیک کنید.
حذف یک پروژه مستقل
- به
script.google.comبروید. - در سمت راست پروژهای که میخواهید حذف کنید، روی More > Remove > Remove کلیک کنید.
مدیریت فایلها در یک پروژه
ایجاد یک فایل
- پروژه Apps Script خود را باز کنید.
- در سمت چپ، روی ویرایشگر > کلیک کنید.
- نوع فایلی که میخواهید ایجاد کنید را انتخاب کنید و نامی برای آن تعیین کنید.
حذف یک فایل
- پروژه Apps Script خود را باز کنید.
- در سمت چپ، روی ویرایشگر کلیک کنید.
- در کنار فایلی که میخواهید حذف کنید، روی «بیشتر» > > «حذف» کلیک کنید.
خروجی گرفتن از فایلها از یک پروژه اسکریپت برنامهها
برای خارج کردن فایلهای کد از Apps Script، میتوانید کد را از هر فایل کپی کرده و در ویرایشگر متن دلخواه خود جایگذاری کنید یا از clasp در خط فرمان استفاده کنید. برای استفاده از clasp، به دانلود یک پروژه اسکریپت مراجعه کنید.
تنظیم منطقه زمانی برای یک پروژه
شما میتوانید منطقه زمانی را برای یک پروژه Apps Script تنظیم کنید. توابعی که توسط اسکریپت انجام میشوند از این منطقه زمانی استفاده میکنند.
- پروژه Apps Script خود را باز کنید.
- در سمت چپ، روی تنظیمات پروژه کلیک کنید
. - در بخش منطقه زمانی ، منطقه زمانی مورد نظر خود را انتخاب کنید.
اگر میخواهید یک تابع خاص از منطقه زمانی متفاوتی نسبت به پروژه اسکریپت استفاده کند، منطقه زمانی را به طور صریح در تابع خود وارد کنید. برای مثال، در نمونه زیر، هر تابع یک رویداد جدید در تقویم گوگل ایجاد میکند. تابع اول به طور پیشفرض منطقه زمانی پروژه را در نظر میگیرد. تابع دوم منطقه زمانی اقیانوس آرام را مشخص میکند، بنابراین رویداد صرف نظر از منطقه زمانی پروژه، بر اساس زمان اقیانوس آرام برنامهریزی میشود.
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());
}
رفع مشکلات مربوط به چندین حساب گوگل
اگر همزمان وارد چندین حساب گوگل شدهاید، ممکن است در دسترسی به افزونهها و برنامههای وب خود مشکل داشته باشید. ورود چندگانه یا ورود همزمان به چندین حساب گوگل برای اسکریپت برنامهها، افزونهها یا برنامههای وب پشتیبانی نمیشود.
اگر ویرایشگر اسکریپت برنامهها را در حالی که با بیش از یک حساب کاربری وارد سیستم شدهاید باز کنید ، گوگل از شما میخواهد حسابی را که میخواهید با آن ادامه دهید انتخاب کنید.
اگر یک برنامه وب یا افزونه را باز کردید و با مشکل ورود چندگانه مواجه شدید، یکی از راهحلهای زیر را امتحان کنید:
- از تمام حسابهای گوگل خود خارج شوید و فقط به حسابی وارد شوید که افزونه یا برنامهی تحت وب مورد نظر شما را دارد.
- یک پنجره ناشناس در گوگل کروم یا یک پنجره مرور خصوصی معادل آن باز کنید و به حساب گوگلی که افزونه یا برنامه وب مورد نظر شما را دارد، وارد شوید.