Mengelola Proyek

Bagian ini memberikan ringkasan tentang metode Apps Script API yang dapat Anda gunakan untuk membuat, membaca, mengubah, dan memantau project Apps Script. Halaman contoh Project Management menampilkan contoh permintaan pengelolaan API. Dokumentasi referensi untuk setiap metode memberikan detail implementasi.

Ringkasan metode API
Membuat project

projects.create

Hasil: Membuat project kosong dasar tanpa file project dan manifes project default.

Opsi: Anda dapat memberikan judul project. Anda juga dapat membuat skrip terikat dengan memberikan ID Google Drive file Google Dokumen, Google Spreadsheet, Google Formulir, atau Slide untuk bertindak sebagai induk skrip.

Membaca metadata project

projects.get

Hasil: Mengambil objek Project, yang mewakili metadata project. Data ini mencakup judul project, ID skrip, pengguna pembuat, waktu pembuatan, dan detail lainnya.

Membaca konten project

projects.getContent

Hasil: Menampilkan array objek File, satu untuk setiap kode dan file HTML dalam project. Daftar ini juga menyertakan manifes project sebagai file JSON. Objek file berisi konten sumber file (File.source) dan metadata lainnya, seperti daftar fungsi dalam file (File.functionSet).

Opsi: Anda dapat menentukan versi konten yang akan diambil dengan parameter kueri.

Memperbarui konten project

projects.updateContent

Hasil: Mengubah konten file dalam project skrip. Anda memberikan konten baru sebagai array objek File. Salah satu objek File ini harus memiliki jenis JSON dan mewakili manifes project baru project skrip. Konten baru disimpan sebagai versi HEAD project. Fungsi ini digunakan saat skrip dieksekusi sebagai pemicu, di editor skrip, dalam mode pratinjau add-on, atau sebagai aplikasi web atau Apps Script API dalam mode pengembangan.

Catatan: Saat memperbarui konten project skrip, praktik umum adalah terlebih dahulu mengeluarkan permintaan projects.getContent untuk mengambil array File yang ada, membuat keinginan ke objek tersebut, lalu menggunakan File sebagai input untuk permintaan projects.updateContent.

Peringatan: Konten baru akan menggantikan semua file yang ada dalam project skrip. File yang tidak diperbarui oleh permintaan akan dihapus.

Membaca metrik project

projects.getMetrics

Hasil: Membaca metrik tertentu tentang project. Metrik ini mencakup jumlah pengguna, jumlah total eksekusi, jumlah total error eksekusi, dan detail lainnya. Gunakan MetricType untuk menentukan informasi yang Anda minta.

Opsi: Batasi hasil ke deployment atau fungsi skrip tertentu menggunakan MetricsFilter. Anda juga dapat menentukan interval metrik tertentu menggunakan MetricsIntervalConfig.