REST Resource: presentations.pages

Ressource : Page

Une page d'une présentation.

Représentation JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Champs
objectId

string

ID de l'objet de cette page. Les ID d'objet utilisés par Page et PageElement partagent le même espace de noms.
pageType

enum (PageType)

Type de page.
pageElements[]

object (PageElement)

Éléments de la page affichés sur la page.
revisionId

string

Uniquement en sortie. ID de la révision de la présentation. Peut être utilisé 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. Champ renseigné uniquement si l'utilisateur est autorisé à modifier la présentation.

L'ID de révision n'est pas un numéro séquentiel, mais une chaîne opaque. Le format de l'ID de révision peut changer au fil du temps. Un ID de révision renvoyé n'est valide que pendant 24 heures après son renvoi et ne peut pas être partagé entre les utilisateurs. Si l'ID de révision n'est pas modifié entre les appels, cela signifie que la présentation n'a pas été modifiée. À l'inverse, un ID modifié (pour la même présentation et le même utilisateur) signifie généralement que la présentation a été mise à jour. Toutefois, un ID modifié peut également être dû à des facteurs internes, tels que des changements de format de l'ID.
pageProperties

object (PageProperties)

Propriétés de la page.
Champ d'union properties. Propriétés spécifiques à chaque type de page. Les créations maîtres ne nécessitent aucune propriété supplémentaire. properties ne peut être qu'un des éléments suivants :
slideProperties

object (SlideProperties)

Propriétés spécifiques à la diapositive. Défini uniquement si pageType = Slide.
layoutProperties

object (LayoutProperties)

Propriétés spécifiques à la mise en page. Ne doit être défini que si pageType = LAYOUT.
notesProperties

object (NotesProperties)

Remarques sur des propriétés spécifiques. Ne doit être défini que si pageType = NOTES.
masterProperties

object (MasterProperties)

Maîtrisez des propriétés spécifiques. Ne doit être défini que si pageType = MASTER.

PageType

Type de page.

Enums
SLIDE Une page de diapositive.
MASTER Une page de diapositive principale.
LAYOUT Une page de mise en page.
NOTES Page de notes.
NOTES_MASTER Page principale des notes.

PageElement

Élément visuel affiché sur une page.

Représentation JSON 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
Champs
objectId

string

ID d'objet pour cet élément de page. Les ID d'objet utilisés par google.apps.slides.v1.Page et google.apps.slides.v1.PageElement partagent le même espace de noms.
size

object (Size)

Taille de l'élément de page.
transform

object (AffineTransform)

Transformation de l'élément de page.

L'apparence visuelle de l'élément de page est déterminée par sa transformation absolue. Pour calculer la transformation absolue, préconcaténez la transformation d'un élément de page avec les transformations de tous ses groupes parents. Si l'élément de page ne fait pas partie d'un groupe, sa transformation absolue est identique à la valeur de ce champ.

La transformation initiale de l'Group nouvellement créée est toujours la transformation d'identité.
title

string

Titre de l'élément de page. Combiné à la description pour afficher le texte alternatif.

Ce champ n'est pas disponible pour les éléments Group.
description

string

Description de l'élément de page. Combiné au titre pour afficher le texte alternatif.

Ce champ n'est pas disponible pour les éléments Group.
Champ d'union element_kind. Type d'élément représenté par cet élément PageElement. Chaque message contient toutes les propriétés spécifiques à ce type d'élément de page. element_kind ne peut être qu'un des éléments suivants :
elementGroup

object (Group)

Ensemble d'éléments de page joints en une seule unité.
shape

object (Shape)

Forme générique.
image

object (Image)

Élément de page d'image.
video

object (Video)

Élément de page vidéo.
line

object (Line)

Élément de page de ligne.
table

object (Table)

Un élément de page de tableau.
wordArt

object (WordArt)

Élément de page Word Art.
sheetsChart

object (SheetsChart)

Graphique associé intégré à partir de Google Sheets Les graphiques non associés sont représentés sous forme d'images.
speakerSpotlight

object (SpeakerSpotlight)

Espace pour l'intervenant

Groupe

Type PageElement représentant une collection jointe de PageElements.

Représentation JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Champs
children[]

object (PageElement)

Collection d'éléments du groupe. La taille minimale d'un groupe est de 2.

WordArt

Type PageElement représentant une typographie artistique.

Représentation JSON 
{
  "renderedText": string
}
Champs
renderedText

string

Texte affiché au format Word Art.

SpeakerSpotlight

Type PageElement représentant une vidéo du présentateur.

Représentation JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Champs
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Propriétés de la vidéo du présentateur.

SpeakerSpotlightProperties

Propriétés de SpeakerSpotlight.

Représentation JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Champs
outline

object (Outline)

Contour de l'espace pour l'intervenant. Si cette règle n'est pas configurée, elle n'a pas de contour.
shadow

object (Shadow)

Ombre de l'espace pour l'intervenant. Si elle n'est pas définie, aucune ombre n'est appliquée.

SlideProperties

Propriétés de Page qui ne sont pertinentes que pour les pages dont le paramètre "pageType" est défini sur "SLIDE".

Représentation JSON 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Champs
layoutObjectId

string

ID de l'objet de la mise en page sur laquelle cette diapositive est basée. Cette propriété est en lecture seule.
masterObjectId

string

ID de l'objet du modèle sur lequel cette diapositive est basée. Cette propriété est en lecture seule.
notesPage

object (Page)

Page de notes associée à cette diapositive. Elle définit l'apparence visuelle d'une page de notes lorsque vous imprimez ou exportez des diapositives contenant les commentaires du présentateur. Une page de notes hérite des propriétés de notes master. La forme d'espace réservé de type BODY sur la page des notes contient les notes du présentateur pour cette diapositive. L'ID de cette forme est identifié par le champ speakerNotesObjectId. La page des notes est en lecture seule, sauf pour le contenu textuel et les styles de la forme des notes du conférencier. Cette propriété est en lecture seule.
isSkipped

boolean

Indique si la diapositive est ignorée en mode Présentation. Valeur par défaut : "false".

LayoutProperties

Les propriétés de Page ne sont pertinentes que pour les pages dont le paramètre pageType est LAYOUT.

Représentation JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Champs
masterObjectId

string

ID de l'objet du modèle sur lequel cette mise en page est basée.
name

string

Nom de la mise en page.
displayName

string

Nom lisible de la mise en page.

NotesProperties

Propriétés de Page qui ne sont pertinentes que pour les pages avec pageType NOTES.

Représentation JSON 
{
  "speakerNotesObjectId": string
}
Champs
speakerNotesObjectId

string

ID de l'objet de la forme de cette page de notes qui contient les notes de l'orateur pour la diapositive correspondante. Il est possible que la forme réelle n'existe pas toujours sur la page des notes. Si vous insérez du texte à l'aide de cet ID d'objet, la forme sera automatiquement créée. Dans ce cas, la forme réelle peut avoir un ID d'objet différent. L'action presentations.get ou pages.get renvoie toujours le dernier ID d'objet.

MasterProperties

Propriétés de Page qui ne sont pertinentes que pour les pages dont le type de page est "MASTER".

Représentation JSON 
{
  "displayName": string
}
Champs
displayName

string

Nom lisible du maître.

PageProperties

Propriétés de Page.

La page héritera des propriétés de la page parente. Selon le type de page, la hiérarchie est définie dans SlideProperties ou LayoutProperties.

Représentation JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Champs
pageBackgroundFill

object (PageBackgroundFill)

Remplissage de l'arrière-plan de la page. Si cette valeur n'est pas définie, la couleur de remplissage de l'arrière-plan est héritée d'une page parente, le cas échéant. Si la page n'a pas de parent, la couleur de remplissage de l'arrière-plan est définie par défaut sur celle correspondante dans l'éditeur de diapositives.
colorScheme

object (ColorScheme)

Jeu de couleurs de la page. Si ce paramètre n'est pas défini, le jeu de couleurs est hérité d'une page parente. Si la page n'a pas de parent, le jeu de couleurs utilise un jeu de couleurs Slides par défaut, qui correspond aux valeurs par défaut de l'éditeur Slides.

Seules les couleurs concrètes des 12 premiers ThemeColorType sont modifiables. De plus, seul le jeu de couleurs des pages Master peut être mis à jour. Pour mettre à jour le champ, vous devez fournir un jeu de couleurs contenant des mappages de tous les 12 premiers ThemeColorTypes vers leurs couleurs concrètes. Les couleurs des autres ThemeColorTypes seront ignorées.

PageBackgroundFill

Remplissage de l'arrière-plan de la page.

Représentation JSON 
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Champs
propertyState

enum (PropertyState)

État de la propriété de remplissage de l'arrière-plan.

Si vous modifiez le remplissage d'une page, ce champ sera implicitement défini sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour qu'aucune zone ne soit remplie sur une page, définissez ce champ sur NOT_RENDERED. Dans ce cas, tous les autres champs de remplissage définis dans la même requête seront ignorés.
Champ d'union kind. Type de remplissage de l'arrière-plan. kind ne peut être qu'un des éléments suivants :
solidFill

object (SolidFill)

Remplissage de couleur unie.
stretchedPictureFill

object (StretchedPictureFill)

Remplissage étirés de l'image.

StretchedPictureFill

Remplissage de l'image étirée. La page ou l'élément de page est entièrement rempli avec l'image spécifiée. L'image est étirée pour s'adapter à son conteneur.

Représentation JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Champs
contentUrl

string

Lecture de contentUrl:

URL d'une image dont la durée de vie par défaut est de 30 minutes. Cette URL est taguée avec le compte de la personne à l'origine de la demande. Toute personne disposant de l'URL accède à l'image en tant que demandeur d'origine. L'accès à l'image peut être perdu si les paramètres de partage de la présentation changent.

Écrire l'élément contentUrl:

L'image est récupérée une fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.

L'URL fournie ne doit pas dépasser 2 ko.
size

object (Size)

Taille d'origine du remplissage de l'image. Ce champ est en lecture seule.

ColorScheme

Palette de couleurs prédéfinies pour une page.

Représentation JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Champs
colors[]

object (ThemeColorPair)

ThemeColorType et paires de couleurs concrètes correspondantes.

ThemeColorPair

Paire mappant un type de couleur de thème à la couleur concrète qu'il représente.

Représentation JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Champs
type

enum (ThemeColorType)

Type de la couleur du thème.
color

object (RgbColor)

Couleur concrète correspondant au type de couleur du thème ci-dessus.

Méthodes

get

 Récupère la dernière version de la page spécifiée dans la présentation.

getThumbnail

 Génère une vignette de la dernière version de la page spécifiée dans la présentation et renvoie une URL vers l'image de vignette.