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

หน้านี้อธิบายโครงสร้างข้อมูล JSON ของไฟล์ Manifest ระดับบนสุดของโปรเจ็กต์ 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 จัดการการให้สิทธิ์ที่ระดับสคริปต์ แอปแชทที่ต้องมีการให้สิทธิ์จะดำเนินการใดๆ ไม่ได้จนกว่าผู้ใช้จะให้สิทธิ์แอปแชท หากต้องการโพสต์ข้อความก่อนการให้สิทธิ์ คุณสามารถเพิ่มออบเจ็กต์ 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)

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