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

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

ภาพรวมเมธอด API
สร้างโปรเจ็กต์	projects.create ผลลัพธ์: สร้างโปรเจ็กต์พื้นฐานที่ว่างเปล่าโดยไม่มีไฟล์โปรเจ็กต์และไฟล์ Manifest ของโปรเจ็กต์เริ่มต้น ตัวเลือก: คุณสามารถระบุชื่อโปรเจ็กต์ได้ นอกจากนี้ คุณยังสร้างสคริปต์ที่เชื่อมโยงได้โดยระบุรหัส Google ไดรฟ์ของไฟล์ Google เอกสาร, Google ชีต, Google ฟอร์ม หรือสไลด์เพื่อใช้เป็นรายการหลักของสคริปต์
อ่านข้อมูลเมตาของโปรเจ็กต์	projects.get ผลลัพธ์: ดึงข้อมูลออบเจ็กต์ Project ซึ่งแสดงข้อมูลเมตาของโปรเจ็กต์ ข้อมูลนี้ประกอบด้วยชื่อโปรเจ็กต์ รหัสสคริปต์ ผู้ใช้ที่สร้าง เวลาสร้าง และรายละเอียดอื่นๆ
อ่านเนื้อหาโปรเจ็กต์	projects.getContent ผลลัพธ์: แสดงผลอาร์เรย์ออบเจ็กต์ File 1 รายการสําหรับโค้ดและไฟล์ HTML แต่ละรายการในโปรเจ็กต์ รายการนี้ยังรวมไฟล์ Manifest ของโปรเจ็กต์เป็นไฟล์ JSON ด้วย ออบเจ็กต์ไฟล์มีเนื้อหาต้นทางของไฟล์ (File.source) และข้อมูลเมตาอื่นๆ เช่น รายการฟังก์ชันในไฟล์ (File.functionSet) ตัวเลือก: คุณระบุเวอร์ชันของเนื้อหาที่จะดึงข้อมูลได้ด้วยพารามิเตอร์การค้นหา
อัปเดตเนื้อหาโปรเจ็กต์	projects.updateContent ผลลัพธ์: เปลี่ยนเนื้อหาไฟล์ในโปรเจ็กต์สคริปต์ คุณระบุเนื้อหาใหม่เป็นอาร์เรย์ออบเจ็กต์ File ออบเจ็กต์ File รายการใดรายการหนึ่งต้องเป็นประเภท JSON และแสดงถึงไฟล์ Manifest ของโปรเจ็กต์ใหม่ของโปรเจ็กต์สคริปต์ ระบบจะจัดเก็บเนื้อหาใหม่เป็นเวอร์ชัน HEAD ของโปรเจ็กต์ จะใช้เมื่อสคริปต์ทำงานเป็นทริกเกอร์ ในเครื่องมือแก้ไขสคริปต์ ในโหมดตัวอย่างของส่วนเสริม หรือเป็นเว็บแอปหรือ Apps Script API ในโหมดการพัฒนา หมายเหตุ: เมื่ออัปเดตเนื้อหาโปรเจ็กต์สคริปต์ แนวทางปฏิบัติทั่วไปคือส่งคำขอ projects.getContent ก่อนเพื่อดึงข้อมูลอาร์เรย์ของ File ที่มีอยู่ แล้วทำการเปลี่ยนแปลงที่ต้องการกับออบเจ็กต์เหล่านั้น จากนั้นใช้ File เป็นอินพุตสำหรับคำขอ projects.updateContent คำเตือน: เนื้อหาใหม่จะแทนที่ไฟล์ที่มีอยู่ทั้งหมดในโปรเจ็กต์สคริปต์ ระบบจะนำไฟล์ที่ไม่ได้อัปเดตตามคำขอออก
อ่านเมตริกโปรเจ็กต์	projects.getMetrics ผลลัพธ์: อ่านเมตริกบางอย่างเกี่ยวกับโปรเจ็กต์ เมตริกเหล่านี้รวมถึงจํานวนผู้ใช้ จํานวนการเรียกใช้ทั้งหมด จํานวนข้อผิดพลาดทั้งหมดในการเรียกใช้ และรายละเอียดอื่นๆ ใช้ MetricType เพื่อระบุข้อมูลที่คุณต้องการ ตัวเลือก: จํากัดผลลัพธ์ให้แสดงเฉพาะการติดตั้งใช้งานหรือฟังก์ชันสคริปต์ที่เฉพาะเจาะจงโดยใช้ MetricsFilter นอกจากนี้ คุณยังกําหนดช่วงเวลาของเมตริกที่เฉพาะเจาะจงได้โดยใช้ MetricsIntervalConfig