REST Resource: presentations.pages

Ressource : Page

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 d'objet pour 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 affichés sur la page.
revisionId

string

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 opaque. Le format de l'ID de révision peut changer au fil du temps. 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.
pageProperties

object (PageProperties)

Propriétés de la page.
Champ d'union properties. Propriétés spécifiques à chaque type de page. Les 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 aux diapositives. Défini uniquement si "pageType" = DIAPOSITIVE.
layoutProperties

object (LayoutProperties)

Propriétés spécifiques à la mise en page. Défini uniquement si "pageType" = mise en page.
notesProperties

object (NotesProperties)

Propriétés spécifiques de Notes. Défini uniquement si pageType = NOTES.
masterProperties

object (MasterProperties)

Propriétés spécifiques au maître. Défini uniquement si pageType = MASTER.

PageType

Type de page.

Enums
SLIDE Une page de diapositives.
MASTER Une page de présentation principale.
LAYOUT Une page de mise en page.
NOTES Une page de notes.
NOTES_MASTER Une page maître de 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 se trouve pas dans un groupe, sa transformation absolue est identique à la valeur dans ce champ.

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

string

Titre de l'élément de page. Associé à une description pour afficher un texte alternatif.

Ce champ n'est pas compatible avec les éléments Group.
description

string

Description de l'élément de page. Il est associé au titre pour afficher un texte alternatif.

Ce champ n'est pas compatible avec les éléments Group.
Champ d'union element_kind. Type d'élément représenté par cet élément PageElement. Chaque message contient 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 réunis en une seule unité.
shape

object (Shape)

Forme générique.
image

object (Image)

Élément de page d'images.
video

object (Video)

Un élément de page vidéo.
line

object (Line)

Un élément de page de ligne.
table

object (Table)

Élément de page du tableau.
wordArt

object (WordArt)

Élément de page Word Art.
sheetsChart

object (SheetsChart)

Graphique associé intégré à partir de Google Sheets. Les graphiques dissociés sont représentés par des images.
speakerSpotlight

object (SpeakerSpotlight)

Espace pour l'intervenant.

Groupe

Genre PageElement représentant une collection jointe de PageElements.

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

object (PageElement)

Ensemble d'éléments dans le groupe. La taille minimale d'un groupe est de 2.

WordArt

Type PageElement représentant le texte Word Art.

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

string

Texte affiché sous forme de texte Word Art.

SpeakerSpotlight

Type PageElement représentant un espace pour l'intervenant.

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)

Plan de la vidéo du présentateur. Si cette règle n'est pas configurée, elle n'a pas de contour.
shadow

object (Shadow)

L'ombre de la vidéo du présentateur. S'il n'est pas défini, il n'a pas d'ombre.

SlideProperties

Les propriétés de Page qui ne sont pertinentes que pour les pages dont le type de page est Diapositive.

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

string

ID d'objet de la mise en page sur laquelle se base cette diapositive. Cette propriété est en lecture seule.
masterObjectId

string

ID d'objet du maître sur lequel se base cette diapositive. Cette propriété est en lecture seule.
notesPage

object (Page)

Page de notes à laquelle cette diapositive est associée. Il 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 de commentaires contient les commentaires du présentateur pour cette diapositive. L'ID de cette forme est identifié par le champ speakerNotesObjectId. La page de commentaires est en lecture seule, à l'exception du contenu textuel et des styles de la forme des commentaires du présentateur. 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 type de page est MISE EN PAGE.

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

string

ID d'objet de l'annonce maître sur laquelle cette mise en page est basée.
name

string

Nom de la mise en page.
displayName

string

Nom de la mise en page dans un format lisible.

NotesProperties

Propriétés de Page qui ne sont pertinentes que pour les pages dont le type de page (pageType) NOTES.

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

string

ID de l'objet de la forme sur cette page de commentaires qui contient les commentaires du présentateur pour la diapositive correspondante. La forme réelle n'existe pas toujours sur la page de 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 identifiant 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 règle n'est pas configurée, le remplissage de l'arrière-plan est hérité de la page parente, le cas échéant. Si la page n'a pas de parent, le remplissage de l'arrière-plan est défini par défaut sur le remplissage correspondant dans l'éditeur Slides.
colorScheme

object (ColorScheme)

Jeu de couleurs de la page. Si cette règle n'est pas configurée, le jeu de couleurs est hérité de la page parente. Si la page n'a pas de parent, le jeu de couleurs utilise celui de Slides par défaut, qui correspond aux valeurs par défaut de l'éditeur Slides.

Seules les couleurs concrètes des 12 premières 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 les mappages des 12 premiers ThemeColorTypes avec leurs couleurs concrètes. Les couleurs des ThemeColorTypes restants seront ignorées.

PageBackgroundFill

Remplissage d'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 remplacé par RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour ne pas indiquer de remplissage 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 par couleur unie.
stretchedPictureFill

object (StretchedPictureFill)

Remplissage de l'image étiré.

StretchedPictureFill

Remplissage de l'image étirée. La page ou l'élément de la 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

Lire l'élément contentUrl:

URL d'une image ayant une durée de vie par défaut de 30 minutes. Cette URL est associée au compte du demandeur. Toute personne disposant de l'URL accède effectivement à la photo en tant que demandeur initial. L'accès à l'image risque d'être perdu si les paramètres de partage de la présentation sont modifiés.

Écrivez le contenu d'URL:

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.

La longueur de 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 les 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 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 miniature.