شی مورد استفاده برای تعیین اینکه آیا کاربر نیاز به مجوز این اسکریپت برای استفاده از یک یا چند سرویس دارد یا خیر و برای ارائه URL برای گفتگوی مجوز استفاده می شود. اگر اسکریپت به‌عنوان افزونه‌ای منتشر شود که از محرک‌های قابل نصب استفاده می‌کند، از این اطلاعات می‌توان برای کنترل دسترسی به بخش‌هایی از کد که کاربر مجوز لازم برای آن‌ها را ندارد، استفاده کرد. همچنین، افزونه می‌تواند از کاربر بخواهد که URL را برای گفتگوی مجوز باز کند تا مشکل حل شود.
این شی توسط ScriptApp.getAuthorizationInfo(authMode) برگردانده شده است. تقریباً در همه موارد، اسکریپت‌ها باید ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) را فراخوانی کنند، زیرا هیچ حالت مجوز دیگری نیازی به اعطای مجوز توسط کاربران ندارد.
روش ها
| روش | نوع برگشت | شرح مختصر |
|---|---|---|
getAuthorizationStatus() | AuthorizationStatus | مقداری را دریافت می‌کند که نشان می‌دهد آیا کاربر باید برای استفاده از یک یا چند سرویس به این اسکریپت مجوز دهد (برای مثال ScriptApp.AuthorizationStatus.REQUIRED ). |
getAuthorizationUrl() | String | URL مجوزی را دریافت می کند که می تواند برای اعطای دسترسی به اسکریپت استفاده شود. |
مستندات دقیق
getAuthorizationStatus()
مقداری را دریافت می‌کند که نشان می‌دهد آیا کاربر باید برای استفاده از یک یا چند سرویس به این اسکریپت مجوز دهد (برای مثال ScriptApp.AuthorizationStatus.REQUIRED ).
// Log the authorization status (REQUIRED or NOT_REQUIRED). var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationStatus());
بازگشت
AuthorizationStatus - وضعیت مجوز
getAuthorizationUrl()
URL مجوزی را دریافت می کند که می تواند برای اعطای دسترسی به اسکریپت استفاده شود. اگر مجوز لازم نباشد، این متد null را برمی‌گرداند. در صورت دسترسی به صفحه در URL به طور خودکار بسته می شود و اسکریپت به هیچ مجوزی نیاز ندارد.
// Log the URL used to grant access to the script. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
بازگشت
String - یک URL که می تواند برای مجوز دادن به اسکریپت استفاده شود