Google Apps Script API memerlukan berbagai jenis otorisasi, bergantung pada tujuan Anda:
- Gunakan Apps Script API di aplikasi Anda.
- Mengizinkan aplikasi lain mengelola data atau deployment project skrip Anda.
Untuk menggunakan Apps Script API di aplikasi, Anda harus mengaktifkan API di project Google Cloud aplikasi. Dengan demikian, Anda dapat membuat kredensial OAuth agar pengguna aplikasi dapat mengotorisasinya.
Agar aplikasi pihak ketiga dapat mengelola konten atau deployment project skrip Anda, Anda harus memberikan akses ke project skrip Anda.
Menggunakan Apps Script API di aplikasi Anda
Untuk menggunakan Apps Script API di dalam aplikasi, Anda harus mengaktifkan Apps Script API di project Google Cloud aplikasi Anda. Setelah mengaktifkan Apps Script API, Anda dapat membuat kredensial OAuth dan mendownload client ID serta rahasia untuk disertakan dalam aplikasi Anda. Anda juga dapat memantau penggunaan API di Konsol Google Cloud.
Anda dapat menggunakan wizard pengaktifan API untuk membuat atau memilih project Google Cloud di Konsol Google Cloud dan mengaktifkan API secara otomatis. Atau, Anda dapat membuka halaman Manage Resources di konsol, memilih project, lalu mencari dan menambahkan Apps Script API secara manual menggunakan dasbor APIs & services project. Setelah mengaktifkan API, Anda dapat membuat kredensial OAuth, ID klien, dan rahasia klien untuk aplikasi Anda di panel APIs & services > Credentials.
Panduan memulai API Apps Script memberikan gambaran langkah demi langkah tentang seluruh proses pengaktifan API dan penyiapan otorisasi untuk aplikasi.
Memberi aplikasi pihak ketiga akses ke project skrip Anda
Apps Script API dapat mengizinkan aplikasi membuat dan mengubah skrip Anda serta penerapannya. Hal ini dapat menyebabkan situasi yang buruk jika Anda mengizinkan aplikasi pihak ketiga yang berbahaya yang kemudian membuat lebih banyak skrip berbahaya atau mengubah perilaku skrip yang sudah Anda miliki.
Untuk membantu mengurangi risiko ini, Apps Script API tidak dapat mengakses project skrip Anda secara default. Anda harus memberikan akses API secara eksplisit sebelum dapat menggunakan aplikasi apa pun yang membuat atau mengubah skrip atau deployment. Setelah Anda memberikan akses API ke skrip, aplikasi yang Anda beri otorisasi dapat menggunakan API untuk mengelola project skrip Anda.
Error akan terjadi jika Anda mencoba menjalankan aplikasi yang terpengaruh tanpa memberikan akses API terlebih dahulu. Error ini terjadi setelah Anda mengizinkan aplikasi.
Anda dapat memberikan akses Apps Script API ke project skrip menggunakan dasbor Apps Script. Anda juga dapat menggunakan dasbor untuk mencabut akses ini kapan saja. Saat memberikan akses API, Anda melakukannya untuk semua aplikasi. Namun, setiap aplikasi masih perlu diberi otorisasi.
Sebelum memberikan akses, pastikan Anda memahami risiko yang terlibat dalam mengizinkan aplikasi mengubah skrip Anda. Jangan pernah mengizinkan aplikasi yang Anda curigai berbahaya.