ساختار آشکار

این صفحه سطح بالای ساختار داده JSON فایل مانیفست اسکریپت گوگل اپس را شرح می‌دهد. مانیفست، عملکرد یا هدف پروژه اسکریپت اپس را تعریف می‌کند.

نمایش 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 : زمان اجرای راینو. این مقدار از مهاجرت خودکار به V8 جلوگیری می‌کند.
sheets

object ( Sheets )

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

timeZone

string

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

urlFetchWhitelist[]

string

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

webapp

object ( Webapp )

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