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