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. Proyek skrip Anda dapat menggunakan default project yang menggunakan Apps Script dibuat secara otomatis, atau project standar yang Anda buat diri Anda sendiri. Secara umum, project default bagus untuk digunakan sehari-hari atau sederhana skrip, tetapi Anda harus menggunakan proyek 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 Anda tidak dapat beralih kembali untuk menggunakan project default. Sebaiknya pilih project Cloud yang digunakan skrip Anda di awal pengembangan. Beralih di lain waktu dapat menyebabkan komplikasi, seperti mewajibkan 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. Aplikasi Skrip 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. Di yang terjadi, skrip Anda harus menggunakan project Cloud standar. Sebagai Misalnya, untuk melihat log Google Cloud di Konsol Google Cloud, skrip Anda harus menggunakan adalah project standar.

Secara default, project Cloud memiliki Identity and Access Management (IAM) dengan satu entri, yaitu akun layanan Google yang bertindak sebagai pemilik menggunakan project default. Akun layanan Google appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Melihat atau mengupdate project Cloud default

Sebagian besar pengguna tidak dapat langsung menemukan, melihat, atau mengedit project default di Konsol Google Cloud Anda. Jika Anda adalah Admin, baca Melihat project Google Cloud default.

Jika membuat project skrip sebelum 8 April 2019, Anda dapat menggunakan project default yang dapat Anda akses di Konsol Google Cloud. Untuk mengakses project default, buka setelan project skrip dan klik project angka

Hapus project Cloud default

Jika Anda adalah admin, Anda dapat menghapus project Cloud default seperti yang biasa 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 proyek skrip atau mengalihkannya untuk menggunakan proyek standar, Skrip akan menghapus project default yang dilampirkan pada skrip beserta pengaturan atau informasi yang ada di dalamnya.
  • Jika skrip tidak berjalan selama 180 hari atau lebih, Apps Script akan menghapus project default terkait. Jika skrip berjalan setelah Apps Script menghapus project default-nya, Apps Script membuat project untuk {i>script<i}.

Project Cloud Standar

Project Cloud default adalah opsi terbaik untuk sebagian besar project skrip, kecuali jika Anda perlu mengonfigurasi project secara manual. Dalam situasi tersebut, Anda harus mengalihkan project skrip Anda 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 di bawah ini dengan proyek standar.

Jika Apps Script memerlukan project Cloud standar

Anda harus menggunakan project standar dalam situasi berikut:

Properti project Cloud standar

Project standar memiliki properti berikut:

  • Anda dapat mengakses semua setelan Google Cloud untuk project secara langsung dari konsol Google Cloud. Hal ini memungkinkan Anda mengaktifkan API, menyesuaikan otorisasi kredensial, dan mengonfigurasi detail lainnya.
  • Saat Anda menghapus project skrip atau mengalihkannya ke menggunakan proyek standar lainnya, proyek standar asli akan 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 hal yang sama project standar. 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 standar yang sama proyek.
  • Saat Apps Script meminta pengguna untuk memberi otorisasi pada skrip yang menggunakan project, nama project Cloud digunakan untuk mengidentifikasi skrip (bukan nama project skrip). Karena alasan ini, pastikan untuk menetapkan Nama project cloud.

Mengakses project Cloud standar

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

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

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

Mengaktifkan API dalam 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:

  1. Buka project Cloud.
  2. Klik Menu &gt; API & Layanan.
  3. Klik Aktifkan API dan Layanan.
  4. Di kotak penelusuran, masukkan API yang ingin diaktifkan, lalu tekan Enter.
  5. Klik API dari hasil penelusuran, lalu klik Aktifkan untuk mengaktifkan API untuk project Cloud ini.

Anda mungkin diminta untuk menyetujui Persyaratan Layanan untuk API Google atau Google Cloud. Tinjau Persyaratan Google secara saksama sebelum menerimanya.

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

Menentukan ID & nomor project Cloud standar

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

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

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

Melihat log Google Cloud & laporan error di Konsol Google Cloud

Jika Anda menggunakan Google Cloud Logging atau error reporting untuk project skrip Anda, Anda dapat melihat log dan laporan tersebut di Konsol Google Cloud dengan melakukan langkah berikut:

  1. Buka project Cloud.
  2. Klik Menu .
  3. Scroll ke bawah ke bagian Operasi lalu klik Logging &gt; Logs explorer.
  4. Untuk melihat laporan error, scroll ke bawah ke bagian Operasi dan klik Error Reporting. Jika Anda diminta untuk mengatur pelaporan kesalahan, ini berarti bahwa proyek skrip Anda belum mencatat pengecualian apa pun.

Saat menggunakan layanan yang memerlukan OAuth, Google akan meminta pengguna untuk memberikan otorisasi layanan IT perusahaan mereka. 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 pengaturan tersebut. Project Cloud standar memungkinkan menyesuaikan informasi ini. Anda dapat mengonfigurasi izin skrip dengan melakukan hal berikut:

  1. Buka project Cloud.
  2. Klik Menu &gt; API & Layanan &gt; Kredensial.
  3. Klik Konfigurasi layar izin.
  4. Isi setiap bagian alur kerja layar izin.
  5. Untuk merekam perubahan pada 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 secret klien). Anda hanya dapat melakukannya dengan project standar.

Untuk membuat client ID dan rahasia klien untuk project skrip Anda, lakukan berikut ini:

  1. Buka project Cloud.
  2. Klik Menu &gt; API & Layanan &gt; Kredensial.
  3. Klik Buat kredensial &gt; Client ID OAuth.
  4. Di bagian Application type, pilih jenis aplikasi Anda dan isi formulir yang dihasilkan jika diperlukan. Setelah selesai, klik Create.
  5. 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 tambahan atau peran lain ke project standar. Jika Anda berkolaborasi dalam sebuah proyek, hal ini membantu memastikan bahwa seseorang dalam tim selalu memiliki akses ke setelan Google Cloud project skrip.

Anda bisa menambahkan pemilik tambahan atau peran lainnya ke project standar dengan melakukan mengikuti. Anda harus memiliki izin edit agar proyek dapat membuat salah satu perubahan ini:

  1. Tentukan siapa kolaborator Anda. Sebaiknya Anda membuat atau menggunakan grup Google yang sudah ada. Anda dapat menentukan domain dalam daftar kolaborator untuk menyertakan semua pengguna di dalamnya {i>Directory<i}
  2. Buka project Cloud skrip.
  3. Klik Menu &gt; IAM & admin &gt; IAM.
  4. Di bagian atas, klik Tambahkan.
  5. Ikuti petunjuk di layar untuk menambahkan satu atau beberapa anggota baru dan peran mereka ke project Cloud. Anda dapat menambahkan email satu per satu, Google Grup, atau domain sebagai anggota baru.
  6. Klik Simpan.

Mengelompokkan beberapa skrip dengan satu project Cloud

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

Gunakan project Cloud standar yang berbeda

Anda dapat mengganti project skrip agar menggunakan standar yang berbeda project Google Cloud. Jika skrip Anda memerlukan konfigurasi manual dari di project Google Cloud. Anda harus beralih dari project default ke project standar. proyek. Untuk mempelajari lebih lanjut tentang kapan Anda perlu menggunakan proyek standar, lihat project Cloud standar.

Pengaruh peralihan ke project Cloud standar yang berbeda

Jika Anda mengalihkan skrip dari project default atau ke standar lain proyek ini, memiliki dampak sebagai berikut:

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

    Di project Cloud standar, aktifkan Drive API:

    Aktifkan Drive API

  • Semua pengguna yang sebelumnya telah memberikan otorisasi pada skrip harus memberikan otorisasi ulang. Di beberapa sebagian besar kasus, semua pengguna yang sebelumnya telah memberikan otorisasi aplikasi yang terkait dengan proyek 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 diterapkan ke project baru. Anda harus membuat listingan aplikasi di dalam project baru dan pengguna harus menginstal ulang aplikasi Anda. Untuk informasi tentang cara membuat listingan aplikasi, lihat Memublikasikan aplikasi.
  • Anda tidak dapat mengalihkan skrip kembali ke project default. Penghapusan Apps Script project default setelah Anda menetapkan skrip untuk menggunakan project standar.

Beralih ke project Cloud standar yang berbeda

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

  1. Jika Anda tidak memiliki project Cloud yang sesuai, buat langkah pertama dengan mengikuti tutorial Membuat project petunjuk. Tetapkan nama project yang mudah diingat sehingga Anda dapat menemukannya di halaman Manage Resources konsol Google Cloud. Apps Script menggunakan nama ini saat meminta pengguna untuk melakukan otorisasi pada skrip.
  2. Jika Anda ingin menggunakan project yang ada, buka halaman Kelola Resource di konsol Google Cloud dan temukan project yang ada untuk digunakan. Anda harus memiliki Peran Browser Project dan OAuth Config Editor, atau peran dengan padanan izin akses, untuk proyek. Anda tidak dapat menggunakan project yang dibuat secara otomatis oleh Apps Naskah.
  3. Tentukan Project number project Cloud Anda.
  4. Buka skrip yang Project Cloudnya ingin Anda ganti.
  5. Di sebelah kiri, klik Project Settings .
  6. Pada Google Cloud Platform (GCP) Project, klik Change project.
  7. 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 Apps Script project dan dokumen Drive. Drive bersama sangat berguna saat mengembangkan skrip, {i>add-on<i}, dan aplikasi web dengan sebuah tim, tetapi mereka menempatkan beberapa batasan pada apa yang dapat Anda lakukan dengan project Cloud default lama.

Daftar batasan berikut menjelaskan cara project Cloud berinteraksi dengan drive bersama:

  • Jika proyek skrip Anda menggunakan proyek standar, tidak ada batasan tambahan jika 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 skrip project berada di drive bersama.
  • Jika project skrip Anda menggunakan project default yang dibuat sebelumnya 8 April 2019, pembatasan berikut berlaku saat skrip project berada di drive bersama:
    1. 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.
    2. Anda tidak dapat mengaktifkan layanan lanjutan. Untuk mengaktifkan layanan lanjutan, beralihlah ke layanan standar proyek.
    3. Saat Anda memindahkan project Apps Script yang ada ke drive bersama, Google membatasi akses ke project Cloud default. Anda masih dapat mengakses project default jika Anda memiliki akses sebelum pemindahan. Sebagai contoh, jika Anda membuat skrip di folder Drive Saya, lalu memindahkannya file itu ke dalam {i>drive<i} bersama, Anda masih dapat mengakses file skrip project Google Cloud. Kolaborator Anda di drive bersama mungkin tidak dapat melakukannya.
    4. Skrip mempertahankan nama project Cloud yang dimilikinya sebelum pindah ke {i>drive<i} bersama. Meskipun Anda mengubah nama project di drive bersama, pengguna yang memberikan otorisasi pada skrip tetap melihat nama lama pada otorisasi dialog yang berbeda.

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

Mendapatkan daftar project Cloud Apps Script

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

  1. Buka halaman Manage Resources konsol Google Cloud.
  2. Di samping folder Apps Script, salin ID.
  3. Klik Filter &gt; ID Induk, lalu tempel ID folder Apps Script.

Menghapus project Cloud Apps Script

Untuk menghapus project Cloud Apps Script, ikuti langkah-langkah di bagian Mendapatkan 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 mengetahui informasi selengkapnya tentang cara menghapus project Cloud, lihat Menghentikan (menghapus) project.