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

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

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