Mengelola Proyek

Bagian ini memberikan ringkasan tentang metode Apps Script API yang dapat Anda gunakan untuk membuat, membaca, memodifikasi, dan pantau project Apps Script Anda. Tujuan Pengelolaan Project halaman contoh menampilkan contoh permintaan pengelolaan API. Referensi dokumentasi untuk setiap metode memberikan detail implementasi.

Ringkasan metode API
Membuat project

projects.create

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

Opsi: Anda dapat memberikan judul project. Anda juga dapat buat skrip terikat dengan memberikan ID Google Drive untuk Google Dokumen, Google Spreadsheet, Google Formulir, atau Slide {i>file<i} untuk bertindak sebagai induk skrip.

Membaca metadata project

projects.get

Hasil: Mengambil Project , yang mewakili metadata project. Data ini mencakup judul proyek, ID skrip, pengguna pembuatan, waktu pembuatan, dan spesifikasi pendukung.

Membaca konten project

projects.getContent

Results: Menampilkan array File , satu untuk setiap kode dan file HTML dalam proyek. Daftar ini juga mencakup 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 kepada ambil dengan parameter kueri.

Memperbarui konten project

projects.updateContent

Hasil: Mengubah konten file dalam project skrip. Anda menyediakan konten baru sebagai array File objek terstruktur dalam jumlah besar. Salah satu objek File ini harus memiliki jenis JSON dan merepresentasikan elemen baru manifes project. Yang baru konten disimpan sebagai versi HEAD project. Model ini digunakan ketika skrip dijalankan sebagai pemicu, di editor skrip, di add-on mode pratinjau, atau sebagai aplikasi web atau Apps Script API dalam mode pengembangan.

Catatan: Saat memperbarui konten project skrip, praktik yang baik adalah dengan terlebih dahulu projects.getContent untuk mengambil array dari File yang ada, membuat keinginan terhadap 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 atas permintaan akan dihapus.

Membaca metrik project

projects.getMetrics

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

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