Menggunakan antarmuka command line dengan clasp

Untuk mengembangkan dan mengelola project Google Apps Script dari terminal, bukan editor Apps Script, gunakan alat open source clasp.

Codelab clasp memberikan ringkasan semua fitur clasp.

Fitur

clasp menyertakan fitur berikut:

Mengembangkan secara lokal

clasp memungkinkan Anda mengembangkan project Apps Script secara lokal. Tulis kode di komputer Anda sendiri dan upload ke Apps Script setelah selesai. Anda juga dapat mendownload project Apps Script yang ada untuk mengeditnya secara offline. Gunakan alat pengembangan favorit Anda seperti git saat membuat project Apps Script.

Mengelola versi deployment

Buat, perbarui, dan lihat beberapa deployment project Anda.

Kode struktur

clasp memungkinkan Anda mengatur kode ke dalam direktori, yang dipertahankan saat Anda menguploadnya ke script.google.com. Misalnya:

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

Jenis project

Anda dapat menggunakan clasp untuk mengelola project skrip mandiri dan yang terikat dengan penampung.

Project mandiri

Project mandiri akan muncul sebagai file terpisah di Google Drive Anda. Anda dapat membuat skrip mandiri baru menggunakan perintah clasp create.

Project yang terikat dengan penampung

Project yang terikat dengan penampung dilampirkan ke file Google Dokumen, Spreadsheet, Slide, atau Google Formulir. Anda dapat membuat skrip terikat penampung baru yang dilampirkan ke file baru menggunakan perintah clasp create. Anda juga dapat melampirkan skrip baru ke file yang ada menggunakan tanda --parentId.

Jenis project lainnya

clasp juga mendukung pembuatan skrip untuk aplikasi web dan API.

Persyaratan

clasp ditulis dalam Node.js dan didistribusikan menggunakan alat npm. Sebelum menggunakan clasp, Anda harus menginstal Node.js versi 20.0.0 atau yang lebih baru. Penginstalan Node.js memerlukan hak istimewa administratif.

Penginstalan

Setelah menginstal Node.js, gunakan perintah npm berikut untuk menginstal clasp:

npm install @google/clasp -g

Setelah penginstalan, gunakan perintah clasp dari direktori mana pun di komputer Anda.

Gunakan clasp

Gunakan clasp untuk menangani berbagai tugas dari command line. Bagian ini menjelaskan operasi umum yang digunakan saat mengembangkan dengan clasp.

Login

Perintah ini akan login dan mengizinkan pengelolaan project Apps Script Akun Google Anda. Setelah dijalankan, Anda akan diminta untuk login ke Akun Google tempat project Apps Script Anda disimpan.

clasp login

Logout

Perintah ini akan logout dari alat command line. Login kembali menggunakan clasp login untuk mengautentikasi ulang dengan Google sebelum melanjutkan penggunaan clasp.

clasp logout

Membuat project Apps Script baru

Perintah ini akan membuat skrip baru di direktori saat ini dengan judul skrip opsional.

clasp create [scriptTitle] [--type <projectType>] [--parentId <parentId>]

Perintah ini menggunakan parameter opsional berikut:

  • scriptTitle: Judul project skrip.
  • --type <projectType>: Jenis project yang akan dibuat. Nilai yang diizinkan adalah standalone, docs, sheets, slides, forms, webapp, dan api.
  • --parentId <parentId>: ID file Google Drive yang ada (Dokumen, Spreadsheet, Slide, atau Formulir) yang akan menjadi tempat project skrip baru terikat.

Perintah ini juga membuat dua file di direktori saat ini:

  • File .clasp.json yang menyimpan ID skrip.
  • File manifes project appsscript.json yang berisi metadata project.

Meng-clone project yang ada

Perintah ini meng-clone project yang ada di direktori saat ini. Skrip harus dibuat atau dibagikan ke Akun Google Anda. Anda menentukan project skrip yang akan di-clone dengan memberikan ID skripnya. Anda dapat meng-clone project mandiri dan project yang terikat dengan penampung.

Untuk menemukan ID Skrip project:

  1. Buka project Apps Script.
  2. Di sebelah kiri, klik Setelan Project .

  3. Di bagian IDs, salin Script ID.

    clone gesper

Mendownload project skrip

Perintah ini mendownload project Apps Script dari Google Drive ke sistem file komputer Anda.

clasp pull

Mengupload project skrip

Perintah ini mengupload semua file project skrip dari komputer Anda ke Drive.

clasp push

Mencantumkan versi project

Perintah ini mencantumkan nomor dan deskripsi setiap versi project skrip.

clasp versions

Men-deploy project yang dipublikasikan

Deploy project skrip sebagai aplikasi web, add-on Google Workspace, atau file yang dapat dieksekusi. Buat deployment di editor skrip, di manifes project, atau menggunakan clasp.

Untuk men-deploy project dengan clasp, buat terlebih dahulu versi project Apps Script yang tidak dapat diubah. Versi adalah "snapshot" project skrip dan mirip dengan rilis bercabang hanya baca.

clasp version [description]

Perintah ini menampilkan nomor versi yang baru dibuat. Gunakan nomor tersebut untuk men-deploy dan membatalkan deployment instance project Anda:

clasp deploy [version] [description]
clasp undeploy <deploymentId>

Perintah ini mengupdate deployment yang ada dengan versi dan deskripsi baru:

clasp redeploy <deploymentId> <version> <description>

Mencantumkan deployment

Perintah ini mencantumkan ID deployment, versi, dan deskripsi project skrip.

clasp deployments

Membuka project di editor Apps Script

Perintah ini akan membuka project skrip di editor Apps Script. Editor diluncurkan sebagai tab baru di browser web default Anda.

clasp open-script

Berkontribusi pada project open source clasp

Berkontribusilah pada clasp di GitHub.