Project Google Cloud

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 dimaksudkan untuk publikasi.

Anda dapat beralih dari project default ke project standar kapan saja, tetapi Anda tidak dapat beralih kembali untuk menggunakan project default. Sebaiknya pilih project Google Cloud yang digunakan skrip Anda di awal pengembangan. Beralih nanti dapat menyebabkan detail, seperti mengharuskan pengguna untuk memberi otorisasi ulang.

Project Google Cloud default

Saat Anda membuat project Apps Script, Apps Script akan membuat project Google 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 Google Cloud default saat Anda menyimpan project skrip.
  • Untuk beberapa skrip, Anda perlu berinteraksi dengan Google Cloud Console. Dalam hal ini, skrip Anda harus menggunakan project Google Cloud standar. Misalnya, untuk melihat log Google Cloud di Google Cloud Console, skrip Anda harus menggunakan project standar.

Melihat atau memperbarui project Google Cloud default

Sebagian besar pengguna tidak dapat menemukan, melihat, atau mengedit project default secara langsung di Google Cloud Console. Admin dan pengguna domain yang memiliki izin resourcemanager.projects.list pada folder Google Cloud induk dapat melihat dan mengonfigurasi project default.

  • Untuk pelanggan Google Workspace, project default termasuk dalam folder Organization root > system-gsuite > apps-script di Cloud Resource Hierarchy. Jangan hapus folder ini. Jika Anda melakukannya, skrip tidak dapat membuat project default dan tidak akan dijalankan dengan benar.
  • Untuk pelanggan non-Google Workspace, project default tidak digabungkan ke dalam Hierarki Resource.

Menghapus project Google Cloud default

Jika Anda adalah admin, Anda dapat menghapus project Google Cloud default seperti yang Anda lakukan pada project Google Cloud standar. Lihat Menghapus project Google Cloud Apps Script.

Jika bukan admin, Anda tidak dapat menghapus project default. Namun, Apps Script akan menghapus project default dalam skenario berikut:

  • Jika Anda menghapus project skrip atau beralih ke project standar, Apps Script akan menghapus project default yang terkait dengan skrip beserta setelan atau informasi 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 default-nya, Apps Script akan membuatnya untuk skrip tersebut.

Project Google Cloud standar

Project Google 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 dengannya. Anda hanya dapat melakukan tugas di bawah dengan project standar.

Jika Apps Script memerlukan project Google Cloud standar

Anda harus menggunakan project standar dalam situasi berikut:

Properti project Google Cloud standar

Project standar memiliki properti berikut:

  • Anda dapat mengakses semua setelan Google Cloud untuk project langsung dari Google Cloud Console. Hal ini memungkinkan Anda mengaktifkan API, menyesuaikan kredensial otorisasi, dan mengonfigurasi detail lainnya.
  • Saat Anda menghapus project skrip atau beralih untuk menggunakan project standar lainnya, project standar asli akan tetap ada dan dapat digunakan kembali.
  • Saat mengaktifkan layanan lanjutan di project skrip, Anda harus mengaktifkan API yang sesuai secara manual di project standar.
  • Beberapa project skrip dan aplikasi lain dapat menggunakan project standar yang sama. Jika Anda ingin memublikasikan project skrip ke Google Workspace Marketplace sebagai add-on, project tersebut harus memiliki project standar sendiri. Aplikasi yang dipublikasikan tidak dapat membagikan project Google Cloud ke 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 Google Cloud digunakan untuk mengidentifikasi skrip (bukan nama project skrip). Karena alasan ini, pastikan untuk menetapkan nama project Google Cloud yang sesuai.

Mengakses project Google Cloud standar

Untuk mengakses project standar yang terkait dengan project skrip Anda, lakukan hal berikut:

Editor baru

  1. Buka project Apps Script.
  2. Di sebelah kiri, klik Project Settings .
  3. Di bagian Project Google Cloud Platform (GCP), klik nomor project.

Editor lama

  1. Buka skrip di editor Apps Script.
  2. Pilih Resource > Project Cloud Platform.
  3. Pada dialog yang terbuka, klik link teratas yang merujuk ke nama project GCP.

Anda juga dapat menemukan project standar langsung di halaman Mengelola Resource Google Cloud Console.

Mengaktifkan API di project Google Cloud standar

Sering kali aplikasi Apps Script memerlukan akses ke Google API lain. Untuk melakukannya, Anda harus mengaktifkan API di project Google Cloud yang sesuai. Aktifkan API dengan melakukan hal berikut:

  1. Buka project Google Cloud.
  2. Klik Menu > API & Services.
  3. Klik Enable APIs and Services.
  4. Di kotak penelusuran, masukkan API yang ingin Anda aktifkan, lalu tekan Enter.
  5. Klik API dari hasil penelusuran, lalu klik Enable untuk mengaktifkan API untuk project Google Cloud ini.

Anda mungkin diminta untuk menyetujui Persyaratan Layanan untuk Google API atau Google Cloud. Tinjau Persyaratan Layanan dengan saksama sebelum menyetujuinya.

Bergantung pada aplikasinya, Anda mungkin juga perlu mengonfigurasi API dengan memilihnya di dasbor APIs & Services.

Menentukan ID &jumlah project Google Cloud standar

Semua project Google Cloud memiliki nama project, ID project, dan nomor project. Terkadang, Anda harus memiliki ID ini untuk mengonfigurasi layanan atau menyelesaikan tugas lainnya.

Untuk menentukan ID dan nomor project standar Anda, lakukan hal berikut:

  1. Buka project Google Cloud.
  2. Di kanan atas, klik Lainnya > Setelan project.
  3. Lihat Project name, Project ID, dan Nomor project di panel Setelan yang dihasilkan. Nomor project hanya terdiri dari digit, sedangkan ID Project adalah alfanumerik. Anda dapat mengedit Project name, yang ditampilkan kepada pengguna selama perintah otorisasi.

Melihat log &laporan error Google Cloud di Google Cloud Console

Jika menggunakan Cloud Logging atau pelaporan error untuk project skrip, Anda dapat melihat log dan laporan tersebut di Google Cloud Console dengan melakukan hal berikut:

  1. Buka project Google Cloud.
  2. Klik Menu .
  3. Scroll ke bawah ke bagian Operations, lalu klik Logging > Logs explorer.
  4. Untuk melihat laporan error, scroll ke bawah ke bagian Operations, lalu klik Error Reporting. Jika Anda diminta untuk menyiapkan pelaporan error, artinya project skrip Anda belum mencatat pengecualian apa pun.

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 Google Cloud default akan membuat layar izin secara otomatis dari detail project Apps Script; Anda tidak dapat menyesuaikan setelan tersebut. Project Google Cloud standar memungkinkan Anda menyesuaikan informasi ini. Anda dapat mengonfigurasi layar izin skrip dengan melakukan hal berikut:

  1. Buka project Google Cloud.
  2. Klik Menu > API & Services > Credentials.
  3. Klik Konfigurasikan layar izin.
  4. Isi setiap bagian alur kerja layar izin.
  5. Untuk merekam perubahan di setiap tahap alur kerja, klik Save and continue.

Buat 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 untuk project skrip Anda, lakukan hal berikut:

  1. Buka project Google Cloud.
  2. Klik Menu > API & Services > Credentials.
  3. Klik Create credentials > OAuth client ID.
  4. Di bagian Application type, pilih jenis aplikasi Anda dan isi formulir yang dihasilkan jika perlu. Setelah selesai, klik Buat.
  5. Pada dialog yang muncul, klik Download JSON. Anda dapat menggunakan file ini untuk mengonfigurasi OAuth.

Menambahkan pemilik lain ke project Google 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 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 dari perubahan ini:

  1. Tentukan siapa yang seharusnya menjadi kolaborator Anda. Sebaiknya buat atau gunakan Google Grup yang ada. Anda juga dapat menentukan domain di daftar kolaborator untuk menyertakan semua pengguna di domain tersebut.
  2. Buka project Google Cloud untuk skrip.
  3. Klik Menu > IAM & admin > IAM.
  4. Di bagian atas, klik Tambahkan.
  5. Ikuti petunjuk di layar untuk menambahkan satu atau beberapa anggota baru dan perannya ke project Google Cloud. Anda dapat menambahkan email, Google Grup, atau domain individual sebagai anggota baru.
  6. Klik Simpan.

Mengelompokkan beberapa skrip dengan satu project Google Cloud

Anda dapat memiliki beberapa project Apps Script yang berbagi project Google Cloud standar yang sama. Untuk melakukannya, buat project standar, lalu alihkan setiap project skrip untuk menggunakannya. Anda tidak dapat melakukannya dengan project default.

Beralih ke project Google Cloud standar yang berbeda

Anda dapat mengganti project skrip sehingga menggunakan project Google Cloud standar yang berbeda. Anda harus beralih ke project standar jika skrip Anda memerlukan konfigurasi manual project Google Cloud. Untuk mempelajari lebih lanjut kapan Anda perlu menggunakan project standar, lihat project Google Cloud standar.

Untuk mengalihkan project Google Cloud skrip yang ada ke project Google Cloud lain, ikuti langkah-langkah berikut:

Editor baru

  1. Jika Anda tidak memiliki project Google Cloud yang sesuai, buat project dengan mengikuti petunjuk Membuat project. Tetapkan nama project yang mudah diingat sehingga Anda dapat menemukannya di halaman Kelola Resource Google Cloud Console. Apps Script menggunakan nama ini saat meminta pengguna untuk mengizinkan skrip.
  2. Jika ingin menggunakan project yang sudah ada, buka halaman Kelola Resource Google Cloud dan temukan project yang ada untuk digunakan. Anda harus memiliki izin resourcemanager.projects.update untuk project tersebut. Anda tidak dapat menggunakan project yang otomatis dibuat oleh Apps Script.
  3. Tentukan Nomor project dari project Google Cloud Anda.
  4. Buka skrip yang project Google Cloud-nya ingin Anda ganti.
  5. Di sebelah kiri, klik Project Settings .
  6. Di bagian Project Google Cloud Platform (GCP), klik Change project.
  7. Masukkan nomor project baru dan klik Set project.

Editor lama

  1. Jika Anda tidak memiliki project GCP yang sesuai, buat project baru dengan mengikuti petunjuk Membuat project. Jika tidak, buka halaman Kelola Resource Google Cloud Console dan cari project GCP yang sudah ada untuk digunakan. Anda harus memiliki izin edit untuk project GCP dan Anda harus dapat melihat setelannya di Google Cloud Console. Project baru tidak boleh berupa project yang otomatis dibuat oleh Apps Script.
  2. Tetapkan nama project GCP yang mudah diingat sehingga Anda dapat menemukannya dengan lebih mudah di halaman Mengelola Resource Google Cloud Console. Nama ini juga digunakan untuk mengidentifikasi skrip saat Apps Script meminta pengguna untuk memberikan otorisasi pada skrip.
  3. Tentukan Nomor project dari project GCP Anda.
  4. Di editor Apps Script, buka skrip yang project GCP-nya ingin Anda ganti.
  5. Klik Resource > Project Cloud Platform.
  6. Di bagian Change Project, tempel nomor project yang Anda salin ke kolom teks, lalu klik Set Project.
  7. Layar peringatan menjelaskan efek perubahan project Cloud Platform. Baca pemberitahuan dengan saksama, lalu klik Konfirmasi.

Project Google Cloud &drive bersama

Drive bersama (sebelumnya Drive Tim) menyediakan ruang bersama tempat grup pengguna Drive dapat berkolaborasi pada project Apps Script dan dokumen Drive. Drive bersama sangat berharga saat mengembangkan skrip, add-on, dan aplikasi web dengan tim, tetapi menetapkan beberapa batasan terkait hal yang dapat Anda lakukan dengan project Google Cloud default lama.

Daftar pembatasan berikut menjelaskan cara project Google Cloud berinteraksi dengan drive bersama:

  • Jika project skrip Anda menggunakan project standar, tidak ada batasan 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 batasan 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:
    1. Anda tidak dapat mengakses project default menggunakan UI Apps Script atau Google Cloud Console. Pembatasan ini mencegah Anda melakukan tindakan yang memerlukan akses langsung ke project.
    2. Anda tidak dapat mengaktifkan layanan lanjutan. Untuk mengaktifkan layanan lanjutan, beralihlah ke project standar.
    3. Saat Anda memindahkan project Apps Script yang ada ke drive bersama, Google akan membatasi akses ke project Google Cloud default. Anda masih dapat mengakses project default jika memiliki akses sebelum pemindahan. Misalnya, jika Anda membuat skrip di folder Drive Saya, lalu memindahkannya ke drive bersama, Anda masih dapat mengakses project Google Cloud skrip. Kolaborator Anda di drive bersama mungkin tidak dapat melakukannya.
    4. Skrip menyimpan nama project Google Cloud yang dimilikinya sebelum dipindahkan ke drive bersama. Meskipun Anda mengubah nama project di drive bersama, pengguna yang memberi otorisasi pada skrip tetap melihat nama lama pada dialog otorisasi.

Untuk menghindari pembatasan di atas untuk skrip lama, beralih ke project standar.

Mendapatkan daftar project Google Cloud Apps Script

Jika memiliki izin resourcemanager.projects.list untuk folder Project Apps Script organisasi, Anda dapat melihat semua project Google Cloud Apps Script standar dan default dalam folder tersebut.

  1. Buka halaman Mengelola Resource Google Cloud Console.
  2. Di samping folder Apps Script, salin ID-nya.
  3. Klik Filter > Parent ID dan tempelkan ID folder Apps Script.

Menghapus project Google Cloud Apps Script

Untuk menghapus project Google Cloud Apps Script, ikuti langkah-langkah di bagian Mendapatkan daftar project Google Cloud Apps Script, pilih project yang ingin Anda hapus, 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 mengetahui informasi selengkapnya tentang cara menghapus project Google Cloud, lihat Mematikan (menghapus) project.