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

หน้านี้อธิบายโครงสร้างข้อมูล JSON ของไฟล์ Manifest ของ Google Apps Script ระดับบนสุด ไฟล์ Manifest จะกำหนดฟังก์ชันหรือวัตถุประสงค์ของโปรเจ็กต์ 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

สำหรับแอป Chat ใหม่ ให้ใช้ฟิลด์ addOns.chat แทน หากคุณดูแลแอป Chat ที่มีอยู่ซึ่งใช้ฟิลด์ chat ฟิลด์นี้ควรเป็นออบเจ็กต์ว่าง

หากต้องการกำหนดค่ารายละเอียดแอป Chat คุณต้อง เปิดใช้ Google Chat API โปรดดูรายละเอียดที่หัวข้อ กำหนดค่า Google Chat API

Apps Script จัดการการให้สิทธิ์ที่ระดับสคริปต์ แอป 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

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

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

object (Sheets)

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

timeZone

string

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

urlFetchWhitelist[]

string

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

webapp

object (Webapp)

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