Dasbor Apps Script memungkinkan Anda mengelola dan memantau project Apps Script Anda. Anda dapat menggunakan dasbor untuk melakukan hal berikut:
- Melihat dan menelusuri project Apps Script yang ada, termasuk Skrip bound yang dilampirkan ke Google Workspace dokumen.
- Membuat project baru.
- Melihat detail tentang project Anda, seperti Cakupan OAuth yang digunakannya.
- Memantau kondisi dan penggunaan project skrip Anda.
- Melihat log eksekusi untuk project Anda dan project lain yang dijalankan menggunakan memiliki kredensial yang lengkap.
- 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 proyek ini ke dalam beberapa kategori:
- Project Berbintang. Project yang sedang Anda pantau.
- Project Saya. Project yang Anda miliki.
- Semua Project. Project yang izin lihat atau editnya Anda miliki.
- Dibagikan kepada saya. Project yang bukan milik Anda, tetapi telah dibagikan dengan Anda.
- Sampah. Project yang telah Anda hapus dari Google Drive.
Daftar project menampilkan nama project, pemilik, dan tanggal terakhir diubah. Tujuan ikon di samping nama proyek yang menunjukkan apakah proyek tersebut mandiri atau project yang terikat.
Lihat detail project
Setiap project menyertakan tampilan untuk melihat detail developer tentang project. Kepada melihat detail tentang sebuah proyek, klik baris dari daftar proyek.
Tampilan detail project menampilkan Tingkat error, Eksekusi, dan Pengguna data dan grafik tentang proyek, serta Cakupan OAuth yang diminta dari pengguna akhir yang menggunakan menyelesaikan proyek tersebut. Metrik data ditentukan sebagai berikut:
- Tingkat error. Persentase eksekusi yang gagal dijalankan karena pengecualian yang tidak tertangkap. Jumlah ini dihitung sebagai eksekusi yang gagal dibagi dengan total eksekusi selama jangka waktu yang ditentukan.
- Eksekusi. Frekuensi proyek telah "dijalankan" atau dieksekusi. Lihat Jenis eksekusi untuk informasi selengkapnya tentang bagaimana project dapat dijalankan.
- Pengguna. Jumlah pengguna unik (akun) yang menjalankan proyek satu atau kali lagi selama jangka waktu yang ditentukan. Pengguna anonim tidak dilacak dan karenanya tidak tercermin dalam jumlah atau grafik pengguna.
Setiap deployment project Anda akan muncul sebagai tab di Project Details di atas data dan grafik; Anda dapat memilih tab untuk melihat data terkait untuk deployment tersebut. Memilih SEMUA acara menggabungkan data dari semua deployment proyek dan dari pelaksanaannya dihasilkan dari developer yang menjalankan project dari dalam Apps Script editor kode.
Memantau project
Anda mungkin memiliki akses ke lebih banyak project Apps Script secara signifikan daripada yang Anda gunakan atau mengelola secara teratur. Untuk mem-bookmark project agar mudah diakses, Anda dapat membintanginya. Memberi bintang pada project juga memungkinkan Anda memantau statistik tingkat error dan penggunaan agregat pada proyek-proyek tersebut.
Untuk membintangi project, di sebelah kanan baris project, klik Lainnya > Tambahkan bintang. Anda juga dapat membintangi proyek dengan mengeklik {i>More<i} saat melihat detail project.
Di navigasi sebelah kiri, Anda dapat memilih Project Berbintang untuk melihat project yang Anda bookmark. Klik Error rate, Executions, atau Users kartu skor di bagian atas laman untuk melihat grafik yang terkait untuk semua project berbintang selama 7 hari terakhir.
Anda dapat menghapus bintang dari project dengan mengklik Lainnya di baris project dan memilih Hapus bintang.
Mengelola eksekusi
Anda dapat menggunakan dasbor Apps Script untuk melihat dan mengelola eksekusi individual fungsi project Apps Script. Anda dapat menemukan log lengkap mengenai dengan memilih item My Executions di navigasi sebelah kiri.
Panel Eksekusi Saya menampilkan log semua aktivitas sebelumnya dan saat ini secara default menjalankan eksekusi untuk proyek di mana Anda merupakan pemilik, editor, pelihat. Daftar ini juga dapat mencakup eksekusi fungsi dalam project yang tidak dapat mengaksesnya jika dijalankan atas nama Anda (misalnya, add-on yang yang telah Anda instal dan jalankan). Daftar eksekusi hanya menampilkan fungsi awal yang dipanggil untuk memulai eksekusi. Ini tidak menunjukkan setiap fungsi yang dipanggil saat eksekusi.
Anda dapat mengontrol jenis eksekusi yang dilaporkan dalam log menggunakan {i>filter<i} di bagian atas tampilan. Setiap baris log ini mewakili satu dalam proses eksekusi. Kolom Start Time, Duration, dan Status menunjukkan informasi yang sesuai tentang eksekusi tersebut.
Kolom Function menampilkan nama fungsi yang memulai dalam pelaksanaannya. Tidak ada nama di kolom ini jika Anda tidak memiliki akses ke proyek skrip eksekusi yang sesuai tetapi itu 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 API Apps Script.
- Didorong oleh Waktu. 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 yang saat ini sedang berlangsung ditunjukkan oleh Status "Running". Untuk menghentikan eksekusi ini, di sebelah kanan project baris, klik Lainnya > Hentikan.
Setelan
Anda dapat menyesuaikan setelan dasbor dengan memilih Setelan di navigasi kiri.
Di panel Setelan adalah tombol untuk Apps Script API. Hal ini memungkinkan Anda memberikan API akses ke project skrip Anda.
Untuk mengakses tombol ini, klik Google Apps Script API label di panel Setelan. Cara ini akan membuka panel baru dengan teks peringatan dan sebuah tombol. Akses ke project skrip Anda dinonaktifkan secara default sebagai tindakan pencegahan keamanan. Setelah Anda memberikan akses, aplikasi pihak ketiga yang Anda otorisasi bisa menggunakan API ini untuk memodifikasi skrip dan penerapan Anda. Anda dapat mencabut akses ini di panel Setelan kapan saja.
Temukan informasi selengkapnya di Panduan akses Apps Script API.