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 donné à la liste des éditeurs de Presentation.
addViewer(emailAddress)PresentationAjoute l'utilisateur donné à la liste des spectateurs de Presentation.
addViewer(user)PresentationAjoute l'utilisateur donné à la liste des spectateurs de Presentation.
addViewers(emailAddresses)PresentationAjoute le tableau d'utilisateurs donné à la liste des spectateurs de Presentation.
appendSlide()SlideAjoute une diapositive à la fin de la présentation à l'aide de 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 masque actuel.
appendSlide(predefinedLayout)SlideAjoute une diapositive à la fin de la présentation à l'aide de la mise en page prédéfinie spécifiée en fonction du modèle actuel.
appendSlide(slide)SlideAjoute une copie du Slide fourni à la fin de la présentation.
appendSlide(slide, linkingMode)SlideAjoute une copie de l'Slide fourni à partir de 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[]Obtient 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 de la présentation.
getMasters()Master[]Récupère les masques de la présentation.
getName()StringRécupère le nom ou le titre de la présentation.
getNotesMaster()NotesMasterRécupère le masque des notes de la présentation.
getNotesPageHeight()NumberObtient la hauteur de page du masque des notes et des pages de notes de la présentation en points.
getNotesPageWidth()NumberObtient la largeur de page du masque des notes et des pages de notes de la présentation en points.
getPageElementById(id)PageElement|nullRenvoie le PageElement avec l'ID spécifié ou null si aucun n'existe.
getPageHeight()NumberRenvoie la hauteur de page des diapositives, des mises en page et des masques de la présentation, en points.
getPageWidth()NumberRenvoie la largeur de page des diapositives, des mises en page et des masques de la présentation, en points.
getSelection()Selection|nullObtient la sélection de l'utilisateur dans la présentation active.
getSlideById(id)Slide|nullRenvoie le Slide avec l'ID spécifié ou null si aucun n'existe.
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[]Obtient la liste des lecteurs et des commentateurs pour ce Presentation.
insertSlide(insertionIndex)SlideInsère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie PredefinedLayout.BLANK basée sur le masque actuel.
insertSlide(insertionIndex, layout)SlideInsère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page spécifiée en fonction du masque actuel.
insertSlide(insertionIndex, predefinedLayout)SlideInsère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie spécifiée en fonction du masque actuel.
insertSlide(insertionIndex, slide)SlideInsère une copie de l'Slide fourni à l'index spécifié dans la présentation.
insertSlide(insertionIndex, slide, linkingMode)SlideInsère une copie de l'Slide fourni à partir de la présentation source dans l'index spécifié de la présentation actuelle, et définit le lien de la diapositive comme spécifié par SlideLinkingMode.
removeEditor(emailAddress)PresentationSupprime l'utilisateur donné de la liste des éditeurs pour le Presentation.
removeEditor(user)PresentationSupprime l'utilisateur donné de la liste des éditeurs pour le Presentation.
removeViewer(emailAddress)PresentationSupprime l'utilisateur spécifié de la liste des spectateurs et des commentateurs pour le Presentation.
removeViewer(user)PresentationSupprime l'utilisateur spécifié de la liste des spectateurs et des commentateurs pour le Presentation.
replaceAllText(findText, replaceText)IntegerRemplace toutes les instances du texte à rechercher par le texte de remplacement.
replaceAllText(findText, replaceText, matchCase)IntegerRemplace toutes les instances du texte à rechercher 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 spectateurs, cette méthode le retire de cette liste.

Paramètres

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

Renvois

Presentation : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 spectateurs, cette méthode le retire de cette liste.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à ajouter.

Renvois

Presentation : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

addEditors(emailAddresses)

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

Paramètres

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

Renvois

Presentation : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

addViewer(emailAddress)

Ajoute l'utilisateur donné à la liste des spectateurs de Presentation. Si l'utilisateur figure 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 : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

addViewer(user)

Ajoute l'utilisateur donné à la liste des spectateurs de Presentation. Si l'utilisateur figure 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 : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 spectateurs de Presentation. 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 des adresses e-mail des utilisateurs à ajouter.

Renvois

Presentation : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

appendSlide()

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

  • Masque de la dernière diapositive actuelle.
  • Le premier masque de la présentation, s'il n'y a pas de diapositive.

Renvois

Slide : la nouvelle diapositive ajoutée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 masque actuel. Le master actuel est l'un des suivants :

  • Masque de la dernière diapositive actuelle.
  • Le 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 : la nouvelle diapositive ajoutée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 à l'aide de la mise en page prédéfinie spécifiée en fonction du modèle actuel. Le master actuel est l'un des suivants :

  • Masque de la dernière diapositive actuelle.
  • Le 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 : la nouvelle diapositive ajoutée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 copiée provient d'une autre présentation, les pages de mise en page et de masque parent sont également copiées si elles n'existent pas déjà dans cette présentation. 

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

Paramètres

NomTypeDescription
slideSlideDiapositive à copier et à ajouter.

Renvois

Slide : la nouvelle diapositive ajoutée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

appendSlide(slide, linkingMode)

Ajoute une copie de l'Slide fourni à partir de 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 copiée provient d'une autre présentation, les pages de mise en page et de masque parent sont également copiées si elles n'existent pas déjà dans la présentation actuelle.

Si le mode d'association 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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

Paramètres

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

Renvois

Slide : la nouvelle diapositive.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getEditors()

Obtient la liste des éditeurs pour ce Presentation.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 la présentation.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getLayouts()

Récupère les mises en page de 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 avec un ou plusieurs des scopes suivants :

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

getMasters()

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

Renvois

Master[] : liste des masques de cette présentation.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 avec un ou plusieurs des scopes suivants :

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

getNotesMaster()

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

Renvois

NotesMaster : masque des notes de la présentation.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getNotesPageHeight()

Obtient la hauteur de page du masque des notes et des pages de notes de la présentation en points. Elles ont toutes 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 avec un ou plusieurs des scopes suivants :

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

getNotesPageWidth()

Obtient la largeur de page du masque des notes et des pages de notes de la présentation en points. Elles ont toutes 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 avec un ou plusieurs des scopes suivants :

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

getPageElementById(id)

Renvoie le PageElement avec l'ID spécifié ou null si aucun n'existe.

Paramètres

NomTypeDescription
idStringID de l'élément de page récupéré.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getPageHeight()

Renvoie la hauteur de page des diapositives, des mises en page et des masques de la présentation, en points. Elles ont toutes 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 avec un ou plusieurs des scopes suivants :

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

getPageWidth()

Renvoie la largeur de page des diapositives, des mises en page et des masques de la présentation, en points. Elles ont toutes 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 avec un ou plusieurs des scopes suivants :

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

getSelection()

Obtient la sélection de l'utilisateur dans la présentation active. Un script ne peut accéder à la sélection de l'utilisateur qui l'exécute que s'il est lié à la présentation.

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

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

Renvois

Selection|null : 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 utilisateur valide.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getSlideById(id)

Renvoie le Slide avec l'ID spécifié ou null si aucun n'existe.

Paramètres

NomTypeDescription
idStringID de la diapositive récupérée.

Renvois

Slide|null : diapositive avec l'ID donné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 la présentation.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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. 

const 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 avec un ou plusieurs des scopes suivants :

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

getViewers()

Obtient la liste des lecteurs et des commentateurs pour ce Presentation.

Renvois

User[] : tableau des utilisateurs disposant de l'autorisation d'afficher ou de commenter.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

insertSlide(insertionIndex)

Insère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie PredefinedLayout.BLANK basée sur le masque actuel. Le maître actuel est l'un des suivants :

  • Masque de la diapositive précédente.
  • Le maître de la première diapositive, si insertionIndex est égal à zéro.
  • Le 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 : la nouvelle diapositive insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

insertSlide(insertionIndex, layout)

Insère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page spécifiée en fonction du masque actuel. Le master actuel est l'un des suivants :

  • Masque de la diapositive précédente.
  • Le maître de la première diapositive, si insertionIndex est égal à zéro.
  • Le 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 : la nouvelle diapositive insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

insertSlide(insertionIndex, predefinedLayout)

Insère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie spécifiée en fonction du masque actuel. Le master actuel est l'un des suivants :

  • Masque de la diapositive précédente.
  • Le maître de la première diapositive, si insertionIndex est égal à zéro.
  • Le 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 : la nouvelle diapositive insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

insertSlide(insertionIndex, slide)

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

Si la diapositive copiée provient d'une autre présentation, les pages de mise en page et de masque parent sont également copiées si elles n'existent pas déjà dans cette présentation. 

// Copy a slide from another presentation and inserts it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const 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 : la nouvelle diapositive insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

insertSlide(insertionIndex, slide, linkingMode)

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

Si la diapositive copiée provient d'une autre présentation, les pages de mise en page et de masque parent sont également copiées si elles n'existent pas déjà dans la présentation actuelle.

Si le mode d'association 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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const 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 : la nouvelle diapositive.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

removeEditor(emailAddress)

Supprime l'utilisateur donné de la liste des éditeurs pour le Presentation. Cette méthode n'empêche pas les utilisateurs d'accéder à 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 : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

removeEditor(user)

Supprime l'utilisateur donné de la liste des éditeurs pour le Presentation. Cette méthode n'empêche pas les utilisateurs d'accéder à 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 : ce Presentation, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

removeViewer(emailAddress)

Supprime l'utilisateur spécifié de la liste des spectateurs et des commentateurs pour le 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 à 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).Presentation

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 : ce Presentation pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

removeViewer(user)

Supprime l'utilisateur spécifié de la liste des spectateurs et des commentateurs pour le 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 à 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 : ce Presentation pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

replaceAllText(findText, replaceText)

Remplace toutes les instances du texte à rechercher par le texte de remplacement. La recherche n'est pas sensible à la casse.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte à utiliser 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 avec un ou plusieurs des scopes suivants :

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

replaceAllText(findText, replaceText, matchCase)

Remplace toutes les instances du texte à rechercher par le texte de remplacement.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte à utiliser 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 avec un ou plusieurs des scopes 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.

Vous ne pouvez pas modifier un Presentation clôturé. Utilisez l'une des méthodes d'ouverture sur SlidesApp pour rouvrir une présentation donnée à des fins de modification.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 avec un ou plusieurs des scopes suivants :

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