Embedded Files
in Terminal:
npx clasp logout
daarna >
npx clasp login
kies nieuwe login met account >>
The Apps Script CLI, or clasp, is a tool that lets you create, edit, and deploy Apps Script projects locally. It lets you create and publish web apps and add-ons for products like Sheets, Docs, Forms, and Slides from the command line. There are two ways you can develop Apps Script, using script.google.com or locally on your computer. We'll be learning how to use clasp, the command line tool for Apps Script.
Node installeren
Node installeren
Installeer Node.js 24 LTS met de Windows-installer vanaf https://nodejs.org/en/download. Laat npm mee installeren. Sluit daarna je oude terminalvensters en open een nieuw PowerShell- of Windows Terminal-venster.
Controleer:
Selecteer waartoe clasp – The Apps Script CLI toegang mag hebben
Selecteer waartoe clasp – The Apps Script CLI toegang mag hebben
https://myaccount.google.com/connections
Alles selecteren
Informatie over je Google Drive-bestanden bekijken. Toegangsdetails bekijken
Alleen de specifieke Google Drive-bestanden bekijken, bewerken, maken en verwijderen die je met deze app gebruikt. Toegangsdetails bekijken
Je Google API-serviceconfiguratie beheren. Toegangsdetails bekijken
Je Google Cloud-gegevens bekijken, bewerken, instellen en verwijderen en het e-mailadres van je Google-account zien.. Toegangsdetails bekijken
Deze applicatie publiceren als een webapp of een service die je gegevens kan delen. Toegangsdetails bekijken
Logboekgegevens voor je projecten bekijken. Toegangsdetails bekijken
Google Apps Script-implementaties maken en updaten. Toegangsdetails bekijken
Google Apps Script-projecten maken en updaten. Toegangsdetails bekijken
Zorg dat je clasp – The Apps Script CLI vertrouwt
Zorg dat je clasp – The Apps Script CLI vertrouwt
Neem het Privacybeleid en de Servicevoorwaarden van clasp – The Apps Script CLI door voor meer informatie over hoe clasp – The Apps Script CLI je gegevens verwerkt en beschermt.
Je kunt op elk gewenst moment wijzigingen aanbrengen via je Google-account.
Ontdek op welke manier Google je helpt gegevens beveiligd te delen.
node --version
npm.cmd --version
Features {:#features}
Features {:#features}
Develop Locally. clasp lets you write code on your own computer and upload it to Apps Script when you're done. You can also download existing Apps Script projects and then edit them locally. Once the code is local, you can use your favorite development tools like git to work on Apps Script projects.
Manage Deployment Versions. Create, update, and view multiple deployments of your project.
Structure Code. clasp automatically converts your flat project on script.google.com into folders. For example:
# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs
# Locally:
├── tests/
│ ├─ slides.gs
│ └─ sheets.gs
What you'll learn {:#what-youll-learn}
What you'll learn {:#what-youll-learn}
This codelab will show you how to do 3 key activities with clasp:
How to create new Apps Script projects
How to clone, pull, and push existing projects
How to manage deployments of your scripts
Once you have Node, install the CLI globally (alias clasp):
npm i @google/clasp -g
https://codelabs.developers.google.com/codelabs/clasp/#1
Note: clasp uses requires Node.js >= v20.0.0. Update Node.js with these commands:
sudo npm install n -g
sudo n latest
also see:
# project uploaden op Windows met clasp `
Dit pakket zet de volledige LIVE KLAAR-bronset 1.24.0 in een afzonderlijk nieuw Apps Script-project. Je bestaande project en de bestaande implementatie blijven behouden. Van de huidige bron wordt eerst een lokale backup gemaakt. Voor het nieuwe project gebruik je een kopie van de database.
De verbinding wordt op jouw computer aangemaakt nadat je met je Google-account bent ingelogd. In deze chat is nog geen nieuw Google-project aangemaakt of verbonden.
## 1 Node installeren
Installeer **Node.js 24 LTS** met de Windows-installer vanaf https://nodejs.org/en/download. Laat npm mee installeren. Sluit daarna je oude terminalvensters en open een nieuw PowerShell- of Windows Terminal-venster.
Controleer:
```powershell
node --version
npm.cmd --version
```
Dit pakket gebruikt clasp **3.4.1**, vastgelegd in package.json en package-lock.json. Gebruik npm.cmd in PowerShell; zo ben je niet afhankelijk van de uitvoering van npm.ps1.
## 2 Google voorbereiden
Open https://script.google.com/home/usersettings en zet **Google Apps Script API** aan.
Zoek in je bestaande Apps Script-project bij **Projectinstellingen → Script-ID** de script-ID op. De /exec-link van de webapp is een andere identificatie en kan hiervoor niet gebruikt worden. De editorlink met /home/projects/.../edit wordt ook geaccepteerd.
Gebruik bij de clasp-login het Google-account dat je bestaande project beheert. De meegeleverde code verwacht setup door stijn.gabeler@gmail.com; gebruik daarvoor hetzelfde beheerdersaccount als in je huidige installatie.
## 3 Databasekopie maken
Open de database van je huidige installatie en kies in Google Sheets **Bestand → Een kopie maken**. Geef deze bijvoorbeeld de naam * project **.
De databaseverwijzing in de geleverde bronset is:
>>>
Controleer in jouw huidige Code.gs of dit ook de database is die je gebruikt. Als je huidige installatie een andere database gebruikt, maak dan van die database een kopie.
Kopieer de ID of de link van de **nieuwe databasekopie**. Het pakket controleert dat je niet de bestaande database of een bekende bronsheet kiest. Het vult de nieuwe database-ID in het nieuwe project in. De overige bronsheets blijven dezelfde externe bronnen voor inzage en import; die worden niet door dit overstappakket gewijzigd.
De kopie bevat onder meer gebruikers, wachtwoordverifiers, lessen, betalingen, factuurnummers en notities. Houd de databasekopie onder je eigen bestaande Google-toegangsbeheer.
## 4 Pakket uitpakken en inloggen
Pak de hele ZIP uit, bijvoorbeeld onder **Documenten\project**. Open de map waarin deze handleiding, package.json en project-Clasp.cjs staan. Open daar een terminal. Je kunt in de adresbalk van Verkenner `powershell` typen en op Enter drukken.
Voer uit:
```powershell
npm.cmd ci
npx.cmd clasp login
```
Voltooi de Google-login in de browser. Er zijn hiervoor geen Git-repository of CI-instellingen nodig.
## 5 Backup en nieuw script aanmaken
Vervang de twee voorbeeldwaarden door de gegevens uit stap 2 en 3:
```powershell
node .\project-Clasp.cjs nieuw --oud-script "SCRIPT_ID_HUIDIGE_PROJECT" --nieuwe-sheet "ID_VAN_DATABASEKOPIE"
```
Met een eigen projectnaam kan dit ook:
```powershell
node .\project-Clasp.cjs nieuw --oud-script "SCRIPT_ID_HUIDIGE_PROJECT" --nieuwe-sheet "ID_VAN_DATABASEKOPIE" --naam "project nieuw"
```
Deze opdracht:
1. Downloadt de actuele editorbron van je bestaande project in een afzonderlijke backupmap.
2. Bewaart controlewaarden bij de backup en hernoemt de oude clasp-koppeling naar projectkoppeling-LEESALLEEN.json. Er blijft in die backupmap geen actieve .clasp.json achter.
3. Maakt een nieuw zelfstandig Apps Script-project met een nieuwe script-ID.
4. Plaatst alle 28 bronbestanden in werkmap\nieuw-project\src, inclusief Lesbeheer.gs en appsscript.json.
5. Koppelt in Code.gs de nieuwe databasekopie en de bijbehorende feedbackbron.
6. Controleert de nieuwe script-ID en database-ID, maakt backups en uploadt de volledige set naar het nieuwe project.
7. Maakt een Apps Script-bronversie in het nieuwe project.
De opdracht publiceert geen nieuwe webapp en wijzigt geen bestaande implementatie of Sites-koppeling. De editorlink van je nieuwe project verschijnt na afloop.
Clasp vervangt bij een push de volledige inhoud van het doelproject. Daarom bevat src de volledige bronset en controleert de uploadopdracht of de koppeling nog naar het nieuw aangemaakte project wijst. De optie --force wordt uitsluitend na deze controle gebruikt voor het nieuwe project en zijn manifest.
## 6 Bestaande wachtwoorden behouden met PF_SECRET
**Deze stap is noodzakelijk vóór setup.** Script properties horen bij een Apps Script-project en worden niet door een broncode-upload meegenomen.
1. Open in het oude project **Projectinstellingen → Script properties**.
2. Zoek de eigenschap **PF_SECRET** en kopieer de bestaande waarde.
3. Open in het nieuwe project dezelfde instellingen, voeg een eigenschap **PF_SECRET** toe en plak exact dezelfde waarde.
4. Sla de instelling op.
De waarde blijft rechtstreeks bij Google; dit pakket bevat of vraagt die waarde niet. De kopie van de database bevat de wachtwoordverifiers, maar deze bestaande eigenschap is nodig om die te controleren. Gebruik geen nieuw verzonnen PF_SECRET voor de gekopieerde gebruikers.
Neem de overige oude properties niet blind over: sommige wijzen naar een oude backup of bevatten alleen status van taken. De normale basisinstellingen kunnen in het nieuwe project opnieuw worden opgebouwd. Het oude project bewaart zijn bestaande properties.
## 7 Nieuwe installatie openen
Voer in de editor van het **nieuwe project** de functie **setup** uit. Geef het script de gevraagde Google-autorisatie. Je bestaande gegevens staan in de gekoppelde databasekopie; setup vult ontbrekende structuur en instellingen aan.
Maak daarna in het nieuwe project via **Implementeren → Nieuwe implementatie → Webapp** een eigen webapp-implementatie. Gebruik dezelfde gewenste uitvoer- en toegangsinstellingen als bij je bestaande webapp. De meegeleverde manifestinstellingen zijn gelijk aan de werkende 1.24.0-set.
Open de nieuwe /exec-link en controleer jouw login, lessen, facturen en de nieuwe lesbeheerfunctie. Pas wanneer je deze nieuwe installatie wilt gaan gebruiken, wijzig je de embedlink op je Google Site naar die nieuwe /exec-link. De oude link en het oude Apps Script-project blijven bestaan.
Installable triggers en bestaande implementaties worden niet automatisch gekopieerd. Activeer periodieke taken, zoals maandfacturen, bij de overstap bewust in één actieve installatie. PDF-export gebruikt dezelfde Drive-dienst en scopes als de geleverde app; als je een apart standaard Google Cloud-project koppelt, moet de benodigde Drive API daar ook beschikbaar zijn.
## 8 Voortaan bijwerken via clasp
Bewerk de bestanden onder **werkmap\nieuw-project\src**. Je kunt deze map in bijvoorbeeld VS Code openen. De map broncode is de meegeleverde oorspronkelijke basis, niet de actieve nieuwe projectmap.
Status bekijken:
```powershell
node .\project-Clasp.cjs status
```
Nieuwe lokale wijzigingen naar het nieuwe project uploaden:
```powershell
node .\project-Clasp.cjs upload
```
De upload maakt eerst een bronbackup van de huidige remote inhoud van het nieuwe project en een snapshot van jouw lokale src-map. Vervolgens worden de bronbestanden geupload en wordt een bronversie aangemaakt. De oorspronkelijke project-ID mag niet als uploadbestemming worden gebruikt.
Editor openen:
```powershell
node .\project-Clasp.cjs open
```
Na een volgende bronupload werk je de implementatie van het **nieuwe project** bij via Implementaties beheren. Een gewone clasp push verandert de editorbron; de bestaande gepubliceerde webappversie wordt daarmee niet vanzelf vervangen.
Gebruik deze pakketopdrachten voor de dagelijkse upload. De gekoppelde .clasp.json staat in werkmap\nieuw-project. Handmatig die koppeling veranderen naar het oude project omzeilt de bedoelde werkwijze en wordt door de pakketcontrole tegengehouden.
## Backup terugvinden en overstappen
Backups staan onder **werkmap\backups**, telkens in een nieuwe map met een tijdstempel. De bronbackup van het oude project is een download van de editorbron op dat moment; de oudere gepubliceerde versies blijven in het oorspronkelijke Google-project aanwezig.
De bestanden met SHA-256-controlewaarden helpen om de inhoud van een snapshot te vergelijken. OAuth-inloggegevens en PF_SECRET zitten niet in deze bronbackups. De oude database blijft de originele gegevens bewaren. De nieuwe database is een momentopname: latere wijzigingen in de oude installatie worden niet automatisch overgenomen. Zorg bij de definitieve overstap dat je de nieuwste lessen en financiële gegevens meeneemt.
Wil je terug naar de oorspronkelijke webapp, gebruik dan de oude /exec-link opnieuw in je Site. Het pakket heeft die implementatie niet gewijzigd.
Als de aanmaak halverwege mislukt, blijven de bronbackup en een eventueel aangemaakt nieuw Google-project behouden. Bij een onvoltooide lokale map kun je werkmap\nieuw-project eerst naar een andere naam hernoemen en de aanmaak opnieuw starten. Bij een voltooide koppeling gebruik je status en upload. De opdrachten overschrijven niet stilzwijgend een bestaande projectmap.
## Wat is gecontroleerd?
De volledige appbron komt uit de gecontroleerde LIVE KLAAR-set 1.24.0. De overstapworkflow is gecontroleerd met nagebootste clasp-opdrachten: eerst backup, nieuw project met andere ID, volledige bronset, databasekopie, blokkering van de oude script-ID en oude database, bronbackups vóór uploads en afwijzen van onvolledige of dubbele bestanden. Clasp 3.4.1 is lokaal geïnstalleerd en de CLI en lokale bestandsselectie zijn apart gecontroleerd.
De Google-login en het aanmaken of uploaden van echte projecten zijn hier niet uitgevoerd. Daarvoor voer jij de opdrachten op je Windows-pc uit.
## Officiële documentatie
- Clasp en de actuele opdrachten: https://github.com/google/clasp
- Google Apps Script met clasp: https://developers.google.com/apps-script/guides/clasp
- Apps Script API-toegang inschakelen: https://developers.google.com/apps-script/api/how-tos/enable
- Script properties beheren: https://developers.google.com/apps-script/guides/properties
- Node.js LTS voor Windows: https://nodejs.org/en/download
Page updated
Google Sites
Report abuse