فعال کردن مجوز و دسترسی به اسکریپت

Apps Script API بسته به هدف شما به انواع مختلفی از مجوزها نیاز دارد:

• از Apps Script API در برنامه خود استفاده کنید.
• به برنامه‌های کاربردی دیگر اجازه دهید داده‌ها یا استقرارهای پروژه اسکریپت شما را مدیریت کنند.

اگر نیاز به استفاده از Apps Script API در برنامه خود دارید، باید API را در پروژه Google Cloud برنامه فعال کنید . این به شما امکان می دهد اعتبارنامه OAuth را ایجاد کنید تا کاربران برنامه بتوانند آن را مجاز کنند.

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

با استفاده از Apps Script API در برنامه خود

اگر می خواهید از Apps Script API در داخل برنامه خود استفاده کنید، باید Apps Script API را در پروژه GCP برنامه خود فعال کنید. پس از فعال کردن Apps Script API، می توانید اعتبارنامه OAuth را ایجاد کنید و شناسه مشتری و راز را دانلود کنید تا در برنامه خود قرار دهید. همچنین می‌توانید استفاده از API را در کنسول Google Cloud نظارت کنید.

می توانید از این جادوگر برای ایجاد یا انتخاب یک پروژه Google Cloud در کنسول API استفاده کنید و به طور خودکار API را فعال کنید. همچنین، می‌توانید صفحه مدیریت منابع کنسول را باز کنید ، پروژه‌ای را انتخاب کنید، سپس Apps Script API را به صورت دستی با استفاده از داشبورد APIها و خدمات پروژه جستجو کرده و اضافه کنید. هنگامی که API را فعال کردید، می‌توانید اعتبارنامه‌های OAuth، شناسه‌های مشتری، و اسرار سرویس گیرنده را برای برنامه‌های خود در پنل APIs & Services > Credentials ایجاد کنید.

شروع سریع Apps Script API یک نگاه گام به گام به کل فرآیند فعال کردن API و تنظیم مجوز برای یک برنامه ارائه می دهد.

اعطای دسترسی به برنامه های شخص ثالث به پروژه های اسکریپت شما

Apps Script API می‌تواند به برنامه‌ها اجازه دهد تا اسکریپت‌های شما و استقرار آنها را ایجاد و تغییر دهند. اگر به یک برنامه شخص ثالث مخرب مجوز دهید که سپس اقدام به ایجاد اسکریپت های مخرب بیشتری کند یا رفتار اسکریپت هایی را که قبلاً دارید تغییر دهد، می تواند منجر به وضعیت بدی شود.

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

اگر بخواهید یک برنامه آسیب دیده را بدون اجازه دسترسی به API اجرا کنید، یک خطا رخ می دهد. این خطا پس از تایید برنامه رخ می دهد.

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

می‌توانید با استفاده از داشبورد Apps Script به Apps Script API اجازه دسترسی به پروژه‌های اسکریپت خود بدهید. همچنین می توانید از داشبورد برای لغو این دسترسی در هر زمان استفاده کنید. وقتی به API دسترسی می دهید، این کار را برای همه برنامه ها انجام می دهید. با این حال، برنامه های فردی هنوز نیاز به مجوز دارند.

قبل از اینکه اجازه دسترسی بدهید، مطمئن شوید که متوجه شده اید که اجازه دادن به برنامه ها برای اصلاح اسکریپت های شما خطری وجود دارد. هرگز برنامه‌ای را که مشکوک به مخرب بودن آن هستید مجوز ندهید.