Class Presentation

Présentation

Une présentation.

Méthodes

MéthodeType renvoyéBrève description
addEditor(emailAddress)PresentationAjoute l'utilisateur donné à la liste des éditeurs pour Presentation.
addEditor(user)PresentationAjoute l'utilisateur donné à la liste des éditeurs pour Presentation.
addEditors(emailAddresses)PresentationAjoute le tableau d'utilisateurs indiqué à la liste des éditeurs pour Presentation.
addViewer(emailAddress)PresentationAjoute l'utilisateur donné à la liste des lecteurs pour Presentation.
addViewer(user)PresentationAjoute l'utilisateur donné à la liste des lecteurs pour Presentation.
addViewers(emailAddresses)PresentationAjoute le tableau d'utilisateurs donné à la liste des lecteurs pour Presentation.
appendSlide()SlideAjoute une diapositive à la fin de la présentation en utilisant la mise en page prédéfinie PredefinedLayout.BLANK basée sur le masque actuel.
appendSlide(layout)SlideAjoute une diapositive à la fin de la présentation en utilisant la mise en page spécifiée en fonction du maître actuel.
appendSlide(predefinedLayout)SlideAjoute une diapositive à la fin de la présentation en utilisant la mise en page prédéfinie spécifiée en fonction du masque actuel.
appendSlide(slide)SlideAjoute une copie du Slide fourni à la fin de la présentation.
appendSlide(slide, linkingMode)SlideAjoute une copie du Slide fourni à la présentation source à la fin de la présentation actuelle et définit le lien de la diapositive comme spécifié par SlideLinkingMode.
getEditors()User[]Récupère la liste des éditeurs pour ce Presentation.
getId()StringRécupère l'identifiant unique de la présentation.
getLayouts()Layout[]Récupère les mises en page dans la présentation.
getMasters()Master[]Récupère les maîtres dans la présentation.
getName()StringRécupère le nom ou le titre de la présentation.
getNotesMaster()NotesMasterRécupère le masque de notes de la présentation.
getNotesPageHeight()NumberRécupère la hauteur de la page maître et des pages de notes de la présentation, en points.
getNotesPageWidth()NumberRécupère la largeur de la page du masque de notes et des pages de notes de la présentation, en points.
getPageElementById(id)PageElementRenvoie la valeur PageElement avec l'ID donné ou null s'il n'en existe aucun.
getPageHeight()NumberRécupère la hauteur de page des diapositives, des mises en page et des masques de la présentation, en points.
getPageWidth()NumberRécupère la largeur de page des diapositives, des mises en page et des masques de la présentation, en points.
getSelection()SelectionRécupère la sélection de l'utilisateur dans la présentation active.
getSlideById(id)SlideRenvoie la valeur Slide avec l'ID donné ou null s'il n'en existe aucun.
getSlides()Slide[]Récupère les diapositives de la présentation.
getUrl()StringRécupère l'URL permettant d'accéder à cette présentation.
getViewers()User[]Récupère la liste des lecteurs et des commentateurs de ce Presentation.
insertSlide(insertionIndex)SlideInsère une diapositive selon l'index spécifié dans la présentation, en utilisant la mise en page prédéfinie PredefinedLayout.BLANK en fonction du masque actuel.
insertSlide(insertionIndex, layout)SlideInsère une diapositive selon l'index spécifié dans la présentation, en utilisant la mise en page spécifiée en fonction du masque actuel.
insertSlide(insertionIndex, predefinedLayout)SlideInsère une diapositive selon l'index spécifié dans la présentation, en utilisant la mise en page prédéfinie spécifiée en fonction du masque actuel.
insertSlide(insertionIndex, slide)SlideInsère une copie du Slide fourni à l'index spécifié dans la présentation.
insertSlide(insertionIndex, slide, linkingMode)SlideInsère une copie du Slide fourni à partir de la présentation source dans l'index spécifié de la présentation actuelle, puis définit le lien de la diapositive comme spécifié par SlideLinkingMode.
removeEditor(emailAddress)PresentationSupprime l'utilisateur indiqué de la liste des éditeurs pour Presentation.
removeEditor(user)PresentationSupprime l'utilisateur indiqué de la liste des éditeurs pour Presentation.
removeViewer(emailAddress)PresentationSupprime l'utilisateur indiqué de la liste des lecteurs et des commentateurs de Presentation.
removeViewer(user)PresentationSupprime l'utilisateur indiqué de la liste des lecteurs et des commentateurs de Presentation.
replaceAllText(findText, replaceText)IntegerRemplace toutes les occurrences de texte correspondant au texte recherché par le texte de remplacement.
replaceAllText(findText, replaceText, matchCase)IntegerRemplace toutes les occurrences de texte correspondant au texte recherché par le texte de remplacement.
saveAndClose()voidEnregistre le Presentation actuel.
setName(name)voidDéfinit le nom ou le titre de la présentation.

Documentation détaillée

addEditor(emailAddress)

Ajoute l'utilisateur donné à la liste des éditeurs pour Presentation. Si l'utilisateur figurait déjà dans la liste des visiteurs, cette méthode l'exclut de la liste.

Paramètres

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

Renvois

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

addEditor(user)

Ajoute l'utilisateur donné à la liste des éditeurs pour Presentation. Si l'utilisateur figurait déjà dans la liste des visiteurs, cette méthode l'exclut de la liste.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à ajouter.

Renvois

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

addEditors(emailAddresses)

Ajoute le tableau d'utilisateurs indiqué à la liste des éditeurs pour Presentation. Si l'un des utilisateurs figurait déjà dans la liste des lecteurs, cette méthode l'exclut de la liste.

Paramètres

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

Renvois

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

addViewer(emailAddress)

Ajoute l'utilisateur donné à la liste des lecteurs pour Presentation. 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

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

addViewer(user)

Ajoute l'utilisateur donné à la liste des lecteurs pour Presentation. 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

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

addViewers(emailAddresses)

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

Paramètres

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

Renvois

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

appendSlide()

Ajoute une diapositive à la fin de la présentation en utilisant la mise en page prédéfinie PredefinedLayout.BLANK basée sur le masque actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la dernière diapositive en cours.
  • Premier masque de la présentation, s'il n'y a pas de diapositive

Renvois

Slide : nouvelle diapositive ajoutée.

Autorisation

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

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

appendSlide(layout)

Ajoute une diapositive à la fin de la présentation en utilisant la mise en page spécifiée en fonction du maître actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la dernière diapositive en cours.
  • Premier masque de la présentation, s'il n'y a pas de diapositive

Paramètres

NomTypeDescription
layoutLayoutMise en page à utiliser pour la nouvelle diapositive (elle doit être présente dans le masque actuel).

Renvois

Slide : nouvelle diapositive ajoutée.

Autorisation

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

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

appendSlide(predefinedLayout)

Ajoute une diapositive à la fin de la présentation en utilisant la mise en page prédéfinie spécifiée en fonction du masque actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la dernière diapositive en cours.
  • Premier masque de la présentation, s'il n'y a pas de diapositive

Paramètres

NomTypeDescription
predefinedLayoutPredefinedLayoutMise en page prédéfinie à utiliser pour la nouvelle diapositive (elle doit être présente dans le masque actuel).

Renvois

Slide : nouvelle diapositive ajoutée.

Autorisation

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

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

appendSlide(slide)

Ajoute une copie du Slide fourni à la fin de la présentation.

Si la diapositive en cours de copie provient d'une autre présentation, les pages maître et de mise en page parentes sont également copiées si elles n'existent pas déjà dans cette présentation.

// Copy a slide from another presentation and appends it.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

Paramètres

NomTypeDescription
slideSlideDiapositive à copier et à ajouter.

Renvois

Slide : nouvelle diapositive ajoutée.

Autorisation

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

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

appendSlide(slide, linkingMode)

Ajoute une copie du Slide fourni à la présentation source à la fin de la présentation actuelle et définit le lien de la diapositive comme spécifié par SlideLinkingMode.

Si la diapositive en cours de copie provient d'une autre présentation, les pages maître et de mise en page parentes sont également copiées si elles n'existent pas déjà dans la présentation actuelle.

Si le mode de lien est SlideLinkingMode.LINKED, la diapositive ajoutée peut être mise à jour pour correspondre à la diapositive source fournie lorsque Slide.refreshSlide() est appelé. Les autres collaborateurs peuvent voir le lien vers la diapositive source. SlideLinkingMode.LINKED ne peut pas être utilisé avec des diapositives sources de la présentation actuelle.

// Copy a slide from another presentation, then append and link it.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var appendedSlide = currentPresentation.appendSlide(slide, SlidesApp.SlideLinkingMode.LINKED);

Paramètres

NomTypeDescription
slideSlideDiapositive à copier, ajouter et lier.
linkingModeSlideLinkingModeMode d'association à utiliser.

Renvois

Slide : nouvelle diapositive.

Autorisation

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

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

getEditors()

Récupère la liste des éditeurs pour ce Presentation.

Renvois

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

Autorisation

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

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

getId()

Récupère l'identifiant unique de la présentation. L'ID de présentation est utilisé avec SlidesApp.openById() pour ouvrir une instance de présentation spécifique.

Renvois

String : ID de cette présentation.

Autorisation

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

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

getLayouts()

Récupère les mises en page dans la présentation.

Renvois

Layout[] : liste des mises en page de cette présentation.

Autorisation

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

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

getMasters()

Récupère les maîtres dans la présentation.

Renvois

Master[] : liste des maîtres dans cette présentation.

Autorisation

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

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

getName()

Récupère le nom ou le titre de la présentation.

Renvois

String : titre de cette présentation.

Autorisation

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

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

getNotesMaster()

Récupère le masque de notes de la présentation.

Renvois

NotesMaster : masque de notes de la présentation.

Autorisation

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

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

getNotesPageHeight()

Récupère la hauteur de la page maître et des pages de notes de la présentation, en points. Ils ont tous la même hauteur de page.

Renvois

Number : hauteur de la page de notes, en points.

Autorisation

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

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

getNotesPageWidth()

Récupère la largeur de la page du masque de notes et des pages de notes de la présentation, en points. Ils ont tous la même largeur de page.

Renvois

Number : largeur de la page de notes, en points.

Autorisation

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

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

getPageElementById(id)

Renvoie la valeur PageElement avec l'ID donné ou null s'il n'en existe aucun.

Paramètres

NomTypeDescription
idStringID de l'élément de page en cours de récupération.

Renvois

PageElement : élément de page avec l'ID donné.

Autorisation

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

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

getPageHeight()

Récupère la hauteur de page des diapositives, des mises en page et des masques de la présentation, en points. Ils ont tous la même hauteur de page.

Renvois

Number : hauteur de la page, en points.

Autorisation

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

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

getPageWidth()

Récupère la largeur de page des diapositives, des mises en page et des masques de la présentation, en points. Ils ont tous la même largeur de page.

Renvois

Number : largeur de la page, en points.

Autorisation

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

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

getSelection()

Récupère la sélection de l'utilisateur dans la présentation active. Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement s'il est lié à la présentation.

Notez que la sélection renvoyée est la sélection effective actuelle. Lorsque le script apporte diverses modifications à la présentation, la sélection est transformée pour en tenir compte. Par exemple, si les deux formes A et B sont sélectionnées et que le script supprime la forme B, l'objet de sélection renvoyé est implicitement mis à jour de sorte que seule la forme A soit sélectionnée.

// Gets the current active page that is selected in the active presentation.
var selection = SlidesApp.getActivePresentation().getSelection();
var currentPage = selection.getCurrentPage();

Renvois

Selection : représentation de la sélection de l'utilisateur, ou null si le script n'est pas lié à la présentation ou s'il n'y a pas de sélection d'utilisateur valide.

Autorisation

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

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

getSlideById(id)

Renvoie la valeur Slide avec l'ID donné ou null s'il n'en existe aucun.

Paramètres

NomTypeDescription
idStringID de la diapositive en cours de récupération.

Renvois

Slide : diapositive avec l'ID donné.

Autorisation

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

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

getSlides()

Récupère les diapositives de la présentation.

Renvois

Slide[] : liste des diapositives de cette présentation.

Autorisation

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

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

getUrl()

Récupère l'URL permettant d'accéder à cette présentation.

var presentation = SlidesApp.getActivePresentation();

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

Renvois

String : URL permettant d'accéder à la présentation actuelle.

Autorisation

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

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

getViewers()

Récupère la liste des lecteurs et des commentateurs de ce Presentation.

Renvois

User[] : tableau des utilisateurs disposant d'une autorisation d'affichage ou de commentaire.

Autorisation

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

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

insertSlide(insertionIndex)

Insère une diapositive selon l'index spécifié dans la présentation, en utilisant la mise en page prédéfinie PredefinedLayout.BLANK en fonction du masque actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la diapositive précédente.
  • Masque de la première diapositive, si insertionIndex est égal à zéro.
  • Premier masque de la présentation, s'il n'y a pas de diapositive

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant où insérer la diapositive.

Renvois

Slide : nouvelle diapositive insérée.

Autorisation

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

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

insertSlide(insertionIndex, layout)

Insère une diapositive selon l'index spécifié dans la présentation, en utilisant la mise en page spécifiée en fonction du masque actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la diapositive précédente.
  • Masque de la première diapositive, si insertionIndex est égal à zéro.
  • Premier masque de la présentation, s'il n'y a pas de diapositive

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant où insérer la diapositive.
layoutLayoutMise en page à utiliser pour la nouvelle diapositive (elle doit être présente dans le masque actuel).

Renvois

Slide : nouvelle diapositive insérée.

Autorisation

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

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

insertSlide(insertionIndex, predefinedLayout)

Insère une diapositive selon l'index spécifié dans la présentation, en utilisant la mise en page prédéfinie spécifiée en fonction du masque actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la diapositive précédente.
  • Masque de la première diapositive, si insertionIndex est égal à zéro.
  • Premier masque de la présentation, s'il n'y a pas de diapositive

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant où insérer la diapositive.
predefinedLayoutPredefinedLayoutMise en page prédéfinie à utiliser pour la nouvelle diapositive (elle doit être présente dans le masque actuel).

Renvois

Slide : nouvelle diapositive insérée.

Autorisation

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

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

insertSlide(insertionIndex, slide)

Insère une copie du Slide fourni à l'index spécifié dans la présentation.

Si la diapositive en cours de copie provient d'une autre présentation, les pages maître et de mise en page parentes sont également copiées si elles n'existent pas déjà dans cette présentation.

// Copy a slide from another presentation and inserts it.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides()[0];
var insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant où insérer la diapositive.
slideSlideDiapositive à copier et à insérer.

Renvois

Slide : nouvelle diapositive insérée.

Autorisation

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

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

insertSlide(insertionIndex, slide, linkingMode)

Insère une copie du Slide fourni à partir de la présentation source dans l'index spécifié de la présentation actuelle, puis définit le lien de la diapositive comme spécifié par SlideLinkingMode.

Si la diapositive en cours de copie provient d'une autre présentation, les pages maître et de mise en page parentes sont également copiées si elles n'existent pas déjà dans la présentation actuelle.

Si le mode de liaison est SlideLinkingMode.LINKED, la diapositive insérée peut être mise à jour pour correspondre à la diapositive source fournie lorsque Slide.refreshSlide() est appelé. Les autres collaborateurs peuvent voir le lien vers la diapositive source. SlideLinkingMode.LINKED ne peut pas être utilisé avec des diapositives sources de la présentation actuelle.

// Copy a slide from another presentation, then insert and link it.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var insertionIndex = 1;
var insertedSlide =
    currentPresentation.insertSlide(
    insertionIndex, slide, SlidesApp.SlideLinkingMode.LINKED);

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant où insérer la diapositive.
slideSlideDiapositive à copier et à insérer.
linkingModeSlideLinkingModeMode d'association à utiliser.

Renvois

Slide : nouvelle diapositive.

Autorisation

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

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

removeEditor(emailAddress)

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

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

Paramètres

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

Renvois

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

removeEditor(user)

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

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

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à supprimer.

Renvois

Presentation : Presentation, pour le chaînage.

Autorisation

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

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

removeViewer(emailAddress)

Supprime l'utilisateur indiqué de la liste des lecteurs et des commentateurs de Presentation. 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 au Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général (par exemple, si Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si Presentation se trouve dans un Drive partagé auquel l'utilisateur peut accéder).

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

Paramètres

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

Renvois

Presentation : Presentation pour le chaînage.

Autorisation

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

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

removeViewer(user)

Supprime l'utilisateur indiqué de la liste des lecteurs et des commentateurs de Presentation. 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 au Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général (par exemple, si Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si Presentation se trouve dans un Drive partagé auquel l'utilisateur peut accéder).

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

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à supprimer.

Renvois

Presentation : Presentation pour le chaînage.

Autorisation

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

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

replaceAllText(findText, replaceText)

Remplace toutes les occurrences de texte correspondant au texte recherché par le texte de remplacement. La recherche n'est pas sensible à la casse.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte pour remplacer le texte correspondant.

Renvois

Integer : le nombre d'occurrences a changé.

Autorisation

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

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

replaceAllText(findText, replaceText, matchCase)

Remplace toutes les occurrences de texte correspondant au texte recherché par le texte de remplacement.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte pour remplacer le texte correspondant.
matchCaseBooleanSi la valeur est true, la recherche est sensible à la casse. Si la valeur est false, la recherche n'est pas sensible à la casse.

Renvois

Integer : le nombre d'occurrences a changé.

Autorisation

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

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

saveAndClose()

Enregistre le Presentation actuel. 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 Presentation ouvert, même si l'exécution du script s'est terminée par une erreur.

Impossible de modifier un Presentation fermé. Utilisez l'une des méthodes ouvertes sur SlidesApp pour rouvrir une présentation donnée pour la modifier.

Autorisation

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

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

setName(name)

Définit le nom ou le titre de la présentation.

Paramètres

NomTypeDescription
nameStringNom à définir pour cette présentation.

Autorisation

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

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