Module Google Apps Script

Des fonctions liées à des services Google Apps Script précis : Sheets, Slides, Admin SDK, Drive, Docs, Forms, requêtes réseau et classes d'interface intégrées.

La mention New signale une fonction ajoutée dans la dernière version ; Deprecated une fonction dont le retrait est prévu dans une version future.

Méthodes de base

Aides générales utilisées par les modules Google Apps Script ci-dessous.

Fonction	Type de retour	Description brève
`getByteSize`	`Number`	Renvoie la longueur d'une chaîne en unités de code.
`getTriggerById` New	`Trigger \\| null`	Trouve l'un des déclencheurs du projet par son identifiant.

Méthodes Admin SDK Directory

Aides pour le service Admin SDK Directory.

Fonction	Type de retour	Description brève
`isAdmin`	`Boolean`	Indique si l'utilisateur courant est administrateur Workspace.
`nonAdmin` New	`Boolean`	Indique que l'utilisateur courant n'est pas administrateur Workspace.
`requireAdmin` New	`void`	Interrompt l'appel si l'utilisateur courant n'est pas administrateur Workspace.

Méthodes Google Drive

Fonction	Type de retour	Description brève
`createFolder` New	`Folder`	Crée un chemin de dossiers dans Drive en réutilisant ceux qui existent déjà.

Méthodes Google Docs

Aides pour Google Docs. Pas encore implémentées. Les contributions sont bienvenues — voir Contributing.

Méthodes Google Forms

Aides pour Google Forms. Pas encore implémentées. Les contributions sont bienvenues — voir Contributing.

Méthodes Google Sheets

Aides pour lire, écrire et valider des données de feuilles : lignes et colonnes, analyse de la notation A1, comparaisons de GridRange et gardes de type pour les objets Sheet, Spreadsheet et Range.

Fonction	Type de retour	Description brève
`appendColumn`	`Sheet`	Ajoute une colonne après la dernière colonne contenant des données.
`appendColumns`	`Sheet`	Ajoute des colonnes après la dernière colonne contenant des données.
`appendRow`	`Sheet`	Ajoute une ligne après la dernière ligne contenant des données.
`appendRows`	`Sheet`	Ajoute des lignes après la dernière ligne contenant des données.
`clearColumnsByConditional` New	`Number`	Vide les colonnes que le prédicat sélectionne, sans supprimer les colonnes.
`clearRowsByConditional` New	`Number`	Vide les lignes que le prédicat sélectionne, sans supprimer les lignes.
`convertRichTextToHtml`	`String`	Rend une valeur de cellule en texte enrichi sous forme de HTML.
`deleteColumnsByConditional` New	`Number`	Supprime les colonnes que le prédicat sélectionne.
`deleteRowsByConditional` New	`Number`	Supprime les lignes que le prédicat sélectionne.
`doGridRangesIntersect`	`Boolean`	Indique si deux plages de grille se recouvrent sur au moins une cellule.
`extractRangeFromA1Notation` New	`String \\| null`	Extrait la partie plage d'une notation A1.
`extractSheetNameFromA1Notation`	`String \\| null`	Extrait le nom de feuille d'une notation A1.
`getColumnIndexByLetter`	`Number \\| null`	Convertit une lettre de colonne en son indice à base zéro.
`getColumnLetterByIndex`	`String`	Convertit un indice de colonne à base zéro en sa lettre.
`getColumnLetterByPosition`	`String`	Convertit une position de colonne à base un en sa lettre.
`getColumnPositionByLetter`	`Number \\| null`	Convertit une lettre de colonne en sa position à base un.
`getNamedRangeByName` New	`NamedRange \\| null`	Trouve une plage nommée par son nom.
`getSchema` New	`SheetSchema \\| null`	Renvoie le schéma d'une feuille, stocké ou déduit de son contenu.
`getSheetById`	`Sheet` \\| null	Trouve une feuille par son identifiant.
`getSheetByIndex`	`Sheet` \\| null	Trouve une feuille par sa position dans le classeur.
`getValues` New	`Array`	Lit les lignes d'une feuille, filtrées, transformées et paginées en un seul appel.
`highlightHtml`	`String`	Colore le HTML d'une plage comme du code source.
`insertSchema` New	`Sheet`	Stocke un schéma sur une feuille et applique ce qu'il décrit.
`isCellGridRange`	`Boolean`	Vérifie si une valeur est une plage d'une seule cellule.
`isGridRangeContainedIn`	`Boolean`	Vérifie si une plage de grille est entièrement contenue dans une autre.
`isGridRangeSameDimensions`	`Boolean`	Vérifie si deux plages de grille ont la même hauteur et la même largeur.
`isRange`	`Boolean`	Vérifie si une valeur est une plage.
`isRichTextValue`	`Boolean`	Vérifie si une valeur est une valeur de texte enrichi.
`isSheet`	`Boolean`	Vérifie si une valeur est une feuille.
`isSpreadsheet`	`Boolean`	Vérifie si une valeur est un classeur.
`isTextStyle`	`Boolean`	Vérifie si une valeur est un style de texte.
`isValidSheetId`	`Boolean`	Vérifie si une valeur est un identifiant de feuille.
`isValidSheetName`	`Boolean`	Vérifie si une valeur est un nom de feuille.
`isValidSpreadsheetId`	`Boolean`	Vérifie si une valeur est un identifiant de classeur.
`nonCellGridRange` New	`Boolean`	Vérifie qu'une valeur n'est pas une plage d'une seule cellule.
`nonGridRangeContainedIn` New	`Boolean`	Vérifie qu'une plage de grille n'est pas entièrement contenue dans une autre.
`nonGridRangeSameDimensions` New	`Boolean`	Vérifie si deux plages de grille diffèrent en hauteur ou en largeur.
`nonRange`	`Boolean`	Vérifie qu'une valeur n'est pas une plage.
`nonRichTextValue` New	`Boolean`	Vérifie qu'une valeur n'est pas une valeur de texte enrichi.
`nonSheet`	`Boolean`	Vérifie qu'une valeur n'est pas une feuille.
`nonSpreadsheet` New	`Boolean`	Vérifie qu'une valeur n'est pas un classeur.
`nonTextStyle` New	`Boolean`	Vérifie qu'une valeur n'est pas un style de texte.
`nonValidSheetId` New	`Boolean`	Vérifie qu'une valeur n'est pas un identifiant de feuille.
`nonValidSheetName` New	`Boolean`	Vérifie qu'une valeur n'est pas un nom de feuille.
`nonValidSpreadsheetId` New	`Boolean`	Vérifie qu'une valeur n'est pas un identifiant de classeur.
`parseA1Notation` New	`GridRange`	Lit une notation A1 en plage de grille.
`parseA1Notations` New	`GridRange[]`	Lit une liste de notations A1 séparées par des virgules.
`prependColumn` New	`Sheet`	Insère une colonne avant les données — dans une feuille ou au niveau d'une plage.
`prependColumns` New	`Sheet`	Insère des colonnes avant les données — dans une feuille ou au niveau d'une plage.
`prependRow`	`Sheet`	Insère une ligne avant les données — dans une feuille ou au niveau d'une plage.
`prependRows`	`Sheet`	Insère des lignes avant les données — dans une feuille ou au niveau d'une plage.
`removeSchema` New	`Boolean`	Supprime le schéma stocké sur une feuille.
`requireCellGridRange` New	`GridRange`	Renvoie la valeur en tant que une plage d'une seule cellule, ou lève une exception.
`requireGridRangeContainedIn` New	`GridRange`	Renvoie la plage une fois établi qu'elle est contenue dans une autre, ou lève.
`requireGridRangeSameDimensions` New	`void`	Renvoie la plage une fois établi que les deux ont la même taille, ou lève.
`requireRange`	`Range`	Renvoie la valeur en tant que une plage, ou lève une exception.
`requireRichTextValue` New	`RichTextValue`	Renvoie la valeur en tant que une valeur de texte enrichi, ou lève une exception.
`requireSheet`	`Sheet`	Renvoie la valeur en tant que une feuille, ou lève une exception.
`requireSpreadsheet` New	`Spreadsheet`	Renvoie la valeur en tant que un classeur, ou lève une exception.
`requireTextStyle` New	`TextStyle`	Renvoie la valeur en tant que un style de texte, ou lève une exception.
`requireValidSheetId` New	`Number`	Renvoie la valeur en tant que un identifiant de feuille, ou lève une exception.
`requireValidSheetName` New	`String`	Renvoie la valeur en tant que un nom de feuille, ou lève une exception.
`requireValidSpreadsheetId` New	`String`	Renvoie la valeur en tant que un identifiant de classeur, ou lève une exception.
`sortSheets`	`void`	Réordonne les onglets d'un classeur.
`toA1Notation`	`String`	Écrit une plage de grille en notation A1.
`updateFormulas` New	`Number`	Réécrit les formules d'une feuille.
`updateSheetNameInA1Notation` New	`String`	Remplace le nom de feuille dans une notation A1 en conservant la plage.

Méthodes Google Slides

Aides pour Google Slides : recherche et position des diapositives, conversion de Markdown en RichTextRun, rechercher-remplacer et gardes de type pour les objets Presentation et Slide.

Fonction	Type de retour	Description brève
`convertMarkdownToRichText` New	`RichTextRun[]`	Transforme un petit sous-ensemble de Markdown en segments de texte stylés.
`convertRichTextToMarkdown` New	`String`	Ramène des fragments de texte stylés vers du Markdown.
`findReplaceAllTextInSlide` New	`Number`	Remplace chaque occurrence d'un texte sur une diapositive.
`getSlideByIndex` New	`Slide` \\|`null`	Trouve la diapositive à une position donnée, dans une présentation ou dans celle active.
`getSlideIndex` New	`Number \\| null`	Trouve la position d'une diapositive, dans une présentation ou dans celle active.
`isPresentation` New	`Boolean`	Vérifie si une valeur est une présentation.
`isSlide` New	`Boolean`	Vérifie si une valeur est une diapositive.
`isValidPresentationId` New	`Boolean`	Vérifie si une valeur est un identifiant de présentation.
`isValidSlideId` New	`Boolean`	Vérifie si une valeur est un identifiant de diapositive.
`nonPresentation` New	`Boolean`	Vérifie qu'une valeur n'est pas une présentation.
`nonSlide` New	`Boolean`	Vérifie qu'une valeur n'est pas une diapositive.
`nonValidPresentationId` New	`Boolean`	Vérifie qu'une valeur n'est pas un identifiant de présentation.
`nonValidSlideId` New	`Boolean`	Vérifie qu'une valeur n'est pas un identifiant de diapositive.
`requirePresentation` New	`Presentation`	Renvoie la valeur en tant que une présentation, ou lève une exception.
`requireSlide` New	`Slide`	Renvoie la valeur en tant que une diapositive, ou lève une exception.
`requireValidPresentationId` New	`String`	Renvoie la valeur en tant que un identifiant de présentation, ou lève une exception.
`requireValidSlideId` New	`String`	Renvoie la valeur en tant que un identifiant de diapositive, ou lève une exception.

Méthodes réseau

Aides pour les opérations réseau — par exemple la validation des jetons de requête.

Fonction	Type de retour	Description brève
`requireValidToken` New	`String`	Renvoie un jeton une fois qu'il correspond à l'une des clés autorisées, ou lève.

Méthodes d'interface

Aides pour ce que voit l'utilisateur — gardes de type Ui, HtmlOutput et TextOutput — ainsi que des gardes de dépendances : dépôts et services utilisés par les applications web.

Fonction	Type de retour	Description brève
`checkMultipleAccount`	`Boolean`	Indique si le script s'exécute sous un compte différent de celui qui l'a lancé.
`isHtmlOutput`	`Boolean`	Vérifie si une valeur est un HtmlOutput.
`isTextOutput`	`Boolean`	Vérifie si une valeur est un TextOutput.
`isUi`	`Boolean`	Vérifie si une valeur est un objet Ui.
`nonHtmlOutput` New	`Boolean`	Vérifie qu'une valeur n'est pas un HtmlOutput.
`nonTextOutput` New	`Boolean`	Vérifie qu'une valeur n'est pas un TextOutput.
`nonUi` New	`Boolean`	Vérifie qu'une valeur n'est pas un objet Ui.
`requireHtmlOutput` New	`HtmlOutput`	Renvoie la valeur en tant que un HtmlOutput, ou lève une exception.
`requireRepository` New	`T`	Renvoie un dépôt une fois établi qu'il existe, ou lève.
`requireService` New	`T`	Renvoie un service une fois établi qu'il existe, ou lève.
`requireTextOutput` New	`TextOutput`	Renvoie la valeur en tant que un TextOutput, ou lève une exception.
`requireUi` New	`Ui`	Renvoie la valeur en tant que un objet Ui, ou lève une exception.

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.