Introduzione

Google Apps Script (GAS) è una piattaforma di sviluppo di script associata a diversi servizi Google quali Google Sheets, Google Docs e Google Forms. Consente di automatizzare le attività, aggiungere funzionalità personalizzate e integrare i servizi Google.

In questo promemoria, esploreremo i principali concetti di Google Apps Script basandoci su esempi concreti. Tratteremo nozioni come le variabili, i cicli, le funzioni e molto altro, adattandole al contesto specifico di GAS.

Struttura di base in Google Apps Script

Per cominciare, esaminiamo la struttura di base di uno script Google Apps.

/**
 * Structure de base en Google Apps Script
 */
function exempleStructureGAS() {
    // Votre code ici
    Logger.log("Hello, Google Apps Script!");
}

Tipi e Variabili in Google Apps Script

Google Apps Script utilizza JavaScript come linguaggio di programmazione. I tipi di dati e le variabili funzionano in modo simile a JavaScript standard.

/**
 * Types et Variables en Google Apps Script
 */
function exempleTypesVariablesGAS() {
    // Votre code ici
    var nombre = 42;
    var texte = "Bonjour, Google Apps Script!";
    Logger.log(nombre);
    Logger.log(texte);
}

Operazioni e Operatori in Google Apps Script

Le operazioni e gli operatori in Google Apps Script sono gli stessi di JavaScript.

/**
 * Opérations et Opérateurs en Google Apps Script
 */
function exempleOperationsGAS() {
    // Votre code ici
    var x = 10;
    var y = 5;
    var resultat = x + y;
    Logger.log(resultat);
}

Var, Let e Const in Google Apps Script

In GAS, i concetti di`var`, let, et `const`sono utilizzati per dichiarare variabili. Tuttavia, è essenziale comprendere le loro differenze e le loro implicazioni.

/**
 * Var, Let et Const en Google Apps Script
 */
function exempleVarLetConstGAS() {
    // Votre code ici
    // Utilisation de var
    var x = 10;
    if (true) {
        var x = 20; // La variable x est modifiée globalement
    }
    Logger.log(x);

    // Utilisation de let
    let y = 30;
    if (true) {
        let y = 40; // La variable y est limitée au bloc if
    }
    Logger.log(y);

    // Utilisation de const
    const z = 50;
    // z = 60; // Impossible de réassigner une constante
    Logger.log(z);
}

Strutture di Controllo in Google Apps Script

Le strutture di controllo come`if`, else, while et `for`sono utilizzate per gestire il flusso di esecuzione in Google Apps Script.

/**
 * Structures de Contrôle en Google Apps Script
 */
function exempleStructuresControleGAS() {
    // Votre code ici
    var condition = true;

    if (condition) {
        Logger.log("La condition est vraie.");
    } else {
        Logger.log("La condition est fausse.");
    }

    var compteur = 0;
    while (compteur < 5) {
        Logger.log(compteur);
        compteur++;
    }

    for (var i = 0; i < 3; i++) {
        Logger.log(i);
    }
}

Parametri e Scopes in Google Apps Script

I parametri e gli ambiti svolgono un ruolo cruciale nello sviluppo di script in GAS. Capisci come funzionano per evitare comportamenti imprevisti.

/**
 * Paramètres et Scopes en Google Apps Script
 */
function exempleParametresScopesGAS(parametre) {
    // Votre code ici
    var variableGlobale = "Je suis global";

    function afficherParametre() {
        Logger.log(parametre);
    }

    afficherParametre();
    Logger.log(variableGlobale);
}

Constantes, Variables, et Lettres en Google Apps Script

Comprendere la differenza tra`const`, var, et `let`è essenziale per un utilizzo efficace delle variabili in Google Apps Script.

/**
 * Constantes, Variables, et Lettres en Google Apps Script
 */
function exempleConstantesVariablesLettresGAS() {
    // Votre code ici
    const constante = "Je ne change pas";
    Logger.log(constante);

    var variable = "Je peux changer";
    Logger.log(variable);

    let lettre = "Je peux aussi changer, mais seulement dans mon bloc";
    Logger.log(lettre);
}

Cicli in Google Apps Script

I cicli, come`for` et while, sono essenziali per iterare sugli elementi e eseguire operazioni ripetitive.

/**
 * Boucles en Google Apps Script
 */
function exempleBouclesGAS() {
    // Votre code ici
    for (var i = 0; i < 3; i++) {
        Logger.log(i);
    }

    var condition = true;
    var compteur = 0;

    while (condition) {
        Logger.log("Tour de boucle");
        compteur++;
        if (compteur === 3) {
            condition = false;
        }
    }
}

Oggetti in Google Apps Script

Gli oggetti vengono utilizzati per strutturare i dati. In GAS, molti oggetti integrati facilitano l’interazione con i servizi Google.

/**
 * Objets en Google Apps Script
 */
function exempleObjetsGAS() {
    // Votre code ici
    var feuille = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
    var cellule = feuille.getRange("A1");
    cellule.setValue("Nouvelle valeur");
}

Costanti, Variabili e Lettere in Google Apps Script

Capire la differenza tra`const`, var, et `let`è essenziale per un utilizzo efficace delle variabili in Google Apps Script.

/**
 * Constantes, Variables, et Lettres en Google Apps Script
 */
function exempleConstantesVariablesLettresGAS() {
    // Votre code ici
    const constante = "Je ne change pas";
    Logger.log(constante);

    var variable = "Je peux changer";
    Logger.log(variable);

    let lettre = "Je peux aussi changer, mais seulement dans mon bloc";
    Logger.log(lettre);
}

Funzioni in Google Apps Script

Le funzioni sono elementi fondamentali nella programmazione. In GAS, possono essere dichiarate e richiamate in diversi modi.

/**
 * Fonctions en Google Apps Script
 */
function exempleFonctionsGAS() {
    // Votre code ici
    function additionner(a, b) {
        return a + b;
    }

    var resultat = additionner(2, 3);
    Logger.log(resultat);

    // Fonction anonyme
    var multiplier = function (x, y) {
        return x * y;
    };

    Logger.log(multiplier(4, 5));
}

Operatori di Rest e Spread in Google Apps Script

Gli operatori di riposo (…​) e di propagazione (…​) sono utili per manipolare gli array e gli oggetti in modo conciso.

/**
 * Opérateurs de Repos et de Propagation en Google Apps Script
 */
function exempleOperateursReposPropagationGAS() {
    // Votre code ici
    // Opérateur de repos (...) pour les tableaux
    var nombres = [1, 2, 3, 4, 5];
    var [...copieNombres] = nombres;
    Logger.log(copieNombres);

    // Opérateur de propagation (...) pour les objets
    var objOriginal = { x: 1, y: 2 };
    var objClone = { ...objOriginal, z: 3 };
    Logger.log(objClone);
}

Assegnazione per decomposizione in Google Apps Script

L’assegnazione per decomposizione è una funzionalità potente che permette di estrarre valori da oggetti e array in modo conciso.

/**
 * Affectation par Décomposition en Google Apps Script
 */
function exempleAffectationDecompositionGAS() {
    // Votre code ici
    var coordonnees = [3, 4];
    var [x, y] = coordonnees;
    Logger.log(x);
    Logger.log(y);

    var utilisateur = { nom: "John", age: 30 };
    var { nom, age } = utilisateur;
    Logger.log(nom);
    Logger.log(age);
}

Collezioni e Programmazione Dichiarativa in Google Apps Script

Google Apps Script supporta le strutture di dati come gli array, e i concetti di programmazione funzionale e di iterazione dichiarativa (><imperativa), come`map`, reduce et forEach.

/**
 * Collections et Programmation Déclarative en Google Apps Script
 */
function exempleCollectionsFonctionnelleGAS() {
    // Votre code ici
    // Exemple de tableau (collection)
    var nombres = [1, 2, 3, 4, 5];

    // Utilisation de forEach
    nombres.forEach(function (nombre) {
        Logger.log(nombre);
    });

    // Utilisation de map
    var carresNombres = nombres.map(function (nombre) {
        return nombre * nombre;
    });
    Logger.log(carresNombres);

    // Utilisation de reduce
    var somme = nombres.reduce(function (acc, nombre) {
        return acc + nombre;
    }, 0);
    Logger.log(somme);
}

Conclusione

Questo promemoria ha coperto i concetti fondamentali di Google Apps Script illustrandoli con esempi di codice concreti. Utilizza queste conoscenze per automatizzare le tue attività quotidiane, personalizzare i tuoi documenti e sfruttare appieno le funzionalità di Google Apps Script.

Articoli correlati