Dasbor Apps Script memungkinkan Anda mengelola dan memantau project Apps Script. Gunakan dasbor untuk:
- Melihat dan menelusuri project Apps Script yang ada, termasuk skrip terikat yang dilampirkan ke dokumen Google Workspace.
- Buat project baru.
- Melihat detail tentang project Anda, seperti cakupan OAuth yang digunakannya.
- Pantau kondisi dan penggunaan project skrip Anda.
- Melihat log eksekusi untuk project Anda dan project lain 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 ini ke dalam kategori berikut:
- Project Berbintang. Project yang Anda pantau.
- Project Saya. Project yang Anda miliki.
- Semua Project. Project yang Anda miliki atau yang izin lihat atau editnya 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.
Melihat detail project
Setiap project menyertakan tampilan untuk melihat detail developer tentang project. Untuk melihat detail tentang project, klik baris dari daftar project.
Tampilan detail project menampilkan data dan grafik Tingkat error, Eksekusi, dan Pengguna tentang project, serta cakupan OAuth yang diminta dari setiap pengguna project. Metrik data didefinisikan sebagai berikut:
- Rasio error. Persen eksekusi yang gagal dijalankan karena pengecualian yang tidak tertangkap. Metrik ini dihitung sebagai eksekusi gagal dibagi dengan total eksekusi selama jangka waktu yang ditentukan.
- Eksekusi. Jumlah project yang telah "dijalankan" atau dieksekusi. Lihat Jenis eksekusi untuk mengetahui informasi selengkapnya tentang cara menjalankan project.
- Pengguna. Jumlah akun pengguna unik yang menjalankan project satu kali atau lebih selama jangka waktu yang ditentukan. Pengguna anonim tidak dilacak dan oleh karena itu tidak tercermin dalam jumlah atau grafik pengguna.
Setiap deployment project Anda muncul sebagai tab di halaman Detail Project sebelum data dan grafik; pilih tab untuk melihat data terkait untuk 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.
Project yang dipublikasikan sebagai add-on tidak muncul sebagai di-deploy di dasbor Apps Script.
Memantau project
Beri bintang pada project untuk mem-bookmark-nya. Dengan membintangi project, Anda juga dapat memantau statistik dan grafik penggunaan gabungan serta rasio error.
Untuk membintangi project, di sebelah kanan baris project, klik Lainnya > Tambahkan bintang. Anda juga dapat membintangi project dengan mengklik Lainnya saat melihat detail project.
Di navigasi kiri, pilih Starred Projects untuk melihat project yang telah Anda tandai. Klik kartu skor Rasio error, Eksekusi, atau Pengguna di bagian atas halaman untuk melihat grafik terkait semua project berbintang Anda selama 7 hari terakhir.
Hapus bintang dari project dengan mengklik Lainnya di baris project-nya dan memilih Hapus bintang.
Mengelola eksekusi
Gunakan dasbor Apps Script untuk melihat dan mengelola setiap eksekusi fungsi project Apps Script. Temukan log lengkap eksekusi terbaru dengan memilih Eksekusi Saya di navigasi kiri.
Panel Eksekusi Saya menampilkan log semua eksekusi sebelumnya dan yang sedang berjalan untuk project yang Anda miliki, edit, atau lihat. Daftar ini juga dapat mencakup eksekusi fungsi di project yang tidak dapat Anda akses jika fungsi tersebut berjalan atas nama Anda (misalnya, add-on yang telah Anda instal dan jalankan). Daftar eksekusi hanya menampilkan fungsi awal yang dipanggil untuk memulai eksekusi. Tidak menampilkan setiap fungsi yang dipanggil selama eksekusi tersebut.
Kontrol 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 dengan eksekusi, tetapi project tersebut dijalankan atas nama Anda.
Kolom Jenis menunjukkan apa yang memulai eksekusi. Nilai mencakup:
- Add-On. Eksekusi berasal dari add-on.
- Execution API. Eksekusi berasal dari pemanggilan Apps Script API.
- Time Driven. Eksekusi disebabkan oleh peristiwa waktu.
- Pemicu. Eksekusi berasal dari sumber pemicu.
- Webapp. Eksekusi berasal dari aplikasi web yang di-deploy.
- Editor. Eksekusi berasal dari editor Apps Script.
Menghentikan eksekusi
Eksekusi yang berjalan lama dan sedang berlangsung ditunjukkan oleh Status "Berjalan". Untuk menghentikan eksekusi ini, di sebelah kanan baris project, klik Lainnya > Hentikan.
Setelan
Sesuaikan setelan dasbor Anda dengan memilih Setelan di menu navigasi kiri.
Di panel Setelan terdapat tombol untuk Apps Script API. Dengan demikian, Anda dapat memberikan 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 pengalih. Akses ke project skrip Anda dinonaktifkan secara default sebagai tindakan pencegahan keamanan. Setelah Anda memberikan akses, aplikasi pihak ketiga yang Anda beri otorisasi dapat menggunakan API untuk mengubah skrip dan deployment Anda. Cabut akses ini di panel Setelan kapan saja.
Temukan informasi selengkapnya di panduan akses Apps Script API.