โครงสร้างไฟล์ 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 ที่ดึงข้อมูลต้องตรงกับคำนำหน้าในรายการนี้ ซึ่งจะช่วยปกป้องข้อมูลผู้ใช้ ช่องนี้ไม่บังคับสำหรับการทําให้การทดสอบใช้งานได้ แต่ต้องกรอกข้อมูลในช่องนี้สําหรับการทําให้การใช้งานได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับ URL ที่อนุญาต

webapp

object (Webapp)

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