ساختار آشکار

این صفحه، سطح بالای ساختار داده 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 .

نکته: برای برنامه‌های چت جدید، توصیه می‌کنیم از فیلد addOns.chat استفاده کنید. اگر از یک برنامه چت موجود استفاده می‌کنید که از فیلد 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 زمان اجرای پیش‌فرض (در حال حاضر Rhino) را نشان می‌دهد.
  • V8 نشان دهنده زمان کارکرد با موتور V8 است.
  • DEPRECATED_ES5 زمان اجرای Rhino را نشان می‌دهد. تنظیم این مقدار همچنین از مهاجرت خودکار به V8 جلوگیری می‌کند.
sheets

object ( Sheets )

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

timeZone

string

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

urlFetchWhitelist[]

string

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

webapp

object ( Webapp )

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