Crée une présentation vierge à partir du titre donné dans la requête. Si un presentationId
est fourni, il est utilisé comme ID de la nouvelle présentation. Sinon, un nouvel ID est généré. Les autres champs de la requête, y compris tout contenu fourni, sont ignorés. Affiche la présentation créée.
Requête HTTP
POST https://slides.googleapis.com/v1/presentations
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "presentationId": string, "pageSize": { object ( |
Champs | |
---|---|
presentationId |
ID de la présentation. |
pageSize |
Taille des pages de la présentation. |
slides[] |
Diapositives de la présentation Une diapositive hérite des propriétés d'une mise en page de diapositive. |
title |
Titre de la présentation. |
masters[] |
Masques de diapositives dans la présentation. Un masque de diapositive contient tous les éléments de page communs et les propriétés communes à un ensemble de mises en page. Elles ont trois objectifs:
|
layouts[] |
Mises en page de la présentation. Une mise en page est un modèle qui détermine l'organisation et le style du contenu sur les diapositives qui héritent de cette mise en page. |
locale |
Paramètres régionaux de la présentation, sous forme de tag de langue IETF BCP 47. |
revisionId |
Uniquement en sortie. ID de révision de la présentation. Peut être utilisée dans les requêtes de mise à jour pour confirmer que la révision de la présentation n'a pas changé depuis la dernière opération de lecture. Renseigné uniquement si l'utilisateur est autorisé à modifier la présentation. L'ID de révision n'est pas un nombre séquentiel, mais une chaîne nébuleuse. Le format de l'ID de révision peut changer au fil du temps. Il doit donc être traité de manière opaque. Un ID de révision renvoyé n'est garanti que 24 heures après son retour et ne peut pas être partagé entre les utilisateurs. Si l'ID de révision reste le même entre les appels, cela signifie que la présentation n'a pas été modifiée. Inversement, un changement d'identifiant (pour la même présentation et la même personne) signifie généralement que la présentation a été mise à jour. Toutefois, la modification d'un identifiant peut également être due à des facteurs internes, tels que des modifications du format de l'identifiant. |
notesMaster |
Masque de notes dans la présentation. Elle remplit trois fonctions:
Le masque de notes est en lecture seule. |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Presentation
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
Pour en savoir plus, consultez le guide relatif aux autorisations.