API اسکریپت Google Apps بسته به هدف شما به انواع مختلفی از مجوزها نیاز دارد:
- از API اسکریپت برنامهها در برنامه خود استفاده کنید.
- به برنامههای دیگر اجازه دهید دادههای پروژه اسکریپت یا استقرارهای شما را مدیریت کنند.
برای استفاده از API مربوط به Apps Script در برنامه خود، باید API را در پروژه Google Cloud برنامه فعال کنید. این به شما امکان میدهد اعتبارنامههای OAuth ایجاد کنید تا کاربران برنامه بتوانند آن را تأیید کنند.
برای اینکه به برنامههای شخص ثالث اجازه دهید محتوا یا استقرار پروژههای اسکریپت شما را مدیریت کنند، باید به پروژههای اسکریپت خود دسترسی بدهید.
از API اسکریپت برنامهها در برنامه خود استفاده کنید
برای استفاده از API مربوط به Apps Script در داخل برنامه خود، باید Apps Script API را در پروژه Google Cloud برنامه خود فعال کنید. پس از فعال کردن Apps Script API، میتوانید اعتبارنامههای OAuth ایجاد کرده و شناسه و رمز کلاینت را برای استفاده در برنامه خود دانلود کنید. همچنین میتوانید میزان استفاده از API را در کنسول Google Cloud نظارت کنید.
شما میتوانید از ویزارد فعالسازی API برای ایجاد یا انتخاب یک پروژه Google Cloud در کنسول Google Cloud استفاده کنید و API را به طور خودکار فعال کنید. همچنین میتوانید صفحه مدیریت منابع کنسول را باز کنید ، یک پروژه را انتخاب کنید، سپس API مربوط به Apps Script را با استفاده از داشبورد APIها و سرویسهای پروژه، جستجو و به صورت دستی اضافه کنید. پس از فعالسازی API، میتوانید اعتبارنامههای OAuth، شناسههای کلاینت و اطلاعات محرمانه کلاینت را برای برنامههای خود در پنل APIها و سرویسها > اعتبارنامهها ایجاد کنید.
راهنمای سریع API اسکریپت برنامهها، نگاهی گام به گام به کل فرآیند فعالسازی API و تنظیم مجوز برای یک برنامه ارائه میدهد.
به برنامههای شخص ثالث اجازه دسترسی به پروژههای اسکریپت خود را بدهید
API اسکریپت برنامهها میتواند به برنامهها اجازه دهد اسکریپتهای شما و نحوهی استقرار آنها را ایجاد و تغییر دهند. اگر به یک برنامهی شخص ثالث مخرب مجوز دهید، این امر میتواند منجر به وضعیت بدی شود، زیرا این برنامه سپس اسکریپتهای مخرب بیشتری ایجاد میکند یا رفتار اسکریپتهایی را که از قبل دارید تغییر میدهد.
برای کمک به کاهش این خطر، API اسکریپت برنامهها به طور پیشفرض نمیتواند به پروژههای اسکریپت شما دسترسی داشته باشد. شما باید قبل از استفاده از هر برنامهای که اسکریپتها یا استقرارها را ایجاد یا تغییر میدهد، صراحتاً به API دسترسی بدهید. پس از اعطای دسترسی API به اسکریپتهای خود، برنامههایی که شما مجاز میکنید میتوانند از API برای مدیریت پروژههای اسکریپت شما استفاده کنند.
اگر سعی کنید یک برنامه آسیبدیده را بدون اعطای دسترسی اولیه به API اجرا کنید، خطایی رخ میدهد. این خطا پس از تأیید برنامه رخ میدهد.
شما میتوانید با استفاده از داشبورد Apps Script به API مربوط به پروژههای اسکریپت خود دسترسی بدهید. همچنین میتوانید از داشبورد برای لغو این دسترسی در هر زمانی استفاده کنید. وقتی به API دسترسی میدهید، این کار را برای همه برنامهها انجام میدهید. با این حال، برنامههای تک تک همچنان نیاز به مجوز دارند.
قبل از اعطای دسترسی، مطمئن شوید که از خطرات ناشی از اجازه دادن به برنامهها برای تغییر اسکریپتهایتان آگاه هستید. هرگز به برنامههایی که مشکوک به مخرب بودن آنها هستید، اجازه دسترسی ندهید.