Tingkat coding: Menengah
Durasi: 30 menit
Jenis project: Add-on Google Workspace
Tujuan
- Pahami fungsi solusi.
- Pahami fungsi layanan Apps Script dalam solusi.
- Siapkan lingkungan.
- Siapkan skrip.
- Jalankan skrip.
Tentang solusi ini
Menyalin makro Google Spreadsheet secara manual dari satu spreadsheet ke spreadsheet lain dapat memakan waktu dan rentan error. Add-on Google Workspace ini otomatis menyalin project skrip dan melampirkan skrip tersebut ke spreadsheet yang ditentukan pengguna. Meskipun solusi ini berfokus pada makro Spreadsheet, Anda dapat menggunakannya untuk menyalin dan membagikan skrip yang terikat penampung.
Cara kerjanya
Skrip ini menyalin project Apps Script yang terikat dengan spreadsheet asli dan membuat project Apps Script duplikat yang terikat dengan spreadsheet yang ditentukan pengguna.
Layanan Apps Script
Solusi ini menggunakan layanan berikut:
- Layanan URL-fetch–Terhubung ke Apps Script API untuk menyalin project sumber dan membuat salinan.
- Layanan skrip–Memberi otorisasi pada Apps Script API untuk menghindari perintah otorisasi kedua.
- Layanan spreadsheet–Membuka spreadsheet target untuk menambahkan project Apps Script yang disalin.
- Layanan kartu–Membuat antarmuka pengguna add-on.
Prasyarat
Untuk menggunakan contoh ini, Anda memerlukan prasyarat berikut:
- Akun Google (akun Google Workspace mungkin memerlukan persetujuan administrator).
Browser web dengan akses ke internet.
Google Apps Script API diaktifkan di setelan dasbor Apps Script.
Menyiapkan lingkungan Anda
Buka project Cloud Anda di konsol Google Cloud
Jika belum terbuka, buka project Cloud yang ingin Anda gunakan untuk contoh ini:
- Di konsol Google Cloud, buka halaman Select a project.
- Pilih project Google Cloud yang ingin Anda gunakan. Atau, klik Buat project dan ikuti petunjuk di layar. Jika membuat project Google Cloud, Anda mungkin perlu mengaktifkan penagihan untuk project tersebut.
Mengaktifkan Google Apps Script API
Panduan memulai ini menggunakan Google Apps Script API.
Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.Di project Cloud, aktifkan Google Apps Script API.
Mengonfigurasi layar izin OAuth
Add-on Google Workspace memerlukan konfigurasi layar izin. Mengonfigurasi layar izin OAuth add-on akan menentukan apa yang ditampilkan Google kepada pengguna.
- Di konsol Google Cloud, buka Menu > > Branding.
- Jika telah mengonfigurasi , Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang bertuliskan not configured yet, klik Get Started:
- Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan nama untuk aplikasi.
- Di Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna jika mereka memiliki pertanyaan tentang izin mereka.
- Klik Berikutnya.
- Di bagian Audiens, pilih Internal.
- Klik Berikutnya.
- Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
- Klik Berikutnya.
- Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya setuju dengan Layanan Google API: Kebijakan Data Pengguna.
- Klik Lanjutkan.
- Klik Buat.
- Untuk saat ini, Anda dapat melewati penambahan cakupan. Di masa mendatang, saat membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah Jenis pengguna menjadi Eksternal. Kemudian, tambahkan cakupan otorisasi yang diperlukan aplikasi Anda. Untuk mempelajari lebih lanjut, lihat panduan lengkap Mengonfigurasi izin OAuth.
Menyiapkan skrip
Membuat project Apps Script
- Klik tombol berikut untuk membuka project Apps Script Bagikan makro.
Membuka project - Klik Ringkasan .
- Di halaman ringkasan, klik Buat salinan
.
Menyalin nomor project Cloud
- Di konsol Google Cloud, buka Menu > IAM & Admin > Settings.
- Di kolom Project number, salin nilainya.
Menetapkan project Cloud project Apps Script
- Di project Apps Script yang disalin,
klik Project Settings
.
- Pada Google Cloud Platform (GCP) Project, klik Change project.
- Di GCP project number, tempel nomor project Google Cloud.
- Klik Set project.
Menginstal deployment pengujian
- Di project Apps Script yang disalin, klik Editor .
- Buka file
UI.gs
, lalu klik Jalankan. Jika diminta, izinkan skrip. - Klik Deploy > Test deployments.
- Klik Instal > Selesai.
Mendapatkan informasi skrip makro dan spreadsheet
- Buka spreadsheet Spreadsheet yang memiliki makro dan Anda memiliki izin untuk mengeditnya. Untuk menggunakan contoh spreadsheet, buat salinan spreadsheet Contoh makro.
- Klik Ekstensi > Apps Script.
- Di project Apps Script, klik
Project settings
.
- Di bagian ID skrip, klik Salin.
- Simpan ID skrip untuk digunakan di langkah berikutnya.
- Buka atau buat spreadsheet baru tempat Anda ingin menambahkan makro. Anda harus memiliki izin untuk mengedit spreadsheet.
- Salin URL spreadsheet dan sisihkan untuk digunakan di langkah berikutnya.
Jalankan skrip:
Pastikan Google Apps Script API diaktifkan di setelan dasbor Anda. Lakukan langkah-langkah di bagian berikut untuk menjalankan skrip Anda.
Menyalin makro
- Di Spreadsheet, di sidebar kanan, buka add-on Bagikan Makro
.
- Di bagian Source macro, tempel ID skrip.
- Di bagian Target spreadsheet, tempel URL spreadsheet.
- Klik Bagikan makro.
- Klik Authorize access dan beri otorisasi pada add-on.
- Ulangi langkah 2-4.
Membuka makro yang disalin
- Jika belum terbuka, buka spreadsheet tempat Anda menyalin makro.
- Klik Ekstensi > Apps Script.
- Jika Anda tidak melihat project Apps Script yang disalin, pastikan Google Apps Script API diaktifkan di setelan dasbor dan ulangi langkah-langkah yang tercantum di bagian Menyalin makro.
Meninjau kode
Untuk meninjau kode Apps Script untuk solusi ini, klik Lihat kode sumber di bawah:
Melihat kode sumber
Code.gs
UI.gs
appsscript.json
Kontributor
Contoh ini dikelola oleh Google dengan bantuan Pakar Developer Google.