Project Google Cloud

Setiap project Google 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 secara otomatis oleh Apps Script, atau project standar yang Anda buat sendiri. Secara umum, project default cocok untuk skrip sehari-hari, tetapi Anda harus menggunakan project standar untuk aplikasi yang kompleks, berkualitas komersial, atau yang ingin Anda publikasikan.

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

Project Cloud default

Saat Anda membuat project Apps Script, project tersebut 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 kasus 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 dan klik nomor project.

Menghapus project Cloud default

Jika Anda adalah administrator, Anda dapat menghapus project Cloud default seperti project Cloud standar. Lihat Melihat atau mengedit project Cloud default.

Pengguna non-administrator tidak dapat menghapus project default secara manual. Namun, jika Anda menghapus project skrip atau beralih ke project standar, Apps Script akan menghapus project default yang terlampir pada skrip beserta setelan dan informasinya.

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, propertinya, dan tugas umum. Lakukan tugas ini hanya dengan project standar.

Saat Apps Script memerlukan project Cloud standar

Anda harus menggunakan project standar dalam situasi berikut:

Properti project Cloud standar

Project standar memiliki properti berikut:

  • Akses semua setelan Google Cloud untuk project langsung dari konsol Google Cloud. Dengan demikian, Anda dapat mengaktifkan API, menyesuaikan kredensial otorisasi, dan mengonfigurasi detail lainnya.
  • Saat Anda menghapus project skrip atau mengalihkannya untuk menggunakan project standar lain, project standar asli tetap ada dan dapat digunakan kembali.
  • Saat mengaktifkan layanan lanjutan dalam project skrip, Anda harus mengaktifkan API yang sesuai secara manual di project standar.
  • Beberapa project skrip dan aplikasi lain dapat berbagi project standar yang sama. Jika Anda ingin memublikasikan project skrip ke Marketplace sebagai add-on, project tersebut harus memiliki project standarnya sendiri. Aplikasi yang dipublikasikan tidak dapat membagikan 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 menggunakan project standar yang sama.
  • Saat Apps Script meminta pengguna untuk mengizinkan skrip yang menggunakan project standar, nama project Cloud akan digunakan untuk mengidentifikasi skrip (bukan nama project skrip). Oleh karena itu, pastikan untuk menetapkan nama project Cloud yang sesuai.

Mengakses project Cloud standar

Untuk mengakses project standar yang terkait dengan project skrip Anda:

  1. Buka project Apps Script.
  2. Di sebelah kiri, klik Setelan Project .
  3. Di bagian Project Google Cloud, klik nomor project.

Temukan project standar langsung di halaman Kelola Resource Konsol Google Cloud.

Mengaktifkan API di project Cloud standar

Untuk memberikan akses aplikasi Apps Script ke Google API lain, aktifkan API di project Cloud yang sesuai:

  1. Buka project Cloud.
  2. Klik Menu > APIs & Services.
  3. Klik Aktifkan API dan Layanan.
  4. Di kotak penelusuran, masukkan API yang ingin Anda aktifkan, lalu tekan Enter.
  5. Klik API dari hasil penelusuran, lalu klik Aktifkan.

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

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

Menentukan ID & nomor project Cloud standar

Semua project Cloud memiliki nama, ID, dan nomor. Anda mungkin memerlukan ID ini untuk mengonfigurasi layanan atau menyelesaikan tugas lainnya.

Untuk mengetahui ID dan nomor project standar Anda:

  1. Buka project Cloud.
  2. Di kanan atas, klik Lainnya > Project settings.
  3. Lihat Nama project, Project ID, dan Nomor project di panel Setelan yang dihasilkan. Nomor project terdiri dari digit, sedangkan Project ID berupa alfanumerik. Edit Nama project, yang ditampilkan kepada pengguna selama dialog otorisasi.

Melihat log & laporan error Google Cloud di konsol Google Cloud

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

  1. Buka project Cloud.
  2. Klik Menu .
  3. Di bagian Operations, klik Logging > Logs explorer.
  4. Untuk melihat laporan error, di bagian Operasi, klik Pelaporan Error. Jika Anda diminta untuk menyiapkan pelaporan error, berarti 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 menentukan 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. Untuk mengonfigurasi layar izin skrip Anda:

  1. Buka project Cloud.
  2. Klik Menu > API & Layanan > Kredensial.
  3. Klik Konfigurasi layar izin.
  4. Isi setiap bagian alur kerja layar izin.
  5. Untuk mencatat perubahan Anda di setiap tahap, klik Simpan dan lanjutkan.

Membuat kredensial OAuth

Apps Script biasanya menyiapkan OAuth untuk layanan yang digunakan skrip Anda. Untuk beberapa aplikasi, buat kredensial OAuth tambahan (client ID dan rahasia klien). Lakukan ini hanya dengan project standar.

Untuk membuat client ID dan rahasia klien untuk project skrip Anda:

  1. Buka project Cloud.
  2. Klik Menu > API & Layanan > Kredensial.
  3. Klik Buat kredensial > Client ID OAuth.
  4. Di bagian Jenis aplikasi, pilih jenis aplikasi Anda dan isi formulir. Setelah selesai, klik Buat.
  5. Dalam dialog, klik Download JSON. Gunakan file ini untuk mengonfigurasi OAuth.

Menambahkan pemilik tambahan ke project Cloud standar

Tambahkan pemilik tambahan atau peran lain ke project standar untuk memastikan bahwa seseorang di tim Anda selalu memiliki akses ke setelan Google Cloud project skrip.

Untuk menambahkan pemilik tambahan atau peran lain ke project standar (memerlukan izin edit):

  1. Tentukan kolaborator Anda. Sebaiknya gunakan Grup Google. Tentukan domain untuk menyertakan semua pengguna di domain tersebut.
  2. Buka project Cloud skrip.
  3. Klik Menu > IAM & admin > IAM.
  4. Di bagian atas, klik Tambahkan.
  5. Ikuti petunjuk di layar untuk menambahkan anggota baru dan perannya. Tambahkan email individu, Grup Google, atau domain.
  6. Klik Simpan.

Mengelompokkan beberapa skrip dengan satu project Cloud

Beberapa project Apps Script dapat berbagi project Cloud standar yang sama. Untuk melakukannya, buat project standar, lalu alih setiap project skrip untuk menggunakannya. Anda tidak dapat melakukannya dengan project default.

Jika Anda ingin memublikasikan project skrip di Marketplace sebagai add-on, project tersebut harus memiliki project standarnya sendiri—aplikasi yang dipublikasikan tidak dapat berbagi project Cloud.

Menggunakan project Cloud standar yang berbeda

Mengalihkan project skrip untuk menggunakan project Cloud standar yang berbeda. Jika skrip Anda memerlukan konfigurasi manual project Cloud, beralihlah dari project default ke project standar. Untuk mempelajari lebih lanjut, lihat project Cloud standar.

Efek beralih ke project Cloud standar lain

Jika Anda mengalihkan skrip dari project default atau ke project standar lain, hal ini akan berdampak sebagai berikut:

  • Jika mengaktifkan layanan lanjutan untuk skrip, Anda harus mengaktifkan API yang sesuai di project Cloud baru. Anda akan kehilangan semua data yang terkait dengan layanan lanjutan di project Cloud sebelumnya. Untuk mempelajari cara mengaktifkan API di project Cloud Anda, lihat Mengaktifkan Google Workspace API.
  • Jika skrip Anda menggunakan layanan Google Drive bawaan, Anda harus mengaktifkan Drive API di project Cloud standar.

    Di project Cloud standar Anda, aktifkan Drive API:

    Aktifkan Drive API

  • Semua pengguna yang sebelumnya telah mengizinkan skrip harus memberikan otorisasi ulang. Dalam sebagian besar kasus, semua pengguna yang sebelumnya telah memberi otorisasi aplikasi yang terkait dengan project baru juga harus memberi otorisasi ulang.
  • Jika skrip Anda dikaitkan dengan listingan aplikasi di Google Workspace Marketplace, listingan aplikasi, pengguna, dan ulasan Anda tidak akan ditransfer 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, lihat Memublikasikan aplikasi.
  • Anda tidak dapat mengalihkan skrip kembali ke project default. Apps Script menghapus project default setelah Anda menyetel skrip untuk menggunakan project standar.

Beralih ke project Cloud standar lain

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

  1. Jika Anda tidak memiliki project Cloud yang sesuai, buat project dengan mengikuti petunjuk Membuat project. Tetapkan nama project yang mudah diingat untuk menemukannya di halaman Manage Resources Konsol Google Cloud. Apps Script menggunakan nama ini saat meminta pengguna untuk mengizinkan skrip.
  2. Jika Anda ingin menggunakan project yang ada, buka halaman Google Cloud console Manage Resources dan temukan 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 secara otomatis oleh Apps Script.
  3. Tentukan Nomor project project Cloud Anda.
  4. Buka skrip yang project Cloud-nya ingin Anda ganti.
  5. Di sebelah kiri, klik Project Settings .
  6. Di bagian Project Google Cloud, klik Ubah project.
  7. Masukkan nomor project baru, lalu klik Set project.

Project cloud & drive bersama

Drive bersama hanya tersedia untuk pelanggan Google Workspace Business dan Google Workspace Enterprise.

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

Daftar berikut menjelaskan cara project 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, batasan berikut berlaku saat project skrip berada di drive bersama:
    1. Anda tidak dapat mengakses project default menggunakan UI Apps Script atau Konsol Google Cloud. 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 sudah ada ke drive bersama, Google akan membatasi akses ke project Cloud default. Anda tetap dapat mengakses project default jika Anda memiliki akses sebelum pemindahan. Misalnya, jika Anda membuat skrip di folder Drive Saya, lalu memindahkannya ke drive bersama, Anda tetap dapat mengakses project Cloud skrip tersebut. Kolaborator Anda di drive bersama mungkin tidak dapat melakukannya.
    4. Skrip mempertahankan nama project Cloud yang dimilikinya sebelum dipindahkan ke drive bersama. Meskipun Anda mengubah nama project di drive bersama, pengguna yang mengizinkan skrip akan tetap melihat nama lama di dialog otorisasi.

Untuk menghindari batasan ini pada skrip yang lebih lama, beralihlah ke project standar.

Mendapatkan daftar project Cloud Apps Script

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

  1. Buka halaman Manage Resources di konsol Google Cloud.
  2. Di samping folder Apps Script, salin ID.
  3. Klik Filter > ID Induk, lalu tempelkan ID folder Apps Script.

Menghapus project Cloud Apps Script

Anda harus menjadi administrator untuk menghapus project default.

Untuk menghapus project Apps Script dari konsol Google Cloud:

  1. Buka project Cloud.
  2. Di kanan atas, klik Lainnya > Project settings.
  3. Klik Shut down / delete.
  4. Ikuti petunjuk di layar untuk mematikan project.

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 Cloud, lihat Menonaktifkan (menghapus) project.