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