โครงสร้างไฟล์ Manifest

หน้านี้อธิบายโครงสร้างข้อมูล JSON ระดับบนสุดของไฟล์ Manifest ของโปรเจ็กต์ Apps Script

โครงสร้างย่อยของไฟล์ Manifest จะกำหนดไว้ในหน้าแยกต่างหาก ดังนี้

  • Manifest ระดับบนสุด
    • addOns: การกําหนดค่าสําหรับส่วนเสริมของ Google Workspace
    • chat: การกําหนดค่าสําหรับแอป Google Chat
    • dependencies: ไลบรารีและบริการขั้นสูงของ Apps Script ที่ต้องพึ่งพา
    • Sheets: การกําหนดค่าสําหรับมาโคร Google ชีตอย่างน้อย 1 รายการ
    • ExecutionApi
    • Webapp: การกําหนดค่าสําหรับเว็บแอป

ไฟล์ Manifest

ระดับบนสุดของการกําหนดค่าไฟล์ Manifest

การแสดง 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 หากต้องการกําหนดค่ารายละเอียดของแอป Chat คุณต้องเปิดใช้ Google Chat API โปรดดูรายละเอียดที่หัวข้อกำหนดค่า Google Chat API

Apps Script จะจัดการการให้สิทธิ์ที่ระดับสคริปต์ แอป Chat ที่ต้องได้รับสิทธิ์จะดำเนินการใดๆ ไม่ได้จนกว่าผู้ใช้จะให้สิทธิ์แอป Chat หากต้องการโพสต์ข้อความก่อนได้รับสิทธิ์ คุณสามารถเพิ่มออบเจ็กต์ addToSpaceFallbackMessage ลงในไฟล์ Manifest หากแอป Chat ต้องใช้ตรรกะการเริ่มต้น คุณอาจต้องทําซ้ำตรรกะนี้ในการดำเนินการ onMessage

ตัวอย่างต่อไปนี้แสดงแอป Chat ที่ตอบกลับด้วยข้อความต้อนรับเริ่มต้นเมื่อผู้ใช้เพิ่มแอปนั้นลงในพื้นที่ทำงานของ Chat

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

dependencies

object (Dependencies)

การกําหนดค่า บริการขั้นสูงและไลบรารีที่เปิดใช้เพื่อให้โปรเจ็กต์สคริปต์ใช้งานได้

exceptionLogging

string

ตำแหน่งที่บันทึกข้อยกเว้น การตั้งค่าที่ใช้ได้มีดังนี้

  • NONE ระบุว่าไม่มีการบันทึกข้อยกเว้น
  • STACKDRIVER บ่งชี้ว่าระบบบันทึกข้อยกเว้นไว้ใน Stackdriver
executionApi

object (ExecutionApi)

การกําหนดค่าไฟล์ปฏิบัติการ API ของโปรเจ็กต์สคริปต์ จะใช้เฉพาะในกรณีที่มีการทำให้โปรเจ็กต์ใช้งานได้สําหรับการเรียกใช้ API

oauthScopes[]

string

คําจํากัดความของขอบเขตการให้สิทธิ์ที่ใช้โดยโปรเจ็กต์สคริปต์

runtimeVersion

string

เวอร์ชันรันไทม์ที่สคริปต์ใช้ หากไม่มีช่องนี้ในไฟล์ Manifest สคริปต์จะใช้รันไทม์เริ่มต้น (STABLE) ตัวเลือกที่ใช้ได้สำหรับช่องนี้มีดังนี้

  • STABLE หมายถึงรันไทม์เริ่มต้น (ปัจจุบันคือ Rhino)
  • V8 หมายถึงรันไทม์ที่ขับเคลื่อนโดย V8
  • DEPRECATED_ES5 หมายถึงรันไทม์ Rhino การตั้งค่าค่านี้ยังป้องกันไม่ให้มีการย้ายข้อมูลไปยัง V8 โดยอัตโนมัติด้วย
sheets

object (Sheets)

การกําหนดค่าทรัพยากรที่กําหนดมาโครชีต

timeZone

string

เขตเวลาของสคริปต์ในค่า ZoneId ที่พร้อมใช้งาน เช่น "America/Denver"

urlFetchWhitelist[]

string

รายการคำนำหน้า HTTPS URL หากมี URL ปลายทางที่ดึงข้อมูลต้องตรงกับคำนำหน้ารายการใดรายการหนึ่งในรายการนี้ ซึ่งจะช่วยปกป้องข้อมูลผู้ใช้ ช่องนี้ไม่บังคับสำหรับการทําให้การทดสอบใช้งานได้ แต่ต้องกรอกข้อมูลในช่องนี้สําหรับการทําให้การใช้งานได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการอนุญาต URL

webapp

object (Webapp)

การกําหนดค่าเว็บแอปของโปรเจ็กต์สคริปต์ ซึ่งจะใช้ก็ต่อเมื่อมีการทําให้โปรเจ็กต์ใช้งานได้เป็นเว็บแอปเท่านั้น