Class Document

Document

Document contenant un ou plusieurs objets Tab, chacun contenant du texte enrichi et des éléments tels que des tableaux et des listes.

Vous pouvez ouvrir ou créer des documents à l'aide de DocumentApp. 

// Open a document by ID.
let doc = DocumentApp.openById('<my-id>');

// Create and open a document.
doc = DocumentApp.create('Document Title');

Les méthodes de la classe Document qui accèdent directement et modifient le contenu textuel fonctionnent sur l'onglet actif (dans les scripts liés à un document particulier) ou sur le premier onglet (si aucun onglet actif n'est disponible). Les scripts qui s'appuient sur ces méthodes (par exemple, getBody()) peuvent être migrés pour prendre en charge les onglets à l'aide de getTabs(), puis de Tab.asDocumentTab().

Méthodes

MéthodeType renvoyéBrève description
addBookmark(position)BookmarkAjoute un Bookmark à l'Position donnée dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif.
addEditor(emailAddress)DocumentAjoute l'utilisateur donné à la liste des éditeurs de l'Document.
addEditor(user)DocumentAjoute l'utilisateur donné à la liste des éditeurs de l'Document.
addEditors(emailAddresses)DocumentAjoute le tableau d'utilisateurs donné à la liste des éditeurs de l'Document.
addFooter()FooterSectionAjoute une section de pied de page, si elle n'existe pas, au premier onglet ou, pour les scripts liés à un document, à l'onglet actif.
addHeader()HeaderSectionAjoute une section d'en-tête, si aucune n'existe, au premier onglet ou, pour les scripts liés à un document, à l'onglet actif.
addNamedRange(name, range)NamedRangeAjoute un NamedRange, qui est un Range avec un nom et un ID à utiliser pour une récupération ultérieure, dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif.
addViewer(emailAddress)DocumentAjoute l'utilisateur donné à la liste des spectateurs de l'Document.
addViewer(user)DocumentAjoute l'utilisateur donné à la liste des spectateurs de l'Document.
addViewers(emailAddresses)DocumentAjoute le tableau d'utilisateurs donné à la liste des spectateurs de l'Document.
getActiveTab()TabRécupère l'Tab actuellement actif de l'utilisateur dans le document.
getAs(contentType)BlobRécupère le contenu actuel de Document sous forme de blob du type spécifié.
getBlob()BlobRécupère le contenu actuel de Document sous forme de blob.
getBody()BodyRécupère l'Body du premier onglet ou, pour les scripts liés à un document, l'DocumentBodySection de l'onglet actif.
getBookmark(id)BookmarkRécupère l'Bookmark avec l'ID donné dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif.
getBookmarks()Bookmark[]Récupère tous les objets Bookmark dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif.
getCursor()PositionRécupère le curseur de l'utilisateur dans l'onglet actif.
getEditors()User[]Récupère la liste des éditeurs de cet objet Document.
getFooter()FooterSectionRécupère la section de pied de page du premier onglet ou, pour les scripts liés à un document, la section de pied de page de l'onglet actif.
getFootnotes()Footnote[]Récupère tous les éléments Footnote dans le corps du premier onglet ou, pour les scripts liés à un document, dans le corps de l'onglet actif.
getHeader()HeaderSectionRécupère la section d'en-tête du premier onglet ou, pour les scripts liés à un document, la section d'en-tête de l'onglet actif.
getId()StringRécupère l'identifiant unique du document.
getLanguage()StringRécupère le code de langue du document.
getName()StringRécupère le titre du document.
getNamedRangeById(id)NamedRangeRécupère l'NamedRange avec l'ID donné dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif.
getNamedRanges()NamedRange[]Récupère tous les objets NamedRange dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif.
getNamedRanges(name)NamedRange[]Récupère tous les objets NamedRange portant le nom donné dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif.
getSelection()RangeRécupère la sélection de l'utilisateur dans l'onglet actif.
getSupportedLanguageCodes()String[]Récupère tous les codes de langue compatibles avec les fichiers Google Docs.
getTab(tabId)TabRécupère le Tab avec l'ID spécifié.
getTabs()Tab[]Récupère tous les Tab non imbriqués qui font partie du document.
getUrl()StringRécupère l'URL permettant d'accéder au document actuel.
getViewers()User[]Récupère la liste des lecteurs et des commentateurs de cet Document.
newPosition(element, offset)PositionCrée un Position, qui est une référence à un emplacement dans l'onglet, par rapport à un élément spécifique dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif.
newRange()RangeBuilderCrée un compilateur utilisé pour créer des objets Range à partir d'éléments d'onglet dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif.
removeEditor(emailAddress)DocumentSupprime l'utilisateur donné de la liste des éditeurs de l'Document.
removeEditor(user)DocumentSupprime l'utilisateur donné de la liste des éditeurs de l'Document.
removeViewer(emailAddress)DocumentSupprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Document.
removeViewer(user)DocumentSupprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Document.
saveAndClose()voidEnregistre la Document actuelle.
setActiveTab(tabId)voidDéfinit l'Tab sélectionnée par l'utilisateur dans le document actuel sur l'onglet avec l'ID spécifié.
setCursor(position)DocumentDéfinit le curseur de l'utilisateur, à partir d'un Position.
setLanguage(languageCode)DocumentDéfinit le code de langue du document.
setName(name)DocumentDéfinit le titre du document.
setSelection(range)DocumentDéfinit la sélection de l'utilisateur dans l'onglet actif, à partir d'un Range.

Documentation détaillée

addBookmark(position)

Ajoute un Bookmark à l'Position donnée dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif. Pour ajouter un favori à un onglet, utilisez la méthode DocumentTab.addBookmark(position). 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body and adds a paragraph.
const paragraph = doc.getBody().appendParagraph('My new paragraph.');

// Creates a position at the first character of the paragraph text.
const position = doc.newPosition(paragraph.getChild(0), 0);

// Adds a bookmark at the first character of the paragraph text.
const bookmark = doc.addBookmark(position);

// Logs the bookmark ID to the console.
console.log(bookmark.getId());

Paramètres

NomTypeDescription
positionPositionEmplacement du nouveau favori.

Renvois

Bookmark : nouveau signet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addEditor(emailAddress)

Ajoute l'utilisateur donné à la liste des éditeurs de l'Document. Si l'utilisateur figurait déjà dans la liste des spectateurs, cette méthode le supprime de la liste.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à ajouter.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addEditor(user)

Ajoute l'utilisateur donné à la liste des éditeurs de l'Document. Si l'utilisateur figurait déjà dans la liste des spectateurs, cette méthode le supprime de la liste.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à ajouter.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addEditors(emailAddresses)

Ajoute le tableau d'utilisateurs donné à la liste des éditeurs de l'Document. Si l'un des utilisateurs figurait déjà dans la liste des spectateurs, cette méthode le fait sortir de la liste.

Paramètres

NomTypeDescription
emailAddressesString[]Tableau d'adresses e-mail des utilisateurs à ajouter.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addFooter()

Ajoute une section de pied de page, si elle n'existe pas, au premier onglet ou, pour les scripts liés à un document, à l'onglet actif. Pour ajouter une section de pied de page à un onglet, utilisez la méthode DocumentTab.addFooter(). 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a footer to the document's active or first tab.
const footer = doc.addFooter();

// Sets the footer text to 'This is a footer.'
footer.setText('This is a footer');

Renvois

FooterSection : pied de page de l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addHeader()

Ajoute une section d'en-tête, si aucune n'existe, au premier onglet ou, pour les scripts liés à un document, à l'onglet actif. Pour ajouter une section d'en-tête à un onglet, utilisez la méthode DocumentTab.addHeader(). 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a header to the document's active or first tab.
const header = doc.addHeader();

// Sets the header text to 'This is a header.'
header.setText('This is a header');

Renvois

HeaderSection : en-tête de l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addNamedRange(name, range)

Ajoute un NamedRange, qui est un Range avec un nom et un ID à utiliser pour une récupération ultérieure, dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif. Pour ajouter un NamedRange dans un onglet, utilisez la méthode DocumentTab.addNamedRange(name, range). Les noms ne sont pas nécessairement uniques. Plusieurs plages différentes d'un même document peuvent porter le même nom, comme une classe en HTML. À l'inverse, les ID sont uniques dans le document, comme un ID en HTML. Une fois que vous avez ajouté un NamedRange à un document, vous ne pouvez plus le modifier, mais seulement le supprimer.

Tout script qui accède au document peut accéder à un NamedRange. Pour éviter les conflits involontaires entre les scripts, envisagez d'ajouter un préfixe unique aux noms de plage. 

// Creates a named range that includes every table in the active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
// Adds the named range to the document's active tab.
doc.addNamedRange('Document tables', rangeBuilder.build());

Paramètres

NomTypeDescription
nameStringNom de la plage, qui n'a pas besoin d'être unique. Les noms de plage doivent comporter entre 1 et 256 caractères.
rangeRangePlage d'éléments à associer au nom. La plage peut être la sélection active, un résultat de recherche ou construite manuellement avec newRange().

Renvois

NamedRange : NamedRange.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addViewer(emailAddress)

Ajoute l'utilisateur donné à la liste des spectateurs de l'Document. Si l'utilisateur figurait déjà dans la liste des éditeurs, cette méthode n'a aucun effet.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à ajouter.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addViewer(user)

Ajoute l'utilisateur donné à la liste des spectateurs de l'Document. Si l'utilisateur figurait déjà dans la liste des éditeurs, cette méthode n'a aucun effet.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à ajouter.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

addViewers(emailAddresses)

Ajoute le tableau d'utilisateurs donné à la liste des spectateurs de l'Document. Si l'un des utilisateurs figurait déjà dans la liste des éditeurs, cette méthode n'a aucun effet pour lui.

Paramètres

NomTypeDescription
emailAddressesString[]Tableau d'adresses e-mail des utilisateurs à ajouter.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getActiveTab()

Récupère l'Tab actuellement actif de l'utilisateur dans le document. Un script ne peut accéder qu'à l'onglet actif de l'utilisateur qui l'exécute, et uniquement s'il est lié au document. 

// Display a dialog box that shows the title of the tab that the
// user is currently viewing.
const tab = DocumentApp.getActiveDocument().getActiveTab();
DocumentApp.getUi().alert(`ID of selected tab: ${tab.getTitle()}`);

Renvois

Tab : Tab actuellement actif de l'utilisateur, ou null si le script n'est pas lié au document.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getAs(contentType)

Récupère le contenu actuel de Document sous forme de blob du type spécifié. 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the document as a PDF.
const pdf = doc.getAs('application/pdf');

// Logs the name of the PDF to the console.
console.log(pdf.getName());

Paramètres

NomTypeDescription
contentTypeStringType MIME vers lequel effectuer la conversion. 'application/pdf' et 'text/markdown' sont acceptés.

Renvois

Blob : document actuel sous forme de blob.

getBlob()

Récupère le contenu actuel de Document sous forme de blob. 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Retrieves the current document's contents as a blob and logs it to the
// console.
console.log(doc.getBlob().getContentType());

Renvois

Blob : document actuel sous forme de blob.

getBody()

Récupère l'Body du premier onglet ou, pour les scripts liés à un document, l'DocumentBodySection de l'onglet actif. Pour obtenir le DocumentBodySection de n'importe quel onglet, utilisez la méthode DocumentTab.getBody().

Les onglets peuvent contenir différents types de sections (par exemple, HeaderSection, FooterSection). La section active d'un onglet est Body.

Les méthodes d'élément dans Document délèguent à l'Body actif. 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body.
const body = doc.getBody();

// Gets the body text and logs it to the console.
console.log(body.getText());

Renvois

Body : section du corps de l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getBookmark(id)

Récupère l'Bookmark avec l'ID donné dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif. Pour obtenir un favori dans n'importe quel onglet, utilisez la méthode DocumentTab.getBookmark(id). Cette méthode renvoie null si aucun Bookmark de ce type n'existe dans l'onglet. 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the bookmark by its ID in the document's active or first tab.
const bookmark = doc.getBookmark('id.xyz654321');

// If the bookmark exists, logs the character offset of its position to the
// console. otherwise, logs 'No bookmark exists with the given ID.' to the
// console.
if (bookmark) {
  console.log(bookmark.getPosition().getOffset());
} else {
  console.log('No bookmark exists with the given ID.');
}

Paramètres

NomTypeDescription
idStringID de l'Bookmark.

Renvois

Bookmark : Bookmark avec l'ID donné, ou null si aucun Bookmark de ce type n'existe dans l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getBookmarks()

Récupère tous les objets Bookmark dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif. Pour obtenir tous les favoris dans n'importe quel onglet, utilisez la méthode DocumentTab.getBookmarks(). 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
const doc = DocumentApp.openById('123abc');

// Gets all of the bookmarks in the document's active or first tab.
const bookmarks = doc.getBookmarks();

// Logs the number of bookmarks in the tab to the console.
console.log(bookmarks.length);

Renvois

Bookmark[] : tableau des objets Bookmark de l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getCursor()

Récupère le curseur de l'utilisateur dans l'onglet actif. Un script ne peut accéder qu'au curseur de l'utilisateur qui l'exécute, et uniquement si le script est lié au document. 

// Insert some text at the cursor position and make it bold.
const cursor = DocumentApp.getActiveDocument().getCursor();
if (cursor) {
  // Attempt to insert text at the cursor position. If the insertion returns
  // null, the cursor's containing element doesn't allow insertions, so show the
  // user an error message.
  const element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

Renvois

Position : représentation du curseur de l'utilisateur, ou null si l'utilisateur n'a pas de curseur placé dans l'onglet ou si le script n'est pas lié au document.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getEditors()

Récupère la liste des éditeurs de cet objet Document.

Renvois

User[] : tableau d'utilisateurs disposant des droits de modification.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getFooter()

Récupère la section de pied de page du premier onglet ou, pour les scripts liés à un document, la section de pied de page de l'onglet actif. Pour obtenir la section de pied de page de n'importe quel onglet, utilisez la méthode DocumentTab.getFooter(). 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's footer and logs it to the console.
console.log(doc.getFooter().getText());

Renvois

FooterSection : pied de page de l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getFootnotes()

Récupère tous les éléments Footnote dans le corps du premier onglet ou, pour les scripts liés à un document, dans le corps de l'onglet actif. Pour obtenir toutes les notes de bas de page dans n'importe quel onglet, utilisez la méthode DocumentTab.getFootnotes().

Les appels à getFootnotes entraînent une itération sur les éléments de l'onglet. Pour les onglets volumineux, évitez les appels inutiles à cette méthode. 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the first footnote in the active or first tab's body.
const footnote = doc.getFootnotes()[0];

// Logs footnote contents to the console.
console.log(footnote.getFootnoteContents().getText());

Renvois

Footnote[] : notes de bas de page de l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getHeader()

Récupère la section d'en-tête du premier onglet ou, pour les scripts liés à un document, la section d'en-tête de l'onglet actif. Pour obtenir la section d'en-tête de n'importe quel onglet, utilisez la méthode DocumentTab.getHeader(). 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's header and logs it to the console.
console.log(doc.getHeader().getText());

Renvois

HeaderSection : en-tête de l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getId()

Récupère l'identifiant unique du document. L'ID de document est utilisé avec DocumentApp.openById() pour ouvrir une instance de document spécifique.

Renvois

String : ID du document.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLanguage()

Récupère le code de langue du document. Il s'agit de la langue affichée dans Fichier > Langue de l'éditeur de documents, qui peut ne pas être la langue réelle du document.

Renvois

String : langue du document, ou null si elle n'est pas définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getName()

Récupère le titre du document.

Renvois

String : titre du document.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNamedRangeById(id)

Récupère l'NamedRange avec l'ID donné dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif. Pour obtenir le NamedRange avec l'ID donné dans n'importe quel onglet, utilisez la méthode DocumentTab.getNamedRangeById(id). Cette méthode renvoie null si aucun NamedRange de ce type n'existe dans l'onglet. Les noms ne sont pas nécessairement uniques, même entre les onglets. Plusieurs plages différentes d'un même onglet peuvent porter le même nom, comme une classe en HTML. En revanche, les ID sont uniques dans l'onglet, comme un ID en HTML.

Paramètres

NomTypeDescription
idStringID de la plage, unique dans l'onglet.

Renvois

NamedRange : NamedRange avec l'ID donné, ou null si aucune telle plage n'existe dans l'onglet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNamedRanges()

Récupère tous les objets NamedRange dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif. Pour obtenir tous les objets NamedRange dans n'importe quel onglet, utilisez la méthode DocumentTab.getNamedRanges().

Un NamedRange est accessible par n'importe quel script qui accède à l'onglet. Pour éviter les conflits involontaires entre les scripts, envisagez d'ajouter un préfixe unique aux noms de plage.

Renvois

NamedRange[] : tableau des objets NamedRange de l'onglet, pouvant inclure plusieurs plages portant le même nom.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNamedRanges(name)

Récupère tous les objets NamedRange portant le nom donné dans le premier onglet ou, pour les scripts liés à un document, dans l'onglet actif. Pour obtenir tous les objets NamedRange dans n'importe quel onglet, utilisez la méthode DocumentTab.getNamedRanges(name). Les noms ne sont pas nécessairement uniques, même entre les onglets. Plusieurs plages différentes du même onglet peuvent porter le même nom, comme une classe en HTML. En revanche, les ID sont uniques dans l'onglet, comme un ID en HTML.

Un NamedRange est accessible par n'importe quel script qui accède au document. Pour éviter les conflits involontaires entre les scripts, envisagez d'ajouter un préfixe unique aux noms de plage.

Paramètres

NomTypeDescription
nameStringNom de la plage, qui n'est pas nécessairement unique.

Renvois

NamedRange[] : tableau des objets NamedRange de l'onglet portant le nom donné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getSelection()

Récupère la sélection de l'utilisateur dans l'onglet actif. Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié au document. 

// Display a dialog box that tells the user how many elements are included in
// the selection.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  DocumentApp.getUi().alert(`Number of selected elements: ${elements.length}`);
} else {
  DocumentApp.getUi().alert('Nothing is selected.');
}

Renvois

Range : représentation de la sélection de l'utilisateur, ou null si l'utilisateur n'a rien sélectionné dans l'onglet, si seule la fin d'un paragraphe est sélectionnée, si seule la fin d'un paragraphe et une nouvelle ligne sont sélectionnées, ou si le script n'est pas lié au document.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getSupportedLanguageCodes()

Récupère tous les codes de langue compatibles avec les fichiers Google Docs.

Renvois

String[] : tableau de codes de langue.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTab(tabId)

Récupère le Tab avec l'ID spécifié. Cette méthode renvoie null si aucun Tab de ce type n'existe. Peut accéder aux onglets à n'importe quel niveau d'imbrication.

Paramètres

NomTypeDescription
tabIdStringID de l'onglet à obtenir.

Renvois

Tab : Tab associé à l'ID spécifié, ou null si aucun Tab de ce type n'existe.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTabs()

Récupère tous les Tab non imbriqués qui font partie du document.

Les onglets peuvent contenir des onglets enfants, c'est-à-dire des onglets imbriqués dans un autre onglet. Les onglets enfants sont accessibles à l'aide de Tab.getChildTabs().

Renvois

Tab[] : liste de tous les Tab qui font partie du document.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getUrl()

Récupère l'URL permettant d'accéder au document actuel. 

const doc = DocumentApp.getActiveDocument();

// Send out the link to open the document.
MailApp.sendEmail('<email-address>', doc.getName(), doc.getUrl());

Renvois

String : URL permettant d'accéder au document actuel.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getViewers()

Récupère la liste des lecteurs et des commentateurs de cet Document.

Renvois

User[] : tableau d'utilisateurs autorisés à afficher ou à commenter.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

newPosition(element, offset)

Crée un Position, qui est une référence à un emplacement dans l'onglet, par rapport à un élément spécifique dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif. Pour créer un Position par rapport à un emplacement dans n'importe quel onglet, utilisez la méthode DocumentTab.newPosition(element, offset). Le curseur de l'utilisateur est représenté par un Position, entre autres. 

// Append a paragraph to the active tab, then place the user's cursor after the
// first word of the new paragraph.
const doc = DocumentApp.getActiveDocument();
const paragraph = doc.getBody().appendParagraph('My new paragraph.');
const position = doc.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

Paramètres

NomTypeDescription
elementElementÉlément devant contenir la nouvelle Position. Il doit s'agir d'un élément Text ou d'un élément de conteneur tel que Paragraph.
offsetIntegerPour les éléments Text, le nombre de caractères avant Position ; pour les autres éléments, le nombre d'éléments enfants avant Position dans le même élément de conteneur.

Renvois

Position : nouveau Position.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

newRange()

Crée un compilateur utilisé pour créer des objets Range à partir d'éléments d'onglet dans le premier onglet ou, pour les scripts liés à un document, l'onglet actif. Pour créer un outil de création permettant de créer des objets DocumentRange à partir d'éléments d'onglet dans n'importe quel onglet, utilisez la méthode DocumentTab.newRange(). 

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Renvois

RangeBuilder : nouveau générateur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeEditor(emailAddress)

Supprime l'utilisateur donné de la liste des éditeurs de l'Document. Cette méthode n'empêche pas les utilisateurs d'accéder à l'Document s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Document est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Document se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des lecteurs.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à supprimer.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeEditor(user)

Supprime l'utilisateur donné de la liste des éditeurs de l'Document. Cette méthode n'empêche pas les utilisateurs d'accéder à l'Document s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Document est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Document se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des lecteurs.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à supprimer.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeViewer(emailAddress)

Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Document. Cette méthode n'a aucun effet si l'utilisateur est un éditeur, et non un lecteur ou un commentateur. Cette méthode n'empêche pas non plus les utilisateurs d'accéder à l'Document s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Document est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Document se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des éditeurs.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à supprimer.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeViewer(user)

Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Document. Cette méthode n'a aucun effet si l'utilisateur est un éditeur, et non un lecteur. Cette méthode n'empêche pas non plus les utilisateurs d'accéder à Document s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si Document est partagé avec l'ensemble du domaine de l'utilisateur ou si Document se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des éditeurs.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à supprimer.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

saveAndClose()

Enregistre la Document actuelle. Entraîne le vidage et l'application des mises à jour en attente.

La méthode saveAndClose() est automatiquement appelée à la fin de l'exécution du script pour chaque Document modifiable ouvert.

Une Document fermée ne peut pas être modifiée. Utilisez DocumentApp.openById() pour rouvrir un document donné pour le modifier.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setActiveTab(tabId)

Définit l'Tab sélectionnée par l'utilisateur dans le document actuel sur l'onglet avec l'ID spécifié. 

const doc = DocumentApp.getActiveDocument();

// Sets the user's selected tab by its ID.
// TODO(developer): Replace the ID with your own.
const tab = doc.setActiveTab('123abc');

Paramètres

NomTypeDescription
tabIdStringID de l'onglet à définir comme actif.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setCursor(position)

Définit le curseur de l'utilisateur, à partir d'un Position. Un script ne peut accéder qu'au curseur de l'utilisateur qui l'exécute, et uniquement s'il est lié au document.

Fournir un Position à partir d'un Tab inactif change l'onglet actif de l'utilisateur. 

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Append a paragraph, then place the user's cursor after the first word of the
// new paragraph.
const paragraph = documentTab.getBody().appendParagraph('My new paragraph.');
const position = documentTab.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

Paramètres

NomTypeDescription
positionPositionNouvel emplacement du curseur.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLanguage(languageCode)

Définit le code de langue du document. Il s'agit de la langue affichée dans Fichier > Langue de l'éditeur de documents, qui peut ne pas être la langue réelle du document. Utilisez getSupportedLanguageCodes() pour obtenir tous les codes de langue valides.

Paramètres

NomTypeDescription
languageCodeStringCode de langue.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setName(name)

Définit le titre du document.

Paramètres

NomTypeDescription
nameStringTitre du nouveau document.

Renvois

Document : document actuel.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setSelection(range)

Définit la sélection de l'utilisateur dans l'onglet actif, à partir d'un Range. Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié au document. 

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Change the user's selection to a range that includes every table in the
// document.
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Paramètres

NomTypeDescription
rangeRangeNouvelle plage d'éléments à sélectionner.

Renvois

Document : Document pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents