การจัดการโครงการ

ส่วนนี้แสดงภาพรวมของเมธอด Apps Script API ที่คุณสามารถใช้เพื่อสร้าง อ่าน แก้ไข และตรวจสอบโครงการ Apps Script ได้ หน้าตัวอย่างการจัดการโครงการแสดงตัวอย่างคำขอการจัดการ API เอกสารประกอบอ้างอิงสำหรับแต่ละวิธีจะมีรายละเอียดการนำไปใช้งาน

ภาพรวมของเมธอด API
สร้างโปรเจ็กต์

project.create

ผลลัพธ์: สร้างโปรเจ็กต์พื้นฐานที่ว่างเปล่าโดยไม่มีไฟล์โปรเจ็กต์และไฟล์ Manifest ของโปรเจ็กต์เริ่มต้น

ตัวเลือก: คุณระบุชื่อโปรเจ็กต์ได้ นอกจากนี้ คุณยังสร้างสคริปต์ที่เชื่อมโยงได้โดยระบุรหัส Google ไดรฟ์ของไฟล์ Google เอกสาร, Google ชีต, Google ฟอร์ม หรือสไลด์เพื่อทำหน้าที่เป็นระดับบนสุดของสคริปต์

อ่านข้อมูลเมตาของโปรเจ็กต์

project.get

ผลลัพธ์: เรียกออบเจ็กต์ Project ซึ่งแสดงข้อมูลเมตาของโปรเจ็กต์ ข้อมูลนี้รวมถึงชื่อโปรเจ็กต์ รหัสสคริปต์ ผู้ใช้ที่สร้าง เวลาที่สร้าง และรายละเอียดอื่นๆ

อ่านเนื้อหาโครงการ

project.getContent

ผลลัพธ์: แสดงผลอาร์เรย์ของออบเจ็กต์ File โดยจะแสดง 1 รายการสําหรับโค้ดแต่ละรายการและไฟล์ HTML ในโปรเจ็กต์ รายการนี้ยังมีไฟล์ Manifest ของโปรเจ็กต์เป็นไฟล์ JSON ด้วย ออบเจ็กต์ไฟล์มีเนื้อหาแหล่งที่มาของไฟล์ (File.source) และข้อมูลเมตาอื่นๆ เช่น รายการฟังก์ชันในไฟล์ (File.functionSet)

ตัวเลือก: คุณระบุเวอร์ชันของเนื้อหาที่จะดึงข้อมูลได้ด้วยพารามิเตอร์การค้นหา

อัปเดตเนื้อหาโปรเจ็กต์

projects.updateContent

ผลลัพธ์: เปลี่ยนเนื้อหาไฟล์ในโปรเจ็กต์สคริปต์ คุณระบุเนื้อหาใหม่เป็นอาร์เรย์ของออบเจ็กต์ File ออบเจ็กต์ File รายการใดรายการหนึ่งเหล่านี้ต้องมีประเภท JSON และแสดงถึงไฟล์ Manifest ของโปรเจ็กต์ใหม่ของโปรเจ็กต์สคริปต์ เนื้อหาใหม่จะจัดเก็บเป็นเวอร์ชัน HEAD ของโปรเจ็กต์ โดยจะใช้เมื่อสคริปต์ดำเนินการเป็นทริกเกอร์ในเครื่องมือแก้ไขสคริปต์ ในโหมดแสดงตัวอย่างของส่วนเสริม หรือเป็นเว็บแอปหรือ Apps Script API ในโหมดการพัฒนาซอฟต์แวร์

หมายเหตุ: เมื่ออัปเดตเนื้อหาโปรเจ็กต์สคริปต์ แนวทางปฏิบัติทั่วไปคือการออกคำขอ project.getContent เพื่อเรียกอาร์เรย์ของ File ที่มีอยู่ก่อน จากนั้นใช้ File เป็นอินพุตสำหรับคำขอ project.updateContent

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

อ่านเมตริกของโปรเจ็กต์

project.getMetrics

ผลลัพธ์: อ่านเมตริกบางรายการเกี่ยวกับโปรเจ็กต์ เมตริกเหล่านี้ประกอบด้วยจำนวนผู้ใช้ จำนวนการดำเนินการทั้งหมด จำนวนข้อผิดพลาดในการดำเนินการทั้งหมด และรายละเอียดอื่นๆ ใช้ MetricType เพื่อระบุข้อมูลที่คุณขอ

ตัวเลือก: จำกัดผลลัพธ์เฉพาะการทำให้ใช้งานได้หรือฟังก์ชันสคริปต์ที่เฉพาะเจาะจงโดยใช้ MetricsFilter นอกจากนี้ คุณยังกำหนดช่วงเวลาเมตริกที่เฉพาะเจาะจงได้โดยใช้ MetricsIntervalConfig