google-apps-script Handledning
Komma igång med google-apps-script

Anmärkningar

Installation eller installation

Google Apps Script kräver inte installation eller installation. Det enda kravet är ett Google-konto. Ett Gmail-konto fungerar liksom ett Google Apps for Work / Education / Government-konto. Du kan skapa ett nytt Google-konto genom att gå till accounts.google.com

Börja ditt första skript genom att gå till script.google.com . Du kan också komma åt Google Apps-skriptet under tools -> Script editor... för många Google Apps, dvs dokument, ark, formulär osv . Google Apps-skript kan också läggas direkt till din Google Drive med funktionen Connect more apps..

Officiell dokumentation finns på utvecklare.google.com/apps-script/ .

För att app-skript ska kunna köras måste de innehålla en code.gs-fil. Filen code.gs måste innehålla en funktion som heter doGet (fristående skript) eller en onOpen-funktion (tilläggsskript). Snabbstart i dokumentationen innehåller exempel.

Om en api är aktiverad i app-skriptet måste den också vara påslagen i utvecklare-konsolen. Emellertid innehåller utvecklarkonsolen api som kan aktiveras men inte visas i app-skriptgränssnittet. Till exempel måste Marketplace SDK vara påslagen i utvecklarkonsolen innan appen kan publiceras i Google Play Store eller till en G-domänbredd distribution.

För Google-appar för utbildning / arbete / regering finns det inställningar i domänadministratörskonsolen som kan justeras för att tillåta eller låta app-skript köras.

Typer av skript

Google App-skript är av tre typer.

• Fristående
• Bundet till Google Apps
• Webb-appar

Fristående skript

Fristående skript är inte bundna till några Google-appar, det vill säga Docs, Sheets eller Forms etc. Fristående skript kan antingen skapas genom att besöka script.google.com eller genom att ansluta Google-appskript till Google Drive. Fristående skript kan användas för att programmera Google-appar oberoende, kan användas som en webbapp eller kan konfigureras så att den körs automatiskt från en installerbar trigger. Se dokumentationen för fristående skript.

Bundet till Google Apps

Skript bundet till Google Apps också känt som containerbindat skript; till skillnad från fristående skript, är bundna till Google-appar, dvs Google Docs eller Google Sheets osv. Behållarbundet skript kan skapas genom att välja tools> Script editor från Google App. Vissa funktioner som dialogrutor, instruktioner, menyer och sidofält tillhandahålls endast av behållarbundna skript. Dessutom används behållarbundet skript för att skapa Google-tillägg . Se dokumentationen för behållarbundna skript.

Webb-appar

Google App Script kan användas som webbapp eftersom de kan nås via webbläsaren. Webapp kan tillhandahålla användargränssnitt i webbläsaren och kan använda Google-appar, dvs dokument, ark etc. Både fristående skript och skript bundna till Google Apps kan förvandlas till webbappar. För att alla skript ska fungera som en webbapp måste skriptet uppfylla två krav:

• inkludera en doGet() eller doPost() -funktion.
• Funktionen returnerar ett HTML-tjänste-HtmlOutput-objekt eller ett innehållstjänst TextOutput-objekt.

Inshort, doGet() och doPost() -funktioner fungerar som http hämta respektive postbehandlare.

Mer information om webbappar finns i den officiella dokumentationen .

Kör / felsöker ditt skript

Försök att köra din kod från verktygsfältet som visas nedan:

I din kod, om du har mer än en funktion då, innan du kör den bör du nämna den funktion du vill köra med. Till exempel :

Alternativt kan du trycka på ctrl + r från tangentbordet för att köra koden. Den sparar koden först, om den inte sparas, och kör sedan den. Men för att detta ska fungera måste du ha valt funktionen, som visas på bilden ovan.

Om ditt skript kallas av externa aktiviteter kan du fortfarande se loggar genom att klicka på visa-> loggar om du loggar något efter att koden har körts.

Hej världen

Vi kommer att säga hej som en meddelanderuta.

function helloWorld() 
{
  Browser.msgBox("Hello World");
}

För att köra skriptet, klicka antingen på ▶ eller välj menyalternativet Kör -> helloWorld

En djupare titt på Google Apps-skriptet

Google Apps Script är en JavaScript-baserad plattform som tjänst som främst används för att automatisera och utöka Google Apps. Apps Script körs uteslutande på Googles infrastruktur som inte kräver någon servertilldelning eller konfiguration. En online IDE fungerar som gränssnitt till hela plattformen som förbinder alla tjänster som är tillgängliga för Apps Script. Användarautentisering bakas in i plattformen via OAuth2 och kräver ingen kod eller installation av skriptförfattaren.

Apps Script körs på serversidan, men kan ha användargränssnitt byggda med Html, CSS, JavaScript eller någon annan webbläserstödd teknik. Till skillnad från Nodejs, som är händelsedriven, körs App Scripts i en gängad modell. Alla samtal till ett skript genererar en unik instans av det skriptet som körs isolerat från alla andra instanser. När en instans av ett skript slutför körningen förstörs den.

Funktioner i Apps Script blockerar så att återuppringning och async-programmeringsmönster inte behövs. Låsning används för att förhindra att kritiska avsnitt av kod, till exempel fil IO, körs samtidigt av olika instanser.

I praktiken är att skriva Apps-skript enkelt. Nedan följer ett enkelt skript som skapar ett nytt kalkylblad från ett kalkylblad.

// Create a new spreadsheet from a template
function createSpreadsheet(){
   var templateFileId = '1Azcz9GwCeHjGl9TXf4aUh6g20Eqmgd1UMSdNVjzIZPk';
   var sheetName = 'Account Log for:' + new Date();
   SpreadsheetApp.openById(templateFileId).copy(sheetName);   
}