Mengaktifkan akses dan otorisasi skrip

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

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

Jika perlu menggunakan Apps Script API pada aplikasi, Anda harus enable API di project Google Cloud aplikasi. Hal ini memungkinkan Anda membuat kredensial OAuth sehingga pengguna aplikasi dapat memberikan otorisasinya.

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

Menggunakan Apps Script API di aplikasi

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

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

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

Memberi aplikasi pihak ketiga akses ke project skrip Anda

Apps Script API dapat memungkinkan aplikasi membuat dan mengubah skrip Anda dan deploymentnya. Hal ini dapat menyebabkan situasi buruk jika Anda mengizinkan aplikasi pihak ketiga berbahaya, yang kemudian melanjutkan membuat skrip yang lebih 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 Anda memberi API akses ke skrip Anda, aplikasi yang Anda izinkan 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 memberikan otorisasi pada aplikasi.

Anda dapat memberi Apps Script API akses 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, aplikasi individual masih harus diotorisasi.

Sebelum memberikan akses, pastikan Anda memahami bahwa ada risiko yang terkait jika Anda mengizinkan aplikasi untuk mengubah skrip. Jangan pernah izinkan aplikasi apa pun yang Anda duga berbahaya.