پروژه های Google Cloud

هر پروژه Apps Script از Google Cloud برای مدیریت مجوز، سرویس‌های پیشرفته و سایر جزئیات استفاده می‌کند. برای پیکربندی و مدیریت این تنظیمات، هر پروژه Apps Script دارای یک پروژه Google Cloud مرتبط است. پروژه اسکریپت شما می‌تواند از یک پروژه پیش‌فرض که Apps Script به طور خودکار ایجاد می‌کند، یا یک پروژه استاندارد که خودتان ایجاد می‌کنید استفاده کند. به طور کلی، پروژه‌های پیش‌فرض برای اسکریپت‌های روزمره یا ساده مناسب هستند، اما باید از یک پروژه استاندارد برای هر برنامه‌ای که پیچیده، با کیفیت تجاری است یا قصد انتشار آن را دارید، استفاده کنید.

می‌توانید در هر زمانی از یک پروژه پیش‌فرض به یک پروژه استاندارد جابجا شوید ، اما نمی‌توانید برای استفاده از پروژه پیش‌فرض برگردید. بهتر است پروژه Cloud را که اسکریپت شما در مراحل اولیه توسعه استفاده می کند، انتخاب کنید. تعویض بعدی می‌تواند عوارضی ایجاد کند، مانند الزام کاربران به مجوز مجدد.

پروژه های ابری پیش فرض

هنگامی که یک پروژه Apps Script ایجاد می کنید، Apps Script یک پروژه Cloud پیش فرض ایجاد می کند که در پس زمینه عمل می کند.

  • برای اکثر اسکریپت ها، شما هرگز نیازی به دیدن یا تنظیم این پروژه پیش فرض ندارید. Apps Script تعاملات لازم را با Google Cloud انجام می دهد. برای مثال، اگر یک سرویس پیشرفته را در ویرایشگر Apps Script فعال کنید، Apps Script سرویس پیشرفته را در پروژه پیش‌فرض Cloud هنگامی که پروژه اسکریپت را ذخیره می‌کنید، فعال می‌کند.
  • برای برخی از اسکریپت ها، باید با کنسول Google Cloud تعامل داشته باشید. در این موارد، اسکریپت شما باید در عوض از یک پروژه استاندارد Cloud استفاده کند. به عنوان مثال، برای مشاهده گزارش‌های Google Cloud در کنسول Google Cloud، اسکریپت شما باید از یک پروژه استاندارد استفاده کند.

به‌طور پیش‌فرض، پروژه‌های Cloud دارای یک خط‌مشی مدیریت هویت و دسترسی (IAM) با یک ورودی هستند، یک حساب سرویس Google که به عنوان مالک پروژه پیش‌فرض عمل می‌کند. حساب سرویس Google appsdev-apps-dev-script-auth@system.gserviceaccount.com است.

پروژه‌های پیش‌فرض Cloud را مشاهده یا به‌روزرسانی کنید

اکثر کاربران نمی‌توانند مستقیماً پروژه‌های پیش‌فرض را در کنسول Google Cloud پیدا، مشاهده یا ویرایش کنند. اگر مدیر هستید، به مشاهده پروژه‌های پیش‌فرض Google Cloud مراجعه کنید.

اگر پروژه اسکریپت خود را قبل از ۸ آوریل ۲۰۱۹ ایجاد کرده‌اید ، ممکن است از یک پروژه پیش‌فرض استفاده کنید که می‌توانید در کنسول Google Cloud به آن دسترسی داشته باشید. برای دسترسی به پروژه پیش فرض، به تنظیمات پروژه اسکریپت رفته و روی شماره پروژه کلیک کنید.

پروژه های پیش فرض ابری را حذف کنید

اگر مدیر هستید، می‌توانید پروژه‌های پیش‌فرض Cloud را مانند پروژه‌های استاندارد Cloud حذف کنید. به Delete Apps Script پروژه های Cloud مراجعه کنید.

اگر مدیر نیستید، نمی‌توانید پروژه‌های پیش‌فرض را حذف کنید. با این حال، Apps Script پروژه های پیش فرض را در سناریوهای زیر حذف می کند:

  • اگر پروژه اسکریپت را حذف کنید یا آن را به استفاده از یک پروژه استاندارد تغییر دهید، Apps Script پروژه پیش‌فرض پیوست شده به اسکریپت را همراه با تنظیمات یا اطلاعات موجود در آن حذف می‌کند.
  • اگر یک اسکریپت به مدت 180 روز یا بیشتر اجرا نشود، Apps Script پروژه پیش‌فرض مرتبط خود را حذف می‌کند. اگر اسکریپت پس از حذف پروژه پیش‌فرض Apps Script اجرا شود، Apps Script یکی برای اسکریپت ایجاد می‌کند.

پروژه های استاندارد ابری

پروژه های پیش فرض ابری بهترین گزینه برای اکثر پروژه های اسکریپت هستند، مگر اینکه نیاز به پیکربندی دستی پروژه داشته باشید. در این شرایط، باید پروژه اسکریپت خود را به استفاده از یک پروژه استاندارد تغییر دهید .

بخش‌های زیر زمانی که Apps Script به یک پروژه استاندارد نیاز دارد، ویژگی‌های چنین پروژه‌هایی و کارهای رایج انجام شده با آنها را توضیح می‌دهد. شما فقط می توانید کارهای زیر را با پروژه های استاندارد انجام دهید.

وقتی Apps Script به پروژه‌های استاندارد Cloud نیاز دارد

در شرایط زیر باید از یک پروژه استاندارد استفاده کنید:

ویژگی های پروژه استاندارد Cloud

پروژه های استاندارد دارای ویژگی های زیر هستند:

  • می‌توانید مستقیماً از کنسول Google Cloud به همه تنظیمات Google Cloud برای پروژه دسترسی داشته باشید. این به شما امکان می دهد API ها را فعال کنید، اعتبارنامه های مجوز را تنظیم کنید و جزئیات دیگر را پیکربندی کنید.
  • هنگامی که یک پروژه اسکریپت را حذف می کنید یا آن را برای استفاده از پروژه استاندارد دیگری تغییر می دهید، پروژه استاندارد اصلی باقی می ماند و می توان از آن دوباره استفاده کرد.
  • هنگامی که یک سرویس پیشرفته را در یک پروژه اسکریپت فعال می کنید، باید به صورت دستی API مربوطه را در پروژه استاندارد فعال کنید.
  • چندین پروژه اسکریپت و سایر برنامه ها می توانند پروژه استاندارد یکسانی را به اشتراک بگذارند. اگر قصد دارید یک پروژه اسکریپت را به عنوان یک افزونه در Google Workspace Marketplace منتشر کنید، باید پروژه استاندارد خود را داشته باشد. برنامه های منتشر شده نمی توانند پروژه های Cloud را با برنامه های دیگر به اشتراک بگذارند.
  • اگر می‌خواهید توابعی را در یک پروژه اسکریپت از برنامه دیگری با استفاده از روش scripts.run در Apps Script API اجرا کنید، پروژه اسکریپت و برنامه فراخوان باید پروژه استاندارد یکسانی را به اشتراک بگذارند.
  • وقتی Apps Script از کاربر می‌خواهد اسکریپتی را که از یک پروژه استاندارد استفاده می‌کند مجوز دهد، از نام پروژه Cloud برای شناسایی اسکریپت (نه نام پروژه اسکریپت) استفاده می‌شود. به همین دلیل، حتما یک نام پروژه Cloud مناسب را تنظیم کنید.

به یک پروژه استاندارد Cloud دسترسی داشته باشید

برای دسترسی به پروژه استاندارد مرتبط با پروژه اسکریپت خود، موارد زیر را انجام دهید:

  1. پروژه Apps Script را باز کنید.
  2. در سمت چپ، روی تنظیمات پروژه کلیک کنید.
  3. در پروژه Google Cloud Platform (GCP) ، روی شماره پروژه کلیک کنید.

همچنین می‌توانید یک پروژه استاندارد را مستقیماً در صفحه مدیریت منابع کنسول Google Cloud پیدا کنید.

یک API را در پروژه استاندارد Cloud فعال کنید

اغلب یک برنامه Apps Script نیاز به دسترسی به Google API دیگر دارد. برای این کار باید API را در پروژه Cloud مربوطه فعال کنید. با انجام موارد زیر یک API را فعال کنید:

  1. پروژه Cloud را باز کنید .
  2. منو > APIs & Services را کلیک کنید.
  3. روی Enable APIs and Services کلیک کنید.
  4. در کادر جستجو، API را که می خواهید فعال کنید وارد کنید و Enter را فشار دهید.
  5. روی API از نتایج جستجو کلیک کنید و سپس روی Enable کلیک کنید تا API برای این پروژه Cloud فعال شود.

ممکن است از شما خواسته شود که شرایط خدمات را برای APIهای Google یا Google Cloud بپذیرید. قبل از پذیرش شرایط خدمات را به دقت بررسی کنید.

بسته به برنامه، ممکن است لازم باشد API را با انتخاب آن در داشبورد APIs & Services پیکربندی کنید.

شناسه و شماره پروژه استاندارد Cloud را تعیین کنید

همه پروژه های Cloud دارای نام پروژه، شناسه پروژه و شماره پروژه هستند. گاهی اوقات، برای پیکربندی سرویس ها یا انجام کارهای دیگر، باید این شناسه ها را داشته باشید.

برای تعیین شناسه و شماره پروژه استاندارد خود، موارد زیر را انجام دهید:

  1. پروژه Cloud را باز کنید .
  2. در بالا سمت راست، روی More > تنظیمات پروژه کلیک کنید.
  3. نام پروژه ، شناسه پروژه و شماره پروژه را در پانل تنظیمات ایجاد شده مشاهده کنید. شماره پروژه فقط از ارقام تشکیل شده است، در حالی که شناسه پروژه حروف عددی است. می‌توانید نام پروژه را ویرایش کنید، که در طول درخواست‌های مجوز به کاربران نمایش داده می‌شود.

گزارش‌های گزارش و خطاهای Google Cloud را در کنسول Google Cloud مشاهده کنید

اگر برای پروژه اسکریپت خود از گزارش Google Cloud یا گزارش خطا استفاده می‌کنید، می‌توانید با انجام کارهای زیر آن گزارش‌ها و گزارش‌ها را در کنسول Google Cloud مشاهده کنید:

  1. پروژه Cloud را باز کنید .
  2. منو کلیک کنید.
  3. به پایین به بخش Operations بروید و روی Logging > Logs explorer کلیک کنید.
  4. برای مشاهده گزارش های خطا، به قسمت عملیات رفته و بر روی گزارش خطا کلیک کنید. اگر از شما خواسته شد که گزارش خطا را تنظیم کنید، به این معنی است که پروژه اسکریپت شما هنوز هیچ استثنایی را ثبت نکرده است.

هنگام استفاده از سرویس‌هایی که به OAuth نیاز دارند، Google از کاربران می‌خواهد آن سرویس‌ها را مجاز کنند. تنظیمات صفحه رضایت OAuth به شما امکان می دهد برخی از اطلاعاتی را که Google به کاربران ارائه می دهد، مانند نام برنامه و URL شرایط خدمات، تنظیم کنید.

پروژه‌های پیش‌فرض Cloud یک صفحه رضایت به‌طور خودکار از جزئیات پروژه Apps Script ایجاد می‌کنند. شما نمی توانید آن تنظیمات را تنظیم کنید. پروژه های استاندارد Cloud به شما امکان می دهند این اطلاعات را سفارشی کنید. با انجام کارهای زیر می توانید صفحه رضایت اسکریپت خود را پیکربندی کنید:

  1. پروژه Cloud را باز کنید .
  2. منو > APIs & Services > Credentials را کلیک کنید.
  3. روی پیکربندی صفحه رضایت کلیک کنید.
  4. هر بخش از گردش کار صفحه رضایت را پر کنید.
  5. برای ثبت تغییرات خود در هر مرحله از گردش کار، روی ذخیره کلیک کنید و ادامه دهید .

اعتبارنامه OAuth را ایجاد کنید

Apps Script معمولاً OAuth را برای سرویس هایی که اسکریپت شما استفاده می کند تنظیم می کند. برای برخی از برنامه‌ها، باید اعتبارنامه OAuth اضافی (شناسه‌های مشتری و اسرار مشتری) ایجاد کنید. شما فقط با پروژه های استاندارد می توانید این کار را انجام دهید.

برای ایجاد شناسه مشتری و راز مشتری برای پروژه اسکریپت خود، موارد زیر را انجام دهید:

  1. پروژه Cloud را باز کنید .
  2. منو > APIs & Services > Credentials را کلیک کنید.
  3. روی ایجاد اعتبار > شناسه مشتری OAuth کلیک کنید.
  4. در قسمت Application type ، نوع درخواست خود را انتخاب کنید و در صورت نیاز فرم به دست آمده را پر کنید. پس از اتمام، روی ایجاد کلیک کنید.
  5. در گفتگوی ظاهر شده، روی دانلود JSON کلیک کنید. می توانید از این فایل برای پیکربندی OAuth استفاده کنید.

مالکان اضافی را به پروژه استاندارد Cloud اضافه کنید

می توانید مالکان یا نقش های دیگری را به یک پروژه استاندارد اضافه کنید. اگر در پروژه‌ای همکاری می‌کنید، این کمک می‌کند مطمئن شوید که فردی در تیم شما همیشه به تنظیمات Google Cloud پروژه اسکریپت دسترسی دارد.

با انجام کارهای زیر می توانید مالکان یا نقش های دیگری را به یک پروژه استاندارد اضافه کنید. برای انجام هر یک از این تغییرات، باید مجوز ویرایش پروژه را داشته باشید:

  1. تعیین کنید که همکاران شما چه کسانی باید باشند. توصیه می کنیم یک گروه Google موجود ایجاد کنید یا از آن استفاده کنید. همچنین می‌توانید دامنه‌هایی را در لیست همکاران تعیین کنید تا همه کاربران آن دامنه را شامل شود.
  2. پروژه Cloud اسکریپت را باز کنید .
  3. > IAM & admin > IAM کلیک کنید.
  4. در بالا، روی افزودن کلیک کنید.
  5. دستورالعمل های روی صفحه را دنبال کنید تا یک یا چند عضو جدید و نقش آنها را به پروژه Cloud اضافه کنید. می‌توانید ایمیل‌های فردی، Google Groups یا دامنه‌ها را به عنوان اعضای جدید اضافه کنید.
  6. روی ذخیره کلیک کنید.

چند اسکریپت را با یک پروژه Cloud گروه بندی کنید

می‌توانید چندین پروژه Apps Script را در پروژه استاندارد Cloud مشترک داشته باشید. برای انجام این کار، یک پروژه استاندارد ایجاد کنید و سپس هر پروژه اسکریپت را برای استفاده از آن تغییر دهید . شما نمی توانید این کار را با پروژه های پیش فرض انجام دهید.

از پروژه استاندارد Cloud دیگری استفاده کنید

می توانید یک پروژه اسکریپت را تغییر دهید تا از پروژه استاندارد Cloud دیگری استفاده کند. اگر اسکریپت شما به پیکربندی دستی پروژه Cloud نیاز دارد، باید از یک پروژه پیش فرض به یک پروژه استاندارد تغییر دهید. برای کسب اطلاعات بیشتر در مورد زمانی که نیاز به استفاده از یک پروژه استاندارد دارید، به پروژه های استاندارد Cloud مراجعه کنید.

اثرات تغییر به یک پروژه استاندارد Cloud متفاوت

اگر اسکریپت خود را از یک پروژه پیش فرض یا به یک پروژه استاندارد دیگر تغییر دهید، اثرات زیر را دارد:

  • اگر سرویس های پیشرفته را برای اسکریپت خود فعال کرده اید، باید API های مربوطه را در پروژه جدید Cloud روشن کنید. شما هر گونه داده مرتبط با خدمات پیشرفته در پروژه قبلی Cloud را از دست می دهید. برای آشنایی با نحوه روشن کردن APIها در پروژه Cloud، به فعال کردن Google Workspace API مراجعه کنید.
  • اگر اسکریپت شما از سرویس داخلی Google Drive استفاده می‌کند، باید API Drive را در پروژه‌های استاندارد Cloud روشن کنید.

    در پروژه استاندارد Cloud خود، Drive API را روشن کنید:

    Drive API را روشن کنید

  • همه کاربرانی که قبلاً اسکریپت را مجاز کرده اند باید مجدداً مجوز بگیرند. در بیشتر موارد، همه کاربرانی که قبلاً برنامه‌های مرتبط با پروژه جدید را مجاز کرده‌اند نیز باید مجدداً مجوز بگیرند.
  • اگر اسکریپت شما با فهرست برنامه‌ای در Google Workspace Marketplace مرتبط باشد، فهرست برنامه، کاربران و نظرات شما به پروژه جدید منتقل نمی‌شوند. شما باید یک لیست برنامه در پروژه جدید ایجاد کنید و کاربران شما باید برنامه شما را دوباره نصب کنند. برای کسب اطلاعات در مورد ایجاد یک لیست برنامه جدید، به انتشار یک برنامه مراجعه کنید.
  • شما نمی توانید یک اسکریپت را به یک پروژه پیش فرض برگردانید. پس از اینکه اسکریپت را برای استفاده از یک پروژه استاندارد تنظیم کردید، Apps Script پروژه های پیش فرض را حذف می کند.

به پروژه استاندارد Cloud دیگری بروید

برای تغییر پروژه Cloud موجود اسکریپت به پروژه Cloud دیگری، این مراحل را دنبال کنید:

  1. اگر پروژه Cloud مناسبی ندارید، با دنبال کردن دستورالعمل‌های Create a project، آن را ایجاد کنید. یک نام پروژه به یاد ماندنی تنظیم کنید تا بتوانید آن را در صفحه مدیریت منابع کنسول Google Cloud پیدا کنید. Apps Script زمانی که از کاربران می‌خواهد اسکریپت را تأیید کنند از این نام استفاده می‌کند.
  2. اگر می‌خواهید از یک پروژه موجود استفاده کنید، صفحه مدیریت منابع کنسول Google Cloud را باز کنید و پروژه موجود را برای استفاده پیدا کنید. شما باید نقش های Project Browser و OAuth Config Editor یا نقش هایی با مجوزهای معادل را برای پروژه داشته باشید. شما نمی توانید از پروژه ای که به طور خودکار توسط Apps Script ایجاد شده است استفاده کنید.
  3. شماره پروژه پروژه Cloud خود را تعیین کنید .
  4. اسکریپتی را که می خواهید پروژه Cloud آن را جایگزین کنید باز کنید.
  5. در سمت چپ، روی تنظیمات پروژه کلیک کنید.
  6. در پروژه Google Cloud Platform (GCP) ، روی تغییر پروژه کلیک کنید.
  7. شماره پروژه جدید را وارد کرده و روی تنظیم پروژه کلیک کنید.

پروژه های ابری و درایوهای مشترک

درایوهای مشترک (درایوهای گروه سابق) فضاهای مشترکی را فراهم می‌کنند که گروه‌هایی از کاربران Drive می‌توانند در پروژه‌های Apps Script و اسناد Drive با یکدیگر همکاری کنند. درایوهای مشترک هنگام توسعه اسکریپت‌ها، افزونه‌ها و برنامه‌های وب با یک تیم ارزشمند هستند، اما محدودیت‌هایی را برای کارهایی که می‌توانید با پروژه‌های پیش‌فرض ابری قدیمی‌تر انجام دهید، ایجاد می‌کنند.

فهرست محدودیت‌های زیر نحوه تعامل پروژه‌های Cloud با درایوهای مشترک را توضیح می‌دهد:

  • اگر پروژه اسکریپت شما از یک پروژه استاندارد استفاده می کند، زمانی که پروژه اسکریپت در یک درایو مشترک قرار می گیرد محدودیت اضافی وجود ندارد.
  • اگر پروژه اسکریپت شما از پروژه پیش‌فرضی استفاده می‌کند که در 8 آوریل 2019 یا پس از آن ایجاد شده است، وقتی پروژه اسکریپت در یک درایو مشترک است، هیچ محدودیت اضافی وجود ندارد.
  • اگر پروژه اسکریپت شما از یک پروژه پیش‌فرض استفاده می‌کند که قبل از ۸ آوریل ۲۰۱۹ ایجاد شده است، محدودیت‌های زیر در زمانی که پروژه اسکریپت در یک درایو مشترک است اعمال می‌شود:
    1. با استفاده از رابط کاربری Apps Script یا کنسول Google Cloud نمی‌توانید به پروژه پیش‌فرض دسترسی پیدا کنید. این محدودیت مانع از انجام اقداماتی می شود که نیاز به دسترسی مستقیم به پروژه دارند .
    2. شما نمی توانید خدمات پیشرفته را فعال کنید. برای فعال کردن خدمات پیشرفته، به یک پروژه استاندارد بروید.
    3. وقتی یک پروژه Apps Script موجود را به یک درایو مشترک منتقل می‌کنید، Google دسترسی به پروژه پیش‌فرض Cloud را محدود می‌کند. اگر قبل از حرکت دسترسی داشتید، همچنان می‌توانید به پروژه پیش‌فرض دسترسی داشته باشید. برای مثال، اگر یک اسکریپت در پوشه My Drive خود ایجاد کرده و سپس آن را به یک درایو مشترک منتقل کرده باشید، همچنان می‌توانید به پروژه Cloud اسکریپت دسترسی داشته باشید. ممکن است همکاران شما در درایو مشترک نتوانند.
    4. یک اسکریپت نام پروژه Cloud را که قبل از انتقال به درایو مشترک داشت حفظ می کند. حتی اگر نام پروژه را در درایو مشترک تغییر دهید، کاربرانی که اسکریپت را مجاز می‌کنند همچنان نام قدیمی را در گفتگوهای مجوز مشاهده می‌کنند.

برای جلوگیری از محدودیت‌های بالا برای اسکریپت‌های قدیمی‌تر، به یک پروژه استاندارد بروید .

لیستی از پروژه های Apps Script Cloud را دریافت کنید

اگر مجوز resourcemanager.projects.list را برای پوشه پروژه Apps Script سازمان خود دارید، می توانید همه پروژه های استاندارد و پیش فرض Apps Script Cloud را در پوشه مشاهده کنید.

  1. صفحه مدیریت منابع کنسول Google Cloud را باز کنید.
  2. در کنار پوشه Apps Script ، شناسه را کپی کنید.
  3. روی Filter > Parent ID کلیک کنید و شناسه پوشه Apps Script را جایگذاری کنید.

پروژه های Apps Script Cloud را حذف کنید

برای حذف یک پروژه Apps Script Cloud، مراحل زیر دریافت فهرستی از پروژه‌های Apps Script Cloud را دنبال کنید، پروژه‌ای را که می‌خواهید حذف کنید انتخاب کنید و روی Delete کلیک کنید.

برای حذف یک پروژه Apps Script با استفاده از gcloud ، از دستورات زیر استفاده کنید.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

برای اطلاعات بیشتر درباره حذف پروژه‌های Cloud، به خاموش کردن (حذف) پروژه‌ها مراجعه کنید.