Setiap project Apps Script menggunakan Google Cloud untuk mengelola otorisasi, layanan lanjutan, dan detail lainnya. Untuk mengonfigurasi dan mengelola setelan ini, setiap project Apps Script memiliki project Google Cloud terkait. Project skrip Anda dapat menggunakan project default yang dibuat otomatis oleh Apps Script, atau project standar yang Anda buat sendiri. Secara umum, project default cocok untuk skrip sehari-hari atau sederhana, tetapi Anda harus menggunakan project standar untuk aplikasi apa pun yang kompleks, berkualitas komersial, atau yang ingin Anda publikasikan.
Anda dapat beralih dari project default ke project standar kapan saja, tetapi tidak dapat beralih kembali untuk menggunakan project default. Sebaiknya pilih project Cloud yang akan digunakan skrip Anda di awal pengembangan. Pengalihan di lain waktu dapat menyebabkan masalah, seperti mengharuskan pengguna untuk memberikan otorisasi ulang.
Project Cloud default
Saat Anda membuat project Apps Script, Apps Script akan membuat project Cloud default yang beroperasi di latar belakang.
- Untuk sebagian besar skrip, Anda tidak perlu melihat atau menyesuaikan project default ini. Apps Script menangani interaksi yang diperlukan dengan Google Cloud. Misalnya, jika Anda mengaktifkan layanan lanjutan di editor Apps Script, Apps Script akan mengaktifkan layanan lanjutan di project Cloud default saat Anda menyimpan project skrip.
- Untuk beberapa skrip, Anda perlu berinteraksi dengan konsol Google Cloud. Dalam hal ini, skrip Anda harus menggunakan project Cloud standar. Misalnya, untuk melihat log Google Cloud di konsol Google Cloud, skrip Anda harus menggunakan project standar.
Secara default, project Cloud memiliki kebijakan Identity and Access Management (IAM) dengan satu entri, yaitu akun layanan Google yang bertindak sebagai pemilik project default. Akun layanan Google adalah
appsdev-apps-dev-script-auth@system.gserviceaccount.com
.
Melihat atau memperbarui project Cloud default
Sebagian besar pengguna tidak dapat langsung menemukan, melihat, atau mengedit project default di konsol Google Cloud. Jika Anda adalah Admin, lihat Melihat project Google Cloud default.
Jika Anda membuat project skrip sebelum 8 April 2019, Anda dapat menggunakan project default yang dapat diakses di konsol Google Cloud. Untuk mengakses project default, buka setelan project skrip, lalu klik nomor project.
Hapus project Cloud default
Jika Anda adalah admin, Anda dapat menghapus project Cloud default seperti pada project Cloud standar. Lihat Menghapus project Cloud Apps Script.
Jika Anda bukan admin, Anda tidak dapat menghapus project default. Namun, Apps Script menghapus project default dalam skenario berikut:
- Jika Anda menghapus project skrip atau mengalihkannya untuk menggunakan project standar, Apps Script akan menghapus project default yang dilampirkan ke skrip beserta setelan atau informasi apa pun yang ada di dalamnya.
- Jika skrip tidak berjalan selama 180 hari atau lebih, Apps Script akan menghapus project default terkaitnya. Jika skrip berjalan setelah Apps Script menghapus project defaultnya, Apps Script akan membuatkannya untuk skrip tersebut.
Project Cloud standar
Project Cloud default adalah opsi terbaik untuk sebagian besar project skrip, kecuali jika Anda perlu mengonfigurasi project secara manual. Dalam situasi ini, Anda harus mengalihkan project skrip untuk menggunakan project standar.
Bagian berikut menjelaskan kapan Apps Script memerlukan project standar, properti project tersebut, dan tugas umum yang dilakukan dengan project tersebut. Anda hanya dapat melakukan tugas-tugas di bawah ini dengan project standar.
Saat Apps Script memerlukan project Cloud standar
Anda harus menggunakan project standar dalam situasi berikut:
- Untuk memublikasikan project skrip Anda sebagai add-on di Google Workspace Marketplace.
- Untuk memverifikasi klien OAuth project skrip Anda.
- Jika Anda memiliki aplikasi yang perlu menjalankan fungsi dalam
project skrip Anda menggunakan
metode
scripts.run
Apps Script API. - Untuk melihat log Google Cloud project skrip Anda di Konsol Google Cloud. Konsol Google Cloud menyediakan lebih banyak alat untuk memfilter dan melihat log, serta dapat lebih membantu daripada tampilan sederhana yang disediakan oleh dasbor Apps Script.
- Untuk melihat laporan error project skrip Anda menggunakan Error Reporting.
- Untuk membuat dialog membuka file.
- Jika Anda tidak memerlukan kontrol manual atas setelan Google Cloud project.
Properti project Cloud standar
Project standar memiliki properti berikut:
- Anda dapat mengakses semua setelan Google Cloud untuk project langsung dari konsol Google Cloud. Hal ini memungkinkan Anda mengaktifkan API, menyesuaikan kredensial otorisasi, dan mengonfigurasi detail lainnya.
- Saat Anda menghapus project skrip atau mengalihkannya untuk menggunakan project standar lainnya, project standar asli akan tetap ada dan dapat digunakan kembali.
- Saat mengaktifkan layanan lanjutan dalam project skrip, Anda harus mengaktifkan API yang sesuai secara manual dalam project standar.
- Beberapa project skrip dan aplikasi lainnya dapat berbagi project standar yang sama. Jika Anda ingin memublikasikan project skrip ke Google Workspace Marketplace sebagai add-on, project tersebut harus memiliki project standarnya sendiri. Aplikasi yang dipublikasikan tidak dapat berbagi project Cloud dengan aplikasi lain.
- Jika Anda ingin menjalankan fungsi dalam project skrip dari aplikasi lain menggunakan metode
scripts.run
Apps Script API, project skrip dan aplikasi panggilan harus memiliki project standar yang sama. - Saat Apps Script meminta pengguna untuk mengizinkan skrip yang menggunakan project standar, nama project Cloud digunakan untuk mengidentifikasi skrip (bukan nama project skrip). Karena alasan ini, pastikan untuk menetapkan nama project Cloud yang sesuai.
Mengakses project Cloud standar
Untuk mengakses project standar yang terkait dengan project skrip Anda, lakukan hal berikut:
- Buka project Apps Script.
- Di sebelah kiri, klik Project Settings .
- Pada Google Cloud Platform (GCP) Project, klik nomor project.
Anda juga dapat menemukan project standar langsung di halaman Kelola Resource di Konsol Google Cloud.
Mengaktifkan API di project Cloud standar
Sering kali aplikasi Apps Script memerlukan akses ke Google API lain. Untuk melakukannya, Anda harus mengaktifkan API di project Cloud yang sesuai. Aktifkan API dengan melakukan hal berikut:
- Buka project Cloud.
- Klik Menu > API & Layanan.
- Klik Aktifkan API dan Layanan.
- Di kotak penelusuran, masukkan API yang ingin Anda aktifkan, lalu tekan Enter.
- Klik API dari hasil penelusuran, lalu klik Enable guna mengaktifkan API untuk project Cloud ini.
Anda mungkin diminta untuk menyetujui Persyaratan Layanan untuk Google API atau Google Cloud. Tinjau Persyaratan Layanan dengan cermat sebelum menyetujuinya.
Bergantung pada aplikasinya, Anda mungkin juga perlu mengonfigurasi API dengan memilihnya pada dasbor APIs & Services.
Menentukan ID & nomor project Cloud standar
Semua project Cloud memiliki nama project, ID project, dan nomor project. Terkadang, Anda harus memiliki ID ini untuk mengonfigurasi layanan atau menyelesaikan tugas lain.
Untuk menentukan ID dan nomor project standar, lakukan hal berikut:
- Buka project Cloud.
- Di kanan atas, klik More > Project settings.
- Lihat Project name, Project ID, dan Project number di panel Settings yang dihasilkan. Project number hanya terdiri dari angka, sedangkan Project ID berupa alfanumerik. Anda dapat mengedit Project name, yang akan ditampilkan kepada pengguna selama permintaan otorisasi.
Melihat log & laporan error Google Cloud di Konsol Google Cloud
Jika menggunakan Google Cloud logging atau pelaporan error untuk project skrip, Anda dapat melihat log dan laporan tersebut di Konsol Google Cloud dengan melakukan hal berikut:
- Buka project Cloud.
- Klik Menu .
- Scroll ke bawah ke bagian Operations, lalu klik Logging > Logs explorer.
- Untuk melihat laporan error, scroll ke bawah ke bagian Operasi, lalu klik Error Reporting. Jika Anda diminta untuk menyiapkan pelaporan error, ini berarti project skrip Anda belum mencatat pengecualian apa pun ke dalam log.
Lengkapi layar izin OAuth
Saat menggunakan layanan yang memerlukan OAuth, Google akan meminta pengguna untuk mengizinkan layanan tersebut. Setelan layar izin OAuth memungkinkan Anda menetapkan beberapa informasi yang ditampilkan Google kepada pengguna, seperti nama aplikasi dan URL Persyaratan Layanan.
Project Cloud default membuat layar izin secara otomatis dari detail project Apps Script; Anda tidak dapat menyesuaikan setelan tersebut. Project Cloud standar memungkinkan Anda menyesuaikan informasi ini. Anda dapat mengonfigurasi layar izin skrip dengan melakukan hal berikut:
- Buka project Cloud.
- Klik Menu > API & Services > Credentials.
- Klik Konfigurasi layar izin.
- Isi setiap bagian alur kerja layar izin.
- Untuk mencatat perubahan di setiap tahap alur kerja, klik Simpan dan lanjutkan.
Membuat kredensial OAuth
Apps Script biasanya menyiapkan OAuth untuk layanan yang digunakan skrip Anda. Untuk beberapa aplikasi, Anda harus membuat kredensial OAuth tambahan (client ID dan rahasia klien). Anda hanya dapat melakukan ini dengan project standar.
Untuk membuat client ID dan rahasia klien bagi project skrip Anda, lakukan hal berikut:
- Buka project Cloud.
- Klik Menu > API & Services > Credentials.
- Klik Create credentials > OAuth client ID.
- Di bagian Jenis aplikasi, pilih jenis aplikasi Anda dan isi formulir yang dihasilkan jika diperlukan. Setelah selesai, klik Buat.
- Pada dialog yang muncul, klik Download JSON. Anda dapat menggunakan file ini untuk mengonfigurasi OAuth.
Menambahkan pemilik tambahan ke project Cloud standar
Anda dapat menambahkan pemilik atau peran lain ke project standar. Jika Anda berkolaborasi dalam suatu project, hal ini membantu memastikan bahwa seseorang di tim Anda selalu memiliki akses ke setelan Google Cloud untuk project skrip.
Anda dapat menambahkan pemilik atau peran lain ke project standar dengan melakukan hal berikut. Anda harus memiliki izin edit untuk project agar dapat melakukan salah satu perubahan ini:
- Tentukan siapa kolaborator Anda. Sebaiknya Anda membuat atau menggunakan Google Grup yang sudah ada. Anda juga dapat menentukan domain dalam daftar kolaborator untuk menyertakan semua pengguna dalam domain tersebut.
- Buka project Cloud skrip.
- Klik Menu > IAM & admin > IAM.
- Di bagian atas, klik Tambahkan.
- Ikuti petunjuk di layar untuk menambahkan satu atau beberapa anggota baru beserta perannya ke project Cloud. Anda dapat menambahkan email individual, Google Grup, atau domain sebagai anggota baru.
- Klik Simpan.
Kelompokkan beberapa skrip dengan satu project Cloud
Anda dapat memiliki beberapa project Apps Script yang menggunakan project Cloud standar yang sama. Untuk melakukannya, buat project standar, lalu ganti setiap project skrip untuk menggunakannya. Anda tidak dapat melakukannya dengan project default.
Gunakan project Cloud standar yang berbeda
Anda dapat mengalihkan project skrip agar menggunakan project Cloud standar yang berbeda. Jika skrip Anda memerlukan konfigurasi manual project Cloud, Anda harus beralih dari project default ke project standar. Untuk mempelajari lebih lanjut kapan Anda perlu menggunakan project standar, lihat project Cloud standar.
Efek dari beralih ke project Cloud standar yang berbeda
Jika Anda mengalihkan skrip dari project default atau ke project standar yang berbeda, hal tersebut akan memiliki efek berikut:
- Jika mengaktifkan layanan lanjutan untuk skrip, Anda harus mengaktifkan API yang sesuai di project Cloud baru. Anda akan kehilangan data apa pun yang terkait dengan layanan lanjutan di project Cloud sebelumnya. Untuk mempelajari cara mengaktifkan API di project Cloud, lihat artikel Mengaktifkan Google Workspace API.
- Jika skrip Anda menggunakan layanan Google Drive bawaan, Anda harus mengaktifkan
Drive API dalam project Cloud standar.
Di project Cloud standar, aktifkan Drive API:
- Semua pengguna yang sebelumnya telah memberikan otorisasi pada skrip harus melakukan otorisasi ulang. Pada sebagian besar kasus, semua pengguna yang sebelumnya telah memberi otorisasi ke aplikasi yang terkait dengan project baru juga harus melakukan otorisasi ulang.
- Jika skrip Anda dikaitkan dengan listingan aplikasi di Google Workspace Marketplace, listingan aplikasi, pengguna, dan ulasan Anda tidak akan ikut disertakan ke project baru. Anda harus membuat listingan aplikasi dalam project baru dan pengguna harus menginstal ulang aplikasi Anda. Untuk mengetahui informasi tentang cara membuat listingan aplikasi baru, baca Memublikasikan aplikasi.
- Anda tidak dapat mengalihkan skrip kembali ke project default. Apps Script menghapus project default setelah Anda menetapkan skrip untuk menggunakan project standar.
Beralih ke project Cloud standar yang berbeda
Untuk mengalihkan project Cloud yang ada milik skrip ke project Cloud lainnya, ikuti langkah-langkah berikut:
- Jika Anda tidak memiliki project Cloud yang sesuai, buat dengan mengikuti petunjuk Membuat project. Tetapkan nama project yang mudah diingat sehingga Anda dapat menemukannya di halaman Kelola Resource di Konsol Google Cloud. Apps Script menggunakan nama ini saat meminta pengguna untuk mengizinkan skrip.
- Jika Anda ingin menggunakan project yang sudah ada, buka halaman Manage Resources di konsol Google Cloud dan cari project yang ada untuk digunakan. Anda harus memiliki peran Project Browser dan OAuth Config Editor, atau peran dengan izin yang setara, untuk project tersebut. Anda tidak dapat menggunakan project yang dibuat otomatis oleh Apps Script.
- Tentukan Project number untuk project Cloud Anda.
- Buka skrip yang project Cloud-nya ingin Anda ganti.
- Di sebelah kiri, klik Project Settings .
- Pada Google Cloud Platform (GCP) Project, klik Change project.
- Masukkan nomor project baru, lalu klik Set project.
Project cloud & drive bersama
Drive bersama (sebelumnya Drive Tim) menyediakan ruang bersama tempat grup pengguna Drive dapat berkolaborasi di project Apps Script dan dokumen Drive. Drive bersama bermanfaat saat mengembangkan skrip, add-on, dan aplikasi web dengan tim, tetapi drive bersama menerapkan beberapa batasan terkait apa yang dapat Anda lakukan dengan project Cloud default yang lebih lama.
Daftar batasan berikut menjelaskan cara project Cloud berinteraksi dengan drive bersama:
- Jika project skrip Anda menggunakan project standar, tidak ada pembatasan tambahan saat project skrip berada di drive bersama.
- Jika project skrip Anda menggunakan project default yang dibuat pada atau setelah 8 April 2019, tidak ada pembatasan tambahan saat project skrip berada di drive bersama.
- Jika project skrip Anda menggunakan project default yang dibuat sebelum 8 April 2019, pembatasan berikut akan berlaku saat project skrip berada di drive bersama:
- Anda tidak dapat mengakses project default menggunakan UI Apps Script atau Konsol Google Cloud. Pembatasan ini mencegah Anda mengambil tindakan yang memerlukan akses langsung ke project.
- Anda tidak dapat mengaktifkan layanan lanjutan. Untuk mengaktifkan layanan lanjutan, beralihlah ke project standar.
- Saat Anda memindahkan project Apps Script yang ada ke drive bersama, Google akan membatasi akses ke project Cloud default. Anda masih dapat mengakses project default jika memiliki akses sebelum melakukan pemindahan. Misalnya, jika Anda membuat skrip di folder Drive Saya lalu memindahkannya ke drive bersama, Anda masih dapat mengakses project Cloud skrip tersebut. Kolaborator Anda di drive bersama mungkin tidak dapat melakukannya.
- Skrip akan mempertahankan nama project Cloud yang dimilikinya sebelum dipindahkan ke drive bersama. Meskipun Anda mengubah nama project di drive bersama, pengguna yang memberikan otorisasi skrip masih akan melihat nama lama di dialog otorisasi.
Agar terhindar dari pembatasan di atas untuk skrip lama, beralihlah ke project standar.
Mendapatkan daftar project Cloud Apps Script
Jika memiliki izin resourcemanager.projects.list
untuk folder project Apps Script organisasi, Anda dapat melihat semua project Cloud Apps Script Cloud standar dan default dalam folder tersebut.
- Buka halaman Kelola Resource di Konsol Google Cloud.
- Di samping folder Apps Script, salin ID.
- Klik Filter > Parent ID dan tempelkan ID folder Apps Script.
Menghapus project Cloud Apps Script
Untuk menghapus project Cloud Apps Script, ikuti langkah-langkah di bagian Dapatkan daftar project Cloud Apps Script, pilih project yang ingin dihapus, lalu klik Hapus.
Untuk menghapus project Apps Script menggunakan gcloud
, gunakan perintah
berikut.
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
Untuk informasi selengkapnya tentang cara menghapus project Cloud, lihat artikel Menutup (menghapus) project.