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