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. Identifiant de révision de la présentation. Peut être utilisé dans les demandes 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. Valeur renseignée 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 valide que pendant 24 heures après son renvoi et ne peut pas être partagé entre plusieurs utilisateurs. Si l'ID de révision n'a pas changé entre les appels, cela signifie que la présentation n'a pas été modifiée. Inversement, 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 changement d'identifiant peut aussi être dû à des facteurs internes tels que des changements de format.

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 de la diapositive. Défini uniquement si pageType = SLIDE.

layoutProperties

object (LayoutProperties)

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

notesProperties

object (NotesProperties)

Notez les propriétés spécifiques. Défini uniquement si pageType = NOTES.

masterProperties

object (MasterProperties)

Maîtriser des propriétés spécifiques Défini uniquement si pageType = MASTER.

Type de page

Type de page.

Enums
SLIDE Une page de diapositives.
MASTER Page de la diapositive maître.
LAYOUT Une page de mise en page
NOTES Une page de commentaires
NOTES_MASTER Page principale des notes

Élément de page

É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)
  }
  // End of list of possible types for union field element_kind.
}
Champs
objectId

string

ID de l'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, 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 du nouveau Group est toujours la transformation d'identité.

title

string

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

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

description

string

Description de l'élément de page. Associé au titre pour afficher le 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 des 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 rassemblés en une seule unité.

shape

object (Shape)

Forme générique.

image

object (Image)

Élément d'une page d'image.

video

object (Video)

Élément de page vidéo.

line

object (Line)

Un élément de page.

table

object (Table)

Élément de page de tableau.

wordArt

object (WordArt)

Élément de page Word Art.

sheetsChart

object (SheetsChart)

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

Groupe

Un genre PageElement représentant une collection jointe d'éléments PageElements.

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

object (PageElement)

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

WordArt

Un genre PageElement représentant le texte Word Art.

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

string

Texte affiché sous forme de texte Word Art.

Propriétés de la diapositive

Propriétés de Page qui ne sont pertinentes que pour les pages avec la page SLIDE.

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 cette diapositive est basée. Cette propriété est en lecture seule.

masterObjectId

string

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

notesPage

object (Page)

Page de commentaires associée à cette diapositive. Elle définit l'apparence visuelle d'une page de commentaires lorsque vous imprimez ou exportez des diapositives avec les commentaires du présentateur. Une page de notes hérite des propriétés de notes master. La forme de l'espace réservé avec le 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 texte 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 (Propriétés de mise en page)

Les propriétés de Page ne sont pertinentes que pour les pages avec le type de page LAYOUT.

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

string

ID d'objet du maître 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.

Propriétés Notes

Propriétés de Page qui ne sont pertinentes que pour les pages avec le type pageNOTES.

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

string

ID d'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 commentaires. L'insertion de texte à l'aide de cet ID d'objet crée automatiquement la forme. 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.

Propriétés principales

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

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

string

Nom lisible du maître.

Propriétés de la page

Propriétés de Page.

La page hérite 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 en arrière-plan de la page. Si cette règle n'est pas configurée, le remplissage d'arrière-plan est hérité d'une page parente, le cas échéant. Si la page n'a pas de parent, le remplissage d'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é d'une page parente. Si la page n'a pas de parent, le jeu de couleurs est défini par défaut avec les couleurs de l'éditeur Slides.

Seules les couleurs concrètes des 12 premières ThemeColorType peuvent être modifiées. En outre, seule la palette de couleurs des pages Master peut être mise à jour. Pour mettre à jour le champ, vous devez fournir un jeu de couleurs contenant les mappages des 12 premiers ThemeColorTypes vers leur couleur concrète. Les couleurs associées aux autres ThemeColorTypes seront ignorées.

Arrière-planPage

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 en arrière-plan.

Si vous mettez à jour le remplissage sur 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 qu'une page ne puisse pas être renseignée, 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 d'arrière-plan. kind ne peut être qu'un des éléments suivants :
solidFill

object (SolidFill)

Couleur de remplissage unie.

stretchedPictureFill

object (StretchedPictureFill)

Remplissage de la photo étiré

Portraits étendus

Le remplissage de l'image étirée. La page ou l'élément de page sont entièrement remplis avec l'image spécifiée. L'image est étirée pour tenir dans son conteneur.

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

string

Lire l'élément 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 du demandeur. Toute personne disposant de l'URL peut accéder à l'image en tant que demandeur d'origine. Si les paramètres de partage de la présentation changent, vous risquez de perdre l'accès à cette image.

Écrire l'URL 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 photos doivent être inférieures à 50 Mo, ne doivent pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.

L'URL fournie ne peut pas dépasser 2 Ko.

size

object (Size)

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

Schéma de couleur

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.

Paire de couleurs du thème

Paire qui associe 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 du béton 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.