Mengelola Proyek

Bagian ini memberikan ringkasan metode Apps Script API yang dapat Anda gunakan untuk membuat, membaca, memodifikasi, dan memantau project Apps Script. Halaman contoh Pengelolaan Project menunjukkan contoh permintaan pengelolaan API. Dokumentasi referensi untuk setiap metode menyediakan detail implementasi.

Ringkasan metode API
Membuat project

projects.create

Hasil: Buat project dasar yang kosong tanpa file project dan manifes project default.

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

Membaca metadata project

projects.get

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

Membaca konten project

project.getContent

Results: 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.

Mengupdate 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 dari project skrip. Konten baru ini disimpan sebagai versi HEAD project. Parameter ini digunakan saat skrip dijalankan 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 yang umum adalah mengeluarkan permintaan projects.getContent terlebih dahulu untuk mengambil array File yang ada, sesuai dengan keinginan objek tersebut, lalu gunakan File sebagai input untuk permintaan projects.updateContent.

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

Baca metrik project

project.getMetrics

Hasil: Membaca metrik tertentu tentang sebuah 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.