فہرست

پڑھنے کا وقت: 30 منٹ

تعارف

گگل ایپس سکرپٹ (GAS) گگل کے مختلف خدمات جیسے گوگل شیٹس، گوگل ڈاک اور گوگل فارمز سے متعلق یک اسکرپٹ ترقیاتی پلاٹ فارم ہے۔ یہ کاموں کو خودکار بنانے، مخصوص خصوصیات شامل کرنے اور گگل خدمات کو ایک ساتھ ملانے کی اجازت دیتا ہے۔

یہ میمو میں، ہم Google Apps Script کے بنیادی اصولوں کو حقیقی مثالوں کے سہارے سے موصول کریں گے۔ متغیرات، لوپس، فنکشنز اور مزید کئیوں جیسے اصولوں پر غور کریں گے، ان کو GAS کے مخصوص ماحول کے مطابق ہموار بناتے ہوئے۔

گوگل ایپس اسکرپٹ میں بنیادی ڈھانچہ

شروع کرنے سے پہلے، ایک Google Apps سکرپٹ کی بنیادی ساخت کا جائزہ لیں۔

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

گوگل ایپس سکرپٹ میں ٹائپز اور متغیرات

Google Apps Script JavaScript کو پروگرامنگ زبان کے طور پر استعمال کرتا ہے۔ ڈیٹا کے ٹائپز اور ویریئبلز معیاری JavaScript کے مماثل انداز میں کام کرتے ہیں۔

/**
 * 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);
}

عمليات و اپریٹرز میں Google Apps Script

گوگل ایپس سکرپٹ میں آپریشنز اور آپریٹرز جافا اسکرپٹ کی طرح ہی ہیں۔

/**
 * 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 aur Const Google Apps Script mein

GAS میں، تصورات کا`var`, let, et `const`انہیں متغیرات کی تعریف کرنے کے لیے استعمال کیا جاتا ہے۔ تاہم، ان کے فرق اور اثرات کو سمجھنا ضروری ہے۔

/**
 * 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);
}

Google Apps Script میں کنٹرول کی ڈسٹرکٹشرز

کنٹرول ساختوں جیسے`if`, else, while et `for`انہیں Google Apps Script میں execution flow کو منیج کرنے کے لیے استعمال کیا جاتا ہے۔

/**
 * 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);
    }
}

پارامٹرز اور اسکوپز Google Apps Script میں

پارامٹرز اور سکوپز GAS میں اسکرپٹس کی ترقی میں ایک اہم کردار ادا کرتے ہیں۔ ان کی کارکردگی کو سمجھ لیں تا کہ غیر متوقع رویے سے بچا جا سکے۔

/**
 * 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);
}

Google Apps Script میں مستقل، متغیر اور حروف

فرق کو سمجھنا`const`, var, et `let`یہ 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);
}

لوپز گوگل ایپس سکرپٹ میں

لُوپ، جیسے`for` et while, عناصر پرloop کرنے اور تکراری عملوں کرنے کے لیے ضروری ہیں

/**
 * 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;
        }
    }
}

Google Apps Script میں اشیاء

اشیا ڈیٹا کو ساخت کرنے کے لیے استعمال ہوتی ہیں۔ GAS میں، کئی اندرونی اشیاء 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");
}

گوگل ایپس سکرپٹ میں ثابتیں، متغیرات اور حروف

فرق کو سمجھنا`const`, var, et `let`یہ 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);
}

Google Apps Script میں_functions

فونکشن پروگرامنگ کی بنیادی اجزاء ہیں۔ GAS میں، انہیں مختلف طریقوں سے تعریف کیا جا سکتا ہے اور بلایا جا سکتا ہے۔

/**
 * 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));
}

Google Apps Script میں Rest اور Spread آپریٹرز

آرام کرنے والے اپریٹرز (…​) اور trasheer (…​) مفید ہیں آرے اور اشیاء کو مختصر طریقے سے منیپولیٹ کرنے کے لیے۔

/**
 * 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);
}

Google Apps Script میں تجزیے کے ذریعے تخصیص

تفکیک تعین ایک طاقتور فیچر ہے جو اشیاء اور آرے سے قیمتیں مختصر طریقے سے نکالنے کی اجازت دیتا ہے۔

/**
 * 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);
}

کلیڈکشنز اور تعیینی پروگرامنگ گوگل ایپس سکرپٹ میں

Google Apps Script ڈیٹرے بنائیں؟ جيسے arrays، اور فنکشنل پروگرامنگ اور δηคลารاتИў iterasyon (><impérative) جیسے`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);
}

نتیجہ

یہ میمو Google Apps Script کے بنیادی مفاهیم کو شامل کرتا ہے، جن کو حقی کوڈ کے مثالوں کے ذریعے ظاہر کیا گیا ہے۔ اس علم کا استعمال آپ اپنی روزمرہ کے کاموں کو خودکار بنانے، اپنے دستاویزات کو اپنی ضرورت کے مطابق بنانے، اور Google Apps Script کے تمام فیچرز کو مکمل طور پر استعمال کرنے کے لیے کریں۔

Articles connexes