ساختار آشکار

این صفحه سطح بالای ساختار داده JSON فایل مانیفست پروژه Apps Script را توصیف می کند. مانیفست عملکرد یا هدف پروژه Apps Script را تعریف می کند.

نمایندگی JSON 
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
فیلدها
addOns

object ( AddOns )

پیکربندی منبع پروژه اگر به عنوان یک افزونه Google Workspace مستقر شود.

chat

object

پیکربندی پروژه در صورت استقرار به عنوان یک برنامه چت Google . برای پیکربندی جزئیات برنامه Chat، باید Google Chat API را فعال کنید. برای جزئیات، به پیکربندی Google Chat API مراجعه کنید.

Apps Script مجوز را در سطح اسکریپت کنترل می کند. تا زمانی که کاربر برنامه گپ را تأیید نکند، برنامه‌های گپ که نیاز به مجوز دارند، نمی‌توانند هیچ عملی را انجام دهند. برای ارسال یک پیام قبل از مجوز، می توانید یک شی addToSpaceFallbackMessage به مانیفست اضافه کنید. اگر برنامه چت شما به منطق اولیه سازی نیاز دارد، ممکن است لازم باشد این منطق را در عمل onMessage کپی کنید.

مثال زیر یک برنامه چت را نشان می‌دهد که وقتی کاربر آن را به فضای چت اضافه می‌کند، با یک پیام خوش‌آمدگویی پیش‌فرض پاسخ می‌دهد: 

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }

dependencies

object ( Dependencies )

پیکربندی سرویس ها و کتابخانه های پیشرفته برای استفاده توسط پروژه اسکریپت فعال شده است.

exceptionLogging

string

مکانی که استثناها در آن ثبت می شوند. تنظیمات معتبر به شرح زیر است:

  • NONE نشان می دهد که استثناها ثبت نشده اند.
  • STACKDRIVER نشان می دهد که استثناها در Stackdriver ثبت شده اند.
executionApi

object ( ExecutionApi )

پیکربندی اجرایی API پروژه اسکریپت. این فقط در صورتی استفاده می شود که پروژه برای اجرای API مستقر شده باشد.

oauthScopes[]

string

تعریف محدوده مجوز استفاده شده توسط پروژه اسکریپت.

runtimeVersion

string

نسخه زمان اجرا که اسکریپت از آن استفاده می کند. اگر این فیلد در مانیفست وجود نداشته باشد، اسکریپت از زمان اجرا پیش‌فرض ( STABLE ) استفاده می‌کند. گزینه های معتبر برای این فیلد به شرح زیر است:

  • STABLE زمان اجرای پیش فرض (در حال حاضر راینو) را نشان می دهد.
  • V8 نشان دهنده زمان اجرا با V8 است.
  • DEPRECATED_ES5 زمان اجرای Rhino را نشان می دهد. تنظیم این مقدار از انتقال خودکار به V8 نیز جلوگیری می کند.
sheets

object ( Sheets )

پیکربندی منبعی که ماکروهای Sheets را تعریف می کند.

timeZone

string

منطقه زمانی اسکریپت در یکی از مقادیر ZoneId موجود مانند "America/Denver".

urlFetchWhitelist[]

string

فهرستی از پیشوندهای URL HTTPS. در صورت وجود، هر نقطه پایانی URL واکشی شده باید با یکی از پیشوندهای این لیست مطابقت داشته باشد. این می تواند به محافظت از داده های کاربر کمک کند. این فیلد برای استقرار آزمایشی اختیاری است، اما برای استقرار لازم است. درباره فهرست کردن URL ها بیشتر بیاموزید.

webapp

object ( Webapp )

پیکربندی برنامه وب پروژه اسکریپت، که فقط در صورتی استفاده می شود که پروژه به عنوان یک برنامه وب مستقر شود.

،

این صفحه سطح بالای ساختار داده JSON فایل مانیفست پروژه Apps Script را توصیف می کند. مانیفست عملکرد یا هدف پروژه Apps Script را تعریف می کند.

نمایندگی JSON 
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
فیلدها
addOns

object ( AddOns )

پیکربندی منبع پروژه اگر به عنوان یک افزونه Google Workspace مستقر شود.

chat

object

پیکربندی پروژه در صورت استقرار به عنوان یک برنامه چت Google . برای پیکربندی جزئیات برنامه Chat، باید Google Chat API را فعال کنید. برای جزئیات، به پیکربندی Google Chat API مراجعه کنید.

Apps Script مجوز را در سطح اسکریپت کنترل می کند. تا زمانی که کاربر برنامه گپ را تأیید نکند، برنامه‌های گپ که نیاز به مجوز دارند، نمی‌توانند هیچ عملی را انجام دهند. برای ارسال یک پیام قبل از مجوز، می توانید یک شی addToSpaceFallbackMessage به مانیفست اضافه کنید. اگر برنامه چت شما به منطق اولیه سازی نیاز دارد، ممکن است لازم باشد این منطق را در عمل onMessage کپی کنید.

مثال زیر یک برنامه چت را نشان می‌دهد که وقتی کاربر آن را به فضای چت اضافه می‌کند، با یک پیام خوش‌آمدگویی پیش‌فرض پاسخ می‌دهد: 

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }

dependencies

object ( Dependencies )

پیکربندی سرویس ها و کتابخانه های پیشرفته برای استفاده توسط پروژه اسکریپت فعال شده است.

exceptionLogging

string

مکانی که استثناها در آن ثبت می شوند. تنظیمات معتبر به شرح زیر است:

  • NONE نشان می دهد که استثناها ثبت نشده اند.
  • STACKDRIVER نشان می دهد که استثناها در Stackdriver ثبت شده اند.
executionApi

object ( ExecutionApi )

پیکربندی اجرایی API پروژه اسکریپت. این فقط در صورتی استفاده می شود که پروژه برای اجرای API مستقر شده باشد.

oauthScopes[]

string

تعریف محدوده مجوز استفاده شده توسط پروژه اسکریپت.

runtimeVersion

string

نسخه زمان اجرا که اسکریپت از آن استفاده می کند. اگر این فیلد در مانیفست وجود نداشته باشد، اسکریپت از زمان اجرا پیش‌فرض ( STABLE ) استفاده می‌کند. گزینه های معتبر برای این فیلد به شرح زیر است:

  • STABLE زمان اجرای پیش فرض (در حال حاضر راینو) را نشان می دهد.
  • V8 نشان دهنده زمان اجرا با V8 است.
  • DEPRECATED_ES5 زمان اجرای Rhino را نشان می دهد. تنظیم این مقدار از انتقال خودکار به V8 نیز جلوگیری می کند.
sheets

object ( Sheets )

پیکربندی منبعی که ماکروهای Sheets را تعریف می کند.

timeZone

string

منطقه زمانی اسکریپت در یکی از مقادیر ZoneId موجود مانند "America/Denver".

urlFetchWhitelist[]

string

فهرستی از پیشوندهای URL HTTPS. در صورت وجود، هر نقطه پایانی URL واکشی شده باید با یکی از پیشوندهای این لیست مطابقت داشته باشد. این می تواند به محافظت از داده های کاربر کمک کند. این فیلد برای استقرار آزمایشی اختیاری است، اما برای استقرار لازم است. درباره فهرست کردن URL ها بیشتر بیاموزید.

webapp

object ( Webapp )

پیکربندی برنامه وب پروژه اسکریپت، که فقط در صورتی استفاده می شود که پروژه به عنوان یک برنامه وب مستقر شود.