Dasbor Apps Script memungkinkan Anda mengelola dan memantau project Apps Script. Anda dapat menggunakan dasbor untuk melakukan salah satu tindakan berikut:
- Lihat dan telusuri project Apps Script yang ada, termasuk skrip terikat yang dilampirkan ke dokumenGoogle Workspace .
- Membuat project baru.
- Lihat detail tentang project Anda, seperti cakupan OAuth yang digunakannya.
- Memantau kondisi dan penggunaan project skrip Anda.
- Melihat log eksekusi untuk project Anda dan project lainnya yang berjalan menggunakan kredensial akun Anda.
- Aktifkan atau nonaktifkan Apps Script API untuk mengizinkan atau mencegah aplikasi menggunakan API untuk berinteraksi dengan project skrip Anda.
Melihat dan menelusuri project
Dasbor Apps Script mencantumkan semua project skrip yang dapat Anda lihat atau edit. Navigasi kiri dasbor membagi project tersebut ke dalam kategori berikut:
- Project Berbintang. Project yang Anda monitoring.
- Project Saya. Project yang Anda miliki sebagai pemilik.
- Semua Project. Project yang Anda miliki atau yang izin lihat atau edit-nya Anda miliki.
- Dibagikan kepada saya. Project yang bukan milik Anda, tetapi telah dibagikan kepada Anda.
- Sampah. Project yang telah Anda hapus dari Google Drive.
Daftar project menampilkan nama project, pemilik, dan tanggal terakhir diubah. Ikon di samping nama project menunjukkan apakah project tersebut adalah project mandiri atau project terikat.
Lihat detail project
Setiap project menyertakan tampilan untuk melihat detail developer tentang project tersebut. Untuk melihat detail tentang project, klik baris dari daftar project.
Tampilan detail project menampilkan data Error rate, Executions dan Users serta grafik tentang project, serta cakupan OAuth yang diminta dari pengguna akhir yang menggunakan project. Metrik data didefinisikan sebagai berikut:
- Tingkat error. Persentase eksekusi yang gagal dijalankan karena pengecualian yang tidak tertangkap. Metrik ini dihitung sebagai eksekusi yang gagal dibagi dengan total eksekusi selama jangka waktu yang ditentukan.
- Eksekusi. Frekuensi project "dijalankan" atau dieksekusi. Lihat Jenis eksekusi untuk mengetahui informasi lebih lanjut tentang bagaimana project dapat dijalankan.
- Pengguna. Jumlah pengguna unik (akun) yang menjalankan project satu atau beberapa kali selama jangka waktu yang ditentukan. Pengguna anonim tidak dilacak sehingga tidak tercermin dalam jumlah atau grafik pengguna.
Setiap deployment project Anda akan muncul sebagai tab di halaman Project Details di atas data dan grafik. Anda dapat memilih tab tersebut untuk melihat data terkait deployment tersebut. Memilih SEMUA akan menampilkan data gabungan untuk semua deployment project dan dari eksekusi yang dihasilkan dari developer yang menjalankan project dari dalam editor kode Apps Script.
Memantau project
Anda mungkin memiliki akses ke lebih banyak project Apps Script yang jauh lebih banyak daripada yang Anda gunakan atau kelola secara rutin. Untuk mem-bookmark project agar mudah diakses, Anda dapat memberinya bintang. Memberi bintang pada project juga memungkinkan Anda memantau penggunaan agregat dan statistik tingkat error serta grafik pada project tersebut.
Untuk membintangi project, di sebelah kanan baris project, klik Lainnya > Tambahkan bintang. Anda juga dapat membintangi project dengan mengklik More saat melihat detail project.
Di navigasi sebelah kiri, Anda dapat memilih Project Berbintang untuk melihat project yang telah di-bookmark. Klik kartu skor Error rate, Executions, atau Users di bagian atas halaman guna melihat grafik yang terkait untuk semua project berbintang Anda selama 7 hari terakhir.
Anda dapat menghapus bintang dari project dengan mengklik More pada baris project-nya, lalu memilih Remove star.
Mengelola eksekusi
Anda dapat menggunakan dasbor Apps Script untuk melihat dan mengelola setiap eksekusi fungsi project Apps Script. Anda dapat menemukan log lengkap dari eksekusi terbaru dengan memilih item My Executions di navigasi sebelah kiri.
Panel My Execution menampilkan log secara default dari semua eksekusi yang sebelumnya dan sedang berjalan untuk project yang pemilik, editor, atau pelihatnya. Daftar ini juga dapat mencakup eksekusi fungsi dalam project yang tidak dapat Anda akses jika dijalankan atas nama Anda (misalnya, add-on yang telah Anda instal dan jalankan). Daftar eksekusi hanya menampilkan fungsi awal yang dipanggil untuk memulai eksekusi. Kode ini tidak menampilkan setiap fungsi yang dipanggil selama eksekusi tersebut.
Anda dapat mengontrol jenis eksekusi yang dilaporkan dalam log menggunakan filter di bagian atas tampilan. Setiap baris log mewakili satu eksekusi. Kolom Waktu Mulai, Durasi, dan Status menampilkan informasi yang sesuai tentang eksekusi tersebut.
Kolom Function menampilkan nama fungsi yang memulai eksekusi. Tidak ada nama di kolom ini jika Anda tidak memiliki akses ke project skrip yang sesuai dalam eksekusi, tetapi project tersebut berjalan atas nama Anda.
Kolom Jenis menampilkan hal yang memulai eksekusi. Nilai mencakup:
- Add On. Eksekusi berasal dari add-on.
- Execution API Eksekusi berasal dari pemanggilan Apps Script API.
- Berdasarkan Waktu. Eksekusi disebabkan oleh peristiwa waktu.
- Pemicu. Eksekusi berasal dari sumber pemicu.
- Aplikasi web. Eksekusi berasal dari aplikasi web yang di-deploy.
- Editor. Eksekusi berasal dari editor Apps Script.
Menghentikan eksekusi
Eksekusi yang berjalan lama yang sedang berlangsung ditunjukkan dengan Status "Running". Untuk menghentikan eksekusi ini, di sebelah kanan baris project, klik More > Hentikan.
Setelan
Anda dapat menyesuaikan setelan dasbor dengan memilih Setelan di navigasi sebelah kiri.
Di panel Settings adalah tombol untuk Apps Script API. Dengan demikian, Anda dapat memberi API akses ke project skrip Anda.
Untuk mengakses tombol ini, klik label Google Apps Script API di panel Setelan. Tindakan ini akan membuka panel baru dengan teks peringatan dan tombol. Akses ke project skrip dinonaktifkan secara default sebagai tindakan pencegahan keamanan. Setelah Anda memberikan akses, aplikasi pihak ketiga apa pun yang Anda beri otorisasi dapat menggunakan API untuk mengubah skrip dan deployment Anda. Anda dapat mencabut akses ini di panel Setelan kapan saja.
Temukan informasi selengkapnya di panduan akses Apps Script API.