Dasbor Apps Script memungkinkan Anda mengelola dan memantau project Apps Script. Anda dapat menggunakan dasbor untuk melakukan tindakan berikut:
- Lihat dan telusuri project Apps Script yang ada, termasuk skrip terikat yang dilampirkan padaGoogle Workspace dokumen.
- Membuat project baru.
- Melihat detail tentang project Anda, seperti cakupan OAuth yang digunakannya.
- Pantau kondisi dan penggunaan project skrip Anda.
- Lihat log eksekusi untuk project Anda dan log lain yang dijalankan 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 yang Berbintang. Project yang Anda pantau.
- Project Saya. Project yang Anda miliki.
- Semua Project. Project yang izin lihat atau editnya Anda miliki atau 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 merupakan project mandiri atau project terikat.
Melihat detail project
Setiap project menyertakan tampilan untuk melihat detail developer tentang project tersebut. Untuk melihat detail project, klik baris dari daftar project.
Tampilan detail project menunjukkan data dan grafik Rasio error, Eksekusi, dan Pengguna terkait project, serta cakupan OAuth yang diminta dari pengguna akhir yang menggunakan project tersebut. Metrik data didefinisikan sebagai berikut:
- Tingkat error. Persentase eksekusi yang gagal dijalankan karena pengecualian yang tidak tertangkap. Ini dihitung sebagai eksekusi yang gagal dibagi dengan total eksekusi selama jangka waktu yang ditentukan.
- Eksekusi. Frekuensi project telah "dijalankan" atau dijalankan. Lihat Jenis eksekusi untuk informasi selengkapnya tentang cara project dapat dijalankan.
- Pengguna. Jumlah pengguna (akun) unik yang menjalankan project satu atau beberapa kali selama jangka waktu yang ditentukan. Pengguna anonim tidak dilacak sehingga tidak tercermin dalam grafik atau jumlah pengguna.
Setiap deployment project Anda akan muncul sebagai tab di halaman Project Details di atas data dan grafik; Anda dapat memilih tab untuk melihat data yang terkait dengan 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 daripada yang Anda gunakan atau kelola secara rutin. Anda dapat membintangi project untuk memudahkan akses ke project. Dengan memberi bintang pada project, Anda juga dapat memantau statistik penggunaan dan tingkat error gabungan serta grafik pada project tersebut.
Untuk memberi bintang pada project, di sebelah kanan baris project, klik More > Add star. Anda juga dapat memberi bintang pada project dengan mengklik Lainnya 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 untuk melihat grafik terkait untuk semua project berbintang selama 7 hari terakhir.
Anda dapat menghapus bintang dari project dengan mengklik Lainnya di baris project-nya dan memilih Remove star.
Mengelola eksekusi
Anda dapat menggunakan dasbor Apps Script untuk melihat dan mengelola eksekusi individu dari fungsi project Apps Script. Anda dapat menemukan log lengkap eksekusi terbaru dengan memilih item Eksekusi Saya di navigasi sebelah kiri.
Panel My Executions secara default menampilkan log dari semua eksekusi sebelumnya dan yang sedang berjalan untuk project yang pemilik, editor, atau penampilnya adalah Anda. 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. Fungsi 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 Start Time, Duration, 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 terkait dengan eksekusi, tetapi berjalan atas nama Anda.
Kolom Type menampilkan hal yang memulai eksekusi. Nilai mencakup:
- Add On. Eksekusi berasal dari add-on.
- API eksekusi. 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 oleh Status "Berjalan". Untuk menghentikan eksekusi ini, di sebelah kanan baris project, klik More > Stop.
Setelan
Anda dapat menyesuaikan setelan dasbor dengan memilih Setelan di navigasi sebelah kiri.
Di panel Settings adalah tombol untuk Apps Script API. Langkah ini memungkinkan Anda memberi API akses ke project skrip.
Untuk mengakses tombol ini, klik label Google Apps Script API di panel Setelan. Tindakan ini akan membuka panel baru yang berisi teks peringatan dan tombol beralih. 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 ini 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.
Support
Jika Anda mengalami error atau memerlukan bantuan untuk menggunakan dasbor Apps Script, sebaiknya Anda memulai dengan menelusuri atau memposting ke Stack Overflow:
CUJ
Jika telah menentukan bahwa penyebab masalah adalah karena bug di dasbor itu sendiri, Anda dapat menelusuri Pelacak Masalah untuk menentukan apakah masalah tersebut merupakan masalah umum. Jika demikian, Anda dapat membintangi masalah (klik bintang di samping nomor masalah)—kami memprioritaskan bug yang menerima lebih banyak bintang. Anda juga dapat menambahkan komentar pada masalah yang ada, tetapi hanya lakukan tindakan tersebut jika Anda menambahkan konteks atau informasi lain terkait masalah tersebut.
Jika masalah tersebut benar-benar baru, Anda juga dapat melaporkannya di Pelacak Masalah kami. Jika Anda melakukan tindakan tersebut, pastikan Anda menyertakan informasi berikut dalam deskripsi bug:
- Deskripsi masalah dan perilaku semestinya yang Anda harapkan.
- Daftar langkah-langkah yang dapat digunakan untuk memunculkan kembali masalahnya.
- Deskripsi output yang Anda harapkan dan hal yang sebenarnya terjadi. Sertakan pesan error yang Anda terima.
- Informasi tentang lingkungan pengembangan Anda, termasuk bahasa pemrograman, versi library, dll.
Perlu diketahui bahwa Anda mungkin belum mendapatkan tanggapan terkait masalah yang Anda laporkan untuk sementara waktu. Hal ini bukan berarti kami tidak akan pernah memperbaiki masalahnya; hanya saja info terbaru mengenai masalah tersebut saat ini belum tersedia.
Fitur yang Hilang
Jika fitur atau fungsi yang tidak ada di dasbor sudah ingin dimiliki, Anda dapat menelusuri Issue Tracker untuk menentukan apakah orang lain telah memintanya. Jika sudah diminta, beri bintang pada masalah (klik bintang di samping nomor masalah)—kami memprioritaskan bug yang menerima lebih banyak bintang. Anda juga dapat menambahkan komentar ke masalah yang ada, tetapi hanya lakukan tindakan tersebut jika Anda menambahkan konteks atau informasi lain terkait masalah tersebut.
Jika fitur tersebut belum diminta, Anda dapat mengajukan permintaan fitur pada Pelacak Masalah kami. Harap jelaskan fungsi spesifik yang Anda inginkan agar ditambahkan, serta alasan yang menurut Anda penting. Jika memungkinkan, sertakan detail spesifik tentang kasus penggunaan Anda dan peluang baru terkait kegunaan fitur tersebut.