Class Presentation

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

Paramètres

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Paramètres

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Paramètres

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Paramètres

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Paramètres

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Ajoute le tableau d'utilisateurs donné à la liste des spectateurs de l'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

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 maître actuel. Le maître actuel est l'un des éléments suivants:

• Maître de la dernière diapositive actuelle.
• 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 avec un ou plusieurs des champs d'application suivants:

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

Ajoute une diapositive à la fin de la présentation à l'aide de 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 actuelle.
• Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

Renvois

Slide : nouvelle diapositive ajoutée.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 maître actuel. Le maître actuel est l'un des éléments suivants:

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

Paramètres

Renvois

Slide : nouvelle diapositive ajoutée.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Si la diapositive copiée provient d'une autre présentation, le modèle parent et les pages de mise en page sont également copiés s'ils 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

Renvois

Slide : nouvelle diapositive ajoutée.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 vers 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 le modèle parent sont également copiés s'ils n'existent pas déjà dans la présentation actuelle.

Si le mode de liaison 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 voient le lien vers la diapositive source. SlideLinkingMode.LINKED ne peut pas être utilisé avec les 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

Renvois

Slide : nouvelle diapositive.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 avec un ou plusieurs des champs d'application suivants:

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

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 champs d'application suivants:

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

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 champs d'application suivants:

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

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

Renvois

String : titre de la présentation.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Récupère le maître 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 champs d'application suivants:

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

Récupère la hauteur de page du maître 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 champs d'application suivants:

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

Récupère la largeur de la page du maître 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 champs d'application suivants:

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

Renvoie l'PageElement avec l'ID donné, ou null si aucun n'existe.

Paramètres

Renvois

PageElement : élément de page dont l'ID est indiqué.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Récupère la hauteur de page des diapositives, des mises en page et des modèles 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 champs d'application suivants:

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

Récupère la largeur de page des diapositives, des mises en page et des modèles 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 champs d'application suivants:

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

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 si le script est lié à la présentation.

Notez que la sélection renvoyée est la sélection effective actuelle. Lorsque le script effectue diverses modifications de la présentation, la sélection est transformée pour les prendre en 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 implicitement 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 : 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 champs d'application suivants:

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

Renvoie l'Slide avec l'ID donné, ou null si aucun n'existe.

Paramètres

Renvois

Slide : diapositive associée à l'ID 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 avec un ou plusieurs des champs d'application suivants:

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

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 en cours.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 modèle actuel. Le maître actuel est l'un des éléments suivants:

• Maître de la diapositive précédente.
• Maître de la première diapositive, si l'index d'insertion est nul.
• Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

Renvois

Slide : nouvelle diapositive insérée.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 maître actuel est l'un des éléments suivants:

• Maître de la diapositive précédente.
• Maître de la première diapositive, si l'index d'insertion est nul.
• Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

Renvois

Slide : nouvelle diapositive insérée.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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 maître actuel est l'un des éléments suivants:

• Maître de la diapositive précédente.
• Maître de la première diapositive, si l'index d'insertion est nul.
• Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

Renvois

Slide : nouvelle diapositive insérée.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Si la diapositive copiée provient d'une autre présentation, le modèle parent et les pages de mise en page sont également copiés s'ils 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

Renvois

Slide : nouvelle diapositive insérée.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Insère une copie de l'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 le SlideLinkingMode.

Si la diapositive copiée provient d'une autre présentation, les pages de mise en page et le modèle parent sont également copiés s'ils 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 voient le lien vers la diapositive source. SlideLinkingMode.LINKED ne peut pas être utilisé avec les 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

Renvois

Slide : nouvelle diapositive.

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Supprime l'utilisateur donné de la liste des éditeurs de l'Presentation. Cette méthode n'empêche pas les utilisateurs d'accéder à l'Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Presentation 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

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Supprime l'utilisateur donné de la liste des éditeurs de l'Presentation. Cette méthode n'empêche pas les utilisateurs d'accéder à l'Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Presentation 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

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'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 à l'Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Presentation 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

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'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, l'utilisateur est également supprimé de la liste des éditeurs.

Paramètres

Renvois

Presentation : Presentation 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Paramètres

Renvois

Integer : nombre d'occurrences modifiées

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.

Paramètres

Renvois

Integer : nombre d'occurrences modifiées

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Vous ne pouvez pas modifier un Presentation fermé. Utilisez l'une des méthodes d'ouverture sur SlidesApp pour rouvrir une présentation donnée afin de la 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/presentations.currentonly
• https://www.googleapis.com/auth/presentations

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

Paramètres

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/presentations.currentonly
• https://www.googleapis.com/auth/presentations