Mengaktifkan otorisasi dan akses skrip

Apps Script API memerlukan berbagai jenis otorisasi, bergantung pada sasaran Anda:

  • Gunakan Apps Script API di aplikasi Anda.
  • Izinkan aplikasi lain mengelola deployment atau data project skrip Anda.

Jika perlu menggunakan Apps Script API di aplikasi, Anda harus mengaktifkan API di project Cloud Platform (GCP) aplikasi. Tindakan ini memungkinkan Anda membuat kredensial OAuth agar pengguna aplikasi dapat memberinya otorisasi.

Jika ingin mengizinkan aplikasi pihak ketiga mengelola konten atau deployment project skrip, Anda harus memberikan akses ke project skrip.

Menggunakan Apps Script API di aplikasi

Jika ingin menggunakan Apps Script API di dalam aplikasi, Anda harus mengaktifkan Apps Script API dalam project GCP aplikasi Anda. Setelah mengaktifkan Apps Script API, Anda dapat membuat kredensial OAuth dan mendownload client ID dan rahasia untuk disertakan dalam aplikasi Anda. Anda juga dapat memantau penggunaan API di Google Cloud Platform Console.

Anda dapat menggunakan wizard ini untuk membuat atau memilih project GCP di konsol API dan mengaktifkan API secara otomatis. Atau, Anda dapat membuka halaman Kelola Resource di konsol, memilih project, lalu menelusuri dan menambahkan Apps Script API secara manual menggunakan dasbor API & layanan project. Setelah mengaktifkan API, Anda dapat membuat kredensial OAuth, client ID, dan rahasia klien untuk aplikasi Anda di panel API & services > Credentials.

Panduan memulai Apps Script API memberikan gambaran langkah demi langkah tentang seluruh proses pengaktifan API dan penyiapan otorisasi untuk aplikasi.

Memberikan akses ke project skrip Anda kepada aplikasi pihak ketiga

Apps Script API dapat memungkinkan aplikasi untuk membuat dan mengubah skrip Anda dan deploymentnya. Hal ini dapat menyebabkan situasi buruk jika Anda memberikan otorisasi ke aplikasi pihak ketiga berbahaya yang kemudian membuat 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 secara eksplisit memberikan akses API sebelum dapat menggunakan aplikasi apa pun yang membuat atau mengubah skrip atau deployment. Setelah memberikan akses API ke skrip, aplikasi yang Anda beri otorisasi dapat menggunakan API tersebut 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 Apps Script API akses ke project skrip menggunakan dasbor Apps Script. Anda juga dapat menggunakan dasbor untuk mencabut akses ini kapan saja. Jika Anda memberikan akses API, berarti Anda melakukannya untuk semua aplikasi. Namun, setiap aplikasi harus diberi otorisasi.

Sebelum memberikan akses, pastikan Anda memahami bahwa ada risiko yang berkaitan dengan penggunaan aplikasi yang dapat mengubah skrip Anda. Jangan pernah memberikan otorisasi pada aplikasi yang menurut Anda berbahaya.