Requests

Demande

Un seul type de mise à jour à appliquer à une présentation.

Représentation JSON 
{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}
Champs
Champ d'union kind. Type de mise à jour. Un seul champ est obligatoire. kind ne peut être que l'un des éléments suivants:
createSlide

object (CreateSlideRequest)

Crée une diapositive.

createShape

object (CreateShapeRequest)

Crée une forme.

createTable

object (CreateTableRequest)

Crée une table.

insertText

object (InsertTextRequest)

Insère du texte dans une cellule de forme ou de tableau.

insertTableRows

object (InsertTableRowsRequest)

Insère des lignes dans une table.

insertTableColumns

object (InsertTableColumnsRequest)

Insère des colonnes dans une table.

deleteTableRow

object (DeleteTableRowRequest)

Supprime une ligne d'une table.

deleteTableColumn

object (DeleteTableColumnRequest)

Supprime une colonne d'une table.

replaceAllText

object (ReplaceAllTextRequest)

Remplace toutes les instances du texte spécifié.

deleteObject

object (DeleteObjectRequest)

Supprime une page ou un élément de page de la présentation.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Met à jour la transformation d'un élément de page.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Met à jour la position d'un ensemble de diapositives dans la présentation.

deleteText

object (DeleteTextRequest)

Supprime le texte d'une forme ou d'une cellule du tableau.

createImage

object (CreateImageRequest)

Crée une image.

createVideo

object (CreateVideoRequest)

crée une vidéo ;

createSheetsChart

object (CreateSheetsChartRequest)

Crée un graphique Google Sheets intégré.

createLine

object (CreateLineRequest)

Crée une ligne.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Actualise un graphique Google Sheets.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Met à jour les propriétés d'un Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Met à jour les propriétés d'un Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Met à jour les propriétés d'un Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Met à jour les propriétés d'un Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Met à jour les propriétés d'un TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Met à jour les propriétés d'un Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

crée des puces pour les paragraphes.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Remplace toutes les formes correspondant à certains critères par une image.

duplicateObject

object (DuplicateObjectRequest)

Dupliquer une diapositive ou un élément de page.

updateTextStyle

object (UpdateTextStyleRequest)

Met à jour le style du texte dans un élément Shape ou Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Remplace toutes les formes correspondant à certains critères par un graphique Google Sheets.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Supprime les puces des paragraphes.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Met à jour le style des paragraphes dans un élément Shape ou Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Met à jour les propriétés des bordures du tableau dans un Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Met à jour les propriétés d'une colonne Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Met à jour les propriétés d'une ligne Table.

mergeTableCells

object (MergeTableCellsRequest)

Fusionne les cellules d'une Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Défusionne les cellules d'un Table.

groupObjects

object (GroupObjectsRequest)

Regroupe les objets, tels que les éléments de page.

ungroupObjects

object (UngroupObjectsRequest)

Dégroupe les objets, tels que groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Met à jour le titre et/ou la description du texte alternatif d'un page element.

replaceImage

object (ReplaceImageRequest)

Remplace une image existante par une nouvelle.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Met à jour les propriétés d'une diapositive

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Met à jour l'ordre Z de page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Met à jour la catégorie d'un line.

rerouteLine

object (RerouteLineRequest)

Réachemine une line de sorte qu'elle soit connectée aux deux sites de connexion les plus proches sur les éléments de la page connectée.

Créer une SlideRequest

Crée une diapositive.

Représentation JSON 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID doit être comprise entre 5 et 50 caractères.

Si vous ne spécifiez pas d'ID, un identifiant unique est généré.

insertionIndex

integer

Index facultatif basé sur zéro indiquant où insérer les diapositives.

Si vous ne spécifiez pas d'index, la diapositive est créée à la fin.

slideLayoutReference

object (LayoutReference)

Référence de mise en page de la diapositive à insérer, en fonction de la maître actuelle, qui correspond à l'un des suivants:

  • Masque de l'index de diapositive précédent.
  • Masque de la première diapositive, si l'insertion de l'index est nulle.
  • Le premier masque de la présentation s'il n'y a pas de diapositive.

Si la mise en page est introuvable dans le maître actuel, une erreur 400 de requête incorrecte est renvoyée.

Si vous ne spécifiez pas de référence de mise en page, la diapositive utilise la mise en page BLANK prédéfinie.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Liste facultative de mappages d'ID d'objets à partir des placeholder sur la mise en page et des espaces réservés créés sur la diapositive à partir de la mise en page spécifiée. Ne peut être utilisé que lorsque slideLayoutReference est spécifié.

Référence de mise en page

Référence de mise en page de la diapositive. Il peut faire référence à:

  • Une mise en page prédéfinie
  • Une des mises en page de la présentation.
Représentation JSON 
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
Champs
Champ d'union kind. Type de LayoutReference. kind ne peut être que l'un des éléments suivants:
predefinedLayout

enum (PredefinedLayout)

Mise en page prédéfinie.

layoutId

string

ID de mise en page: l'ID d'objet de l'une des mises en page présentes dans la présentation.

Mise en page prédéfinie

Types de mise en page prédéfinis. Ces mises en page sont courantes dans les présentations. Toutefois, rien ne garantit que ces mises en page seront présentes dans le masque actuel, car elles auraient pu être supprimées ou faire partie du thème utilisé. De plus, les espaces réservés de chaque mise en page peuvent avoir été modifiés.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED Mise en page non spécifiée.
BLANK Mise en page vide, sans espaces réservés.
CAPTION_ONLY Mise en page avec une légende en bas.
TITLE Mise en page avec un titre et un sous-titre.
TITLE_AND_BODY Mise en page avec titre et corps.
TITLE_AND_TWO_COLUMNS Mise en page avec un titre et deux colonnes.
TITLE_ONLY Mise en page avec seulement un titre.
SECTION_HEADER Mise en page avec titre de section.
SECTION_TITLE_AND_DESCRIPTION Mise en page avec un titre et un sous-titre d'un côté et une description de l'autre.
ONE_COLUMN_TEXT Mise en page avec un titre et un corps, disposée dans une seule colonne.
MAIN_POINT Mise en page avec un point principal.
BIG_NUMBER Mise en page avec un en-tête comportant un grand nombre.

LayoutPlaceholderIdMapping

Mappage d'ID spécifié par l'utilisateur pour un espace réservé qui sera créé sur une diapositive à partir d'une mise en page spécifiée.

Représentation JSON 
{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur pour l'espace réservé identifié ci-dessus et à créer sur une diapositive.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50.

Si vous ne spécifiez pas d'ID, un identifiant unique est généré.

Champ d'union kind. Genre permettant d'identifier un espace réservé dans une mise en page. kind ne peut être que l'un des éléments suivants:
layoutPlaceholder

object (Placeholder)

Espace réservé sur une mise en page qui sera appliquée à une diapositive. Seuls type et index sont nécessaires. Par exemple, une mise en page TITLE_AND_BODY prédéfinie peut généralement avoir un espace réservé TITLE avec l'index 0 et un espace réservé BODY avec l'index 0.

layoutPlaceholderObjectId

string

ID d'objet de l'espace réservé dans une mise en page qui sera appliquée à une diapositive.

CreateShapeRequest

Crée une forme.

Représentation JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50. Si ce champ est vide, un identifiant unique est généré.

elementProperties

object (PageElementProperties)

Propriétés de l'élément pour la forme.

shapeType

enum (Type)

Type de forme

Propriétés de l'élément de page

Propriétés courantes d'un élément de page.

Remarque: Lorsque vous créez un PageElement, l'API peut modifier les valeurs de size et de transform, mais la taille visuelle n'est pas modifiée.

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

string

ID d'objet de la page où se trouve l'élément.

size

object (Size)

Taille de l'élément.

transform

object (AffineTransform)

Transformation de l'élément.

CreateTableRequest

Crée une table.

Représentation JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50.

Si vous ne spécifiez pas d'ID, un identifiant unique est généré.

elementProperties

object (PageElementProperties)

Propriétés de l'élément du tableau.

Le tableau sera créé à la taille indiquée, en respectant une taille minimale. Si aucune taille n'est définie, la taille du tableau est automatiquement définie.

Les transformations de table doivent avoir une échelle de 1, et aucun composant de cisaillement. Si aucune transformation n'est fournie, la table est centrée sur la page.

rows

integer

Nombre de lignes dans la table.

columns

integer

Nombre de colonnes dans la table.

Insérer une requête textuelle

Insère du texte dans une forme ou une cellule de tableau.

Représentation JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
Champs
objectId

string

ID d'objet de la forme ou du tableau où le texte sera inséré

cellLocation

object (TableCellLocation)

L'emplacement facultatif de la cellule du tableau si le texte doit être inséré dans une cellule du tableau. S'il est présent, l'objet objectId doit faire référence à une table.

text

string

Texte à insérer.

L'insertion d'un caractère de nouvelle ligne crée implicitement un nouveau ParagraphMarker au niveau de cet index. Le style du nouveau paragraphe, qui inclut les listes et les puces, est copié depuis le paragraphe à l'index d'insertion actuel.

Les styles de texte du texte inséré sont déterminés automatiquement, en conservant généralement le style du texte voisin. Dans la plupart des cas, le texte est ajouté au TextRun existant au niveau de l'index d'insertion.

Certains caractères de contrôle (U+0000-U+0008, U+000C-U+001F) et les caractères de la zone d'utilisation privée Unicode de base multilingue (U+E000-U+F8FF) seront supprimés du texte inséré.

insertionIndex

integer

Index dans lequel le texte sera inséré, en unités de code Unicode, en fonction des index TextElement.

L'index est basé sur zéro et est calculé à partir du début de la chaîne. L'index peut être ajusté pour empêcher les insertions dans des clusters de graphismes Unicode. Dans ce cas, le texte est inséré immédiatement après le groupe de graphiques.

Insérer TableTablesRequest

Insère des lignes dans une table.

Représentation JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
Champs
tableObjectId

string

Tableau dans lequel insérer des lignes.

cellLocation

object (TableCellLocation)

Emplacement de la cellule du tableau de référence à partir duquel les lignes seront insérées.

Une nouvelle ligne sera insérée au-dessus (ou en dessous) de la ligne dans laquelle se trouve la cellule de référence. Si la cellule de référence est une cellule fusionnée, une nouvelle ligne sera insérée au-dessus (ou en dessous) de la cellule fusionnée.

insertBelow

boolean

Permet d'insérer de nouvelles lignes sous l'emplacement de la cellule de référence.

  • True : insérer sous la cellule.
  • False : insérer au-dessus de la cellule.
number

integer

Nombre de lignes à insérer. 20 maximum par requête.

Insérer TableColumnRequest

Insère des colonnes dans une table.

Les autres colonnes du tableau sont redimensionnées pour s'adapter à la nouvelle colonne.

Représentation JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
Champs
tableObjectId

string

Tableau dans lequel insérer des colonnes.

cellLocation

object (TableCellLocation)

Emplacement de la cellule du tableau de référence à partir duquel les colonnes seront insérées.

Une nouvelle colonne sera insérée à gauche (ou à droite) de la colonne contenant la cellule de référence. Si la cellule de référence est une cellule fusionnée, une nouvelle colonne sera insérée à gauche (ou à droite) de la cellule fusionnée.

insertRight

boolean

Permet d'insérer de nouvelles colonnes à droite de l'emplacement de la cellule de référence.

  • True : insérer à droite.
  • False : insérer à gauche.
number

integer

Nombre de colonnes à insérer. 20 maximum par requête.

DeleteTableRowRequest

Supprime une ligne d'une table.

Représentation JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Champs
tableObjectId

string

Tableau à partir duquel les lignes doivent être supprimées.

cellLocation

object (TableCellLocation)

Emplacement de la cellule du tableau de référence dans lequel une ligne sera supprimée.

La ligne couverte par cette cellule sera supprimée. S'il s'agit d'une cellule fusionnée, plusieurs lignes seront supprimées. S'il ne reste aucune ligne dans la table après cette suppression, la table entière sera supprimée.

DeleteTableColumnRequest

Supprime une colonne d'une table.

Représentation JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Champs
tableObjectId

string

Tableau à partir duquel les colonnes doivent être supprimées.

cellLocation

object (TableCellLocation)

Emplacement de la cellule du tableau de référence dans lequel une colonne sera supprimée.

La colonne qui couvre cette cellule sera supprimée. S'il s'agit d'une cellule fusionnée, plusieurs colonnes seront supprimées. S'il ne reste aucune colonne dans la table après la suppression, la table entière sera supprimée.

Remplacer AllTextRequest

Remplace toutes les instances de texte correspondant à un critère par replace text.

Représentation JSON 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Champs
replaceText

string

Texte qui remplacera le texte correspondant.

pageObjectIds[]

string

Si ce champ n'est pas vide, la correspondance se limite aux éléments de page des pages données.

Renvoie une erreur de requête "400" incorrecte si l'ID d'objet de page notes master est présent ou si une page avec cet ID d'objet n'existe pas dans la présentation.

Champ d'union criteria. Critères utilisés pour faire correspondre le texte à remplacer. criteria ne peut être que l'un des éléments suivants:
containsText

object (SubstringMatchCriteria)

Recherche du texte dans une forme correspondant à cette sous-chaîne.

Sous-chaîne et critères

Critère correspondant à une chaîne de texte spécifique dans une forme ou un tableau.

Représentation JSON 
{
  "text": string,
  "matchCase": boolean
}
Champs
text

string

Texte à rechercher dans la forme ou le tableau.

matchCase

boolean

Indique si la recherche doit respecter la casse:

  • True : la recherche est sensible à la casse.
  • False : la recherche n'est pas sensible à la casse.

DeleteObjectRequest

Supprime un objet de la présentation (pages ou page elements).

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

string

ID d'objet de la page ou de l'élément de page à supprimer.

Si une group ne contient qu'un élément de page, ou aucun élément de page, le groupe est également supprimé.

Si un espace réservé est supprimé d'une mise en page, tout espace réservé hérité vide est également supprimé.

UpdatePageElementTransformRequest

Met à jour la transformation d'un élément de page.

La mise à jour de la transformation d'un groupe modifiera la transformation absolue des éléments de page de ce groupe, ce qui peut modifier leur apparence visuelle. Pour en savoir plus, consultez la documentation sur PageElement.transform.

Représentation JSON 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
Champs
objectId

string

ID d'objet de l'élément de page à mettre à jour.

transform

object (AffineTransform)

Matrice de transformation des entrées utilisée pour mettre à jour l'élément de page.

applyMode

enum (ApplyMode)

Mode d'application de la mise à jour de la transformation.

Mode d'application

Modes d'application de la mise à jour de la transformation.

Enums
APPLY_MODE_UNSPECIFIED Mode non spécifié.
RELATIVE Applique la nouvelle matrice AffineTransform à la matrice existante et la remplace par la concaténation qui en résulte.
ABSOLUTE Remplace la matrice AffineTransform existante par la nouvelle.

Mettre à jour SlidesPositionRequest

Met à jour la position des diapositives dans la présentation.

Représentation JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Champs
slideObjectIds[]

string

ID des diapositives à déplacer. Les diapositives de cette liste doivent être dans l'ordre des présentations, et non être en double.

insertionIndex

integer

Index dans lequel les diapositives doivent être insérées, en fonction de l'agencement des diapositives avant le déplacement. Doit être compris entre zéro et le nombre de diapositives incluses dans la présentation.

DeleteTextRequest

Supprime le texte d'une forme ou d'une cellule du tableau.

Représentation JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Champs
objectId

string

ID d'objet de la forme ou du tableau dans lequel le texte sera supprimé

cellLocation

object (TableCellLocation)

L'emplacement facultatif de la cellule du tableau si le texte doit être supprimé d'une cellule du tableau. S'il est présent, l'objet objectId doit faire référence à une table.

textRange

object (Range)

Plage de texte à supprimer, en fonction des index TextElement.

Il existe toujours un caractère de nouvelle ligne implicite à la fin du texte d'une forme ou d'une cellule de tableau. Il ne peut pas être supprimé. Range.Type.ALL utilise les limites appropriées, mais vous devez faire attention lorsque vous spécifiez des limites explicites pour les types de plage FROM_START_INDEX et FIXED_RANGE. Par exemple, si le texte est "ABC", suivi d'une nouvelle ligne implicite, la valeur maximale est de 2 pour textRange.start_index et de 3 pour textRange.end_index.

La suppression d'un texte qui dépasse les limites d'un paragraphe peut entraîner la modification des listes et des styles de paragraphe lorsque les deux paragraphes sont fusionnés.

Les plages qui ne comprennent qu'une seule unité de code d'une paire de substitution sont développées pour inclure les deux unités de code.

Plage

Spécifie une plage contiguë d'une collection indexée, comme des caractères de texte.

Représentation JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
Champs
startIndex

integer

Index facultatif basé sur zéro du début de la collection. Obligatoire pour les plages FIXED_RANGE et FROM_START_INDEX.

endIndex

integer

Index facultatif basé sur zéro de la fin de la collection. Obligatoire pour les plages FIXED_RANGE.

type

enum (Type)

Type de plage.

Type

Types de plages.

Enums
RANGE_TYPE_UNSPECIFIED Type de plage non spécifié. Cette valeur ne doit pas être utilisée.
FIXED_RANGE Plage fixe Vous devez spécifier les champs startIndex et endIndex.
FROM_START_INDEX Commence la plage le startIndex et se poursuit jusqu'à la fin de la collecte. Le endIndex ne doit pas être spécifié.
ALL Définit la plage sur toute la longueur de la collection. startIndex et endIndex ne doivent pas être spécifiés.

CreateImageRequest

Crée une image.

Représentation JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50.

Si vous ne spécifiez pas d'ID, un identifiant unique est généré.

elementProperties

object (PageElementProperties)

Propriétés de l'élément pour l'image.

Lorsque le format de l'image fournie ne correspond pas à celui de l'image, celle-ci est mise à l'échelle et centrée par rapport à la taille afin de conserver les proportions. La transformation fournie est appliquée après cette opération.

La propriété PageElementProperties.size est facultative. Si vous ne spécifiez pas la taille, la taille par défaut de l'image est utilisée.

La propriété PageElementProperties.transform est facultative. Si vous ne spécifiez pas de transformation, l'image est placée en haut à gauche de la page.

Champ d'union image_source. Type de source de l'image. image_source ne peut être que l'un des éléments suivants:
url

string

URL de l'image.

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 doit être accessible publiquement et ne pas dépasser 2 Ko. L'URL est enregistrée avec l'image et exposée via le champ Image.source_url.

CreateVideoRequest

crée une vidéo ;

REMARQUE: Pour créer une vidéo à partir de Google Drive, l'application à l'origine de la demande doit disposer d'au moins un des champs d'application Drive, drive.readonly ou drive.file.

Représentation JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50.

Si vous ne spécifiez pas d'ID, un identifiant unique est généré.

elementProperties

object (PageElementProperties)

Propriétés de l'élément pour la vidéo.

La propriété PageElementProperties.size est facultative. Si vous n'indiquez aucune taille, le serveur choisit une taille par défaut.

La propriété PageElementProperties.transform est facultative. La transformation ne doit pas comporter de composants de cisaillement. Si vous ne spécifiez pas de transformation, la vidéo est placée en haut à gauche de la page.

source

enum (Source)

Source de la vidéo.

id

string

Identifiant unique de la source vidéo pour cette vidéo.

Par exemple, pour la vidéo YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, l'ID est 7U3axjORYZ0. Pour une vidéo Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q l'ID est 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Pour accéder à un fichier vidéo Google Drive, vous devrez peut-être ajouter une clé de ressource à l'en-tête HTTP d'un sous-ensemble d'anciens fichiers. Pour en savoir plus, consultez la section Accéder aux fichiers partagés par lien à l'aide de clés de ressources.

CreateSheetsChartRequest

Crée un graphique Google Sheets intégré.

REMARQUE: La création de graphiques nécessite au moins l'une des feuilles de calcul Sheets.readonly, drive, drive.readonly, drive.file ou drive OAuth.

Représentation JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur.

S'il est spécifié, l'ID doit être unique parmi toutes les pages et tous les éléments de la présentation. L'ID doit commencer par le caractère [a-zA-Z0-9_], suivi d'un nombre quelconque des caractères suivants (a-zA-Z0-9_-:). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50. Si ce champ est vide, un identifiant unique est généré.

elementProperties

object (PageElementProperties)

Propriétés de l'élément du graphique.

Lorsque le format de l'image fournie ne correspond pas au format du graphique, celui-ci est mis à l'échelle et centré par rapport à la taille afin de conserver les proportions. La transformation fournie est appliquée après cette opération.

spreadsheetId

string

ID de la feuille de calcul Google Sheets contenant le graphique.

Vous devrez peut-être ajouter une clé de ressource à l'en-tête HTTP pour un sous-ensemble d'anciens fichiers. Pour en savoir plus, consultez la section Accéder aux fichiers partagés par lien à l'aide de clés de ressources.

chartId

integer

ID du graphique spécifique dans la feuille de calcul Google Sheets.

linkingMode

enum (LinkingMode)

Mode avec lequel le graphique est associé à la feuille de calcul source. Si aucune valeur n'est spécifiée, le graphique est une image qui n'est pas associée.

Mode d'association

Mode avec lequel le graphique est associé à la feuille de calcul source.

Enums
NOT_LINKED_IMAGE Le graphique n'est pas associé à la feuille de calcul source et ne peut pas être mis à jour. Un graphique qui n'est pas associé sera inséré en tant qu'image.
LINKED Associer le graphique permet de le mettre à jour, et les autres collaborateurs voient un lien vers la feuille de calcul.

CreateLineRequest

Crée une ligne.

Représentation JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50.

Si vous ne spécifiez pas d'ID, un identifiant unique est généré.

elementProperties

object (PageElementProperties)

Propriétés de l'élément de la ligne

lineCategory
(deprecated)

enum (Category)

Catégorie de la ligne à créer

Obsolète : utilisez category à la place.

Le line type exact créé est déterminé en fonction de la catégorie et de la manière dont il est acheminé pour se connecter à d'autres éléments de la page.

Si vous spécifiez à la fois un category et un lineCategory, le category est prioritaire.

category

enum (LineCategory)

Catégorie de la ligne à créer

Le line type exact créé est déterminé en fonction de la catégorie et de la manière dont il est acheminé pour se connecter à d'autres éléments de la page.

Si vous spécifiez à la fois un category et un lineCategory, le category est prioritaire.

Si vous ne spécifiez pas de valeur pour category, mais que vous spécifiez une valeur pour lineCategory, c'est la valeur lineCategory spécifiée qui est utilisée.

Si vous ne spécifiez pas non plus, STRAIGHT est utilisé.

Catégorie

Catégories de lignes.

Enums
STRAIGHT Connecteurs droits, y compris le connecteur droit 1 Il s'agit de la catégorie par défaut si aucune catégorie n'est spécifiée.
BENT Connecteurs pliés, y compris les connecteurs 2 à 5 pliés
CURVED Connecteurs incurvés, y compris les connecteurs incurvés 2 à 5

Actualiser SheetsChartRequest

Actualise un graphique Google Sheets intégré en le remplaçant par la dernière version de Google Sheets.

REMARQUE: Pour actualiser les graphiques, vous devez disposer d'au moins l'une des feuilles de calcul Sheets.readonly, drive, drive.readonly ou drive OAuth.

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

string

ID d'objet du graphique à actualiser.

UpdateShapePropertiesRequest

Mettez à jour les propriétés d'un Shape.

Représentation JSON 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la forme à laquelle les mises à jour sont appliquées.

shapeProperties

object (ShapeProperties)

Propriétés de la forme à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine shapeProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour la couleur de remplissage unie de l'arrière-plan de la forme, définissez fields sur "shapeBackgroundFill.solidFill.color".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

UpdateImagePropertiesRequest

Mettez à jour les propriétés d'un Image.

Représentation JSON 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de l'image à laquelle les mises à jour sont appliquées

imageProperties

object (ImageProperties)

Propriétés de l'image à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine imageProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour la couleur du contour de l'image, définissez fields sur "outline.outlineFill.solidFill.color".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

Mise à jour de la propriété VideoVideoProperties

Mettez à jour les propriétés d'un Video.

Représentation JSON 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la vidéo auquel les mises à jour sont appliquées.

videoProperties

object (VideoProperties)

Propriétés de la vidéo à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine videoProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour modifier la couleur du contour de la vidéo, définissez fields sur "outline.outlineFill.solidFill.color".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

UpdatePagePropertiesRequest

Met à jour les propriétés d'un Page.

Représentation JSON 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la page à laquelle la mise à jour est appliquée.

pageProperties

object (PageProperties)

Propriétés de la page à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine pageProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour la couleur de remplissage unie de l'arrière-plan de la page, définissez fields sur "pageBackgroundFill.solidFill.color".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

Mise à jour de la table CellPropertiesRequest

Mettez à jour les propriétés d'un TableCell.

Représentation JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la table.

tableRange

object (TableRange)

Plage de tables représentant le sous-ensemble de la table auquel les mises à jour sont appliquées. Si aucune plage de tables n'est spécifiée, les mises à jour s'appliquent à l'ensemble de la table.

tableCellProperties

object (TableCellProperties)

Propriétés de la cellule du tableau à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine tableCellProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour la couleur de remplissage unie de l'arrière-plan des cellules du tableau, définissez fields sur "tableCellBackgroundFill.solidFill.color".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

Plage de tables

Une plage de tables représente une référence à un sous-ensemble d'une table.

Il est important de noter que les cellules spécifiées par une plage de tableau ne forment pas nécessairement un rectangle. Par exemple, supposons que nous ayons une table trois x trois dans laquelle toutes les cellules de la dernière ligne sont fusionnées. Le tableau se présente comme suit: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Une plage de tableau avec l'emplacement = (0, 0), un span de ligne = 3 et un span de colonne = 2 spécifie les cellules suivantes: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
Représentation JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Champs
location

object (TableCellLocation)

Lieu de départ de la plage du tableau.

rowSpan

integer

Étendue de la plage de la table.

columnSpan

integer

L'étendue des colonnes de la plage du tableau.

UpdateLinePropertiesRequest

Met à jour les propriétés d'un Line.

Représentation JSON 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la ligne à laquelle la mise à jour est appliquée.

lineProperties

object (LineProperties)

Propriétés de la ligne à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine lineProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour la couleur de remplissage unie de la ligne, définissez fields sur "lineFill.solidFill.color".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

CreateParagraphBulletsRequest

Crée des puces pour tous les paragraphes qui se chevauchent dans la plage d'index de texte donnée.

Le niveau d'imbrication de chaque paragraphe est déterminé en comptabilisant les onglets devant chaque paragraphe. Pour éviter un excès d'espace entre la puce et le paragraphe correspondant, ces onglets sont supprimés. Cela peut avoir un impact sur l'index de parties du texte.

Si le paragraphe situé juste avant la mise à jour d'un paragraphe figure dans une liste avec un préréglage correspondant, il est ajouté à cette liste.

Représentation JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Champs
objectId

string

ID d'objet de la forme ou du tableau contenant le texte auquel les puces doivent être ajoutées.

cellLocation

object (TableCellLocation)

L'emplacement facultatif de la cellule du tableau si le texte à modifier se trouve dans une cellule du tableau. S'il est présent, l'objet objectId doit faire référence à une table.

textRange

object (Range)

Plage de texte à laquelle appliquer les préréglages de puce, en fonction des index TextElement.

bulletPreset

enum (BulletGlyphPreset)

Types de glyphes à puces. La valeur par défaut est BULLET_DISC_CIRCLE_SQUARE.

Préréglage pour BulletGlyphs

Modèles prédéfinis de glyphes à puces pour les listes dans le texte.

Ces modèles utilisent les puces suivantes:

  • ARROW : flèche, correspondant à un point de code Unicode U+2794
  • ARROW3D : flèche en ombrage 3D correspondant à un point de code Unicode U+27a2
  • CHECKBOX : carré vide correspondant à un point de code Unicode U+274f
  • CIRCLE : cercle vide correspondant à un point de code Unicode U+25cb
  • DIAMOND : losange fixe correspondant à un point de code Unicode U+25c6
  • DIAMONDX : losange avec une croix (x) correspondant à un point de code Unicode U+2756
  • HOLLOWDIAMOND : losange vide correspondant à un point de code Unicode U+25c7
  • DISC : cercle plein correspondant à un point de code Unicode U+25cf
  • SQUARE : carré plein correspondant à un point de code Unicode U+25a0
  • STAR : une étoile correspondant à un point de code Unicode U+2605
  • ALPHA : lettre minuscule, comme "a", "b" ou "c".
  • UPPERALPHA : lettre majuscule, comme "A", "B" ou "C".
  • DIGIT : nombre, tel que "1", "2" ou "3".
  • ZERODIGIT : nombre dont les chiffres à un seul préfixe sont précédés d'un zéro, comme "01", "02" ou "03". Les nombres comportant plusieurs chiffres ne sont pas précédés d'un zéro.
  • ROMAN : chiffre romain minuscule, comme "i", "ii" ou "iii".
  • UPPERROMAN : chiffre romain majuscule, comme "I", "II" ou "III".
  • LEFTTRIANGLE : triangle pointant vers la gauche, correspondant à un point de code Unicode U+25c4
Enums
BULLET_DISC_CIRCLE_SQUARE Une liste à puces contenant un glyphe à puces DISC, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de listes.
BULLET_DIAMONDX_ARROW3D_SQUARE Une liste à puces contenant un glyphe à puces DIAMONDX, ARROW3D et SQUARE pour les trois premiers niveaux d'imbrication de listes.
BULLET_CHECKBOX Liste à puces contenant CHECKBOX glyphes de puce pour tous les niveaux d'imbrication de listes.
BULLET_ARROW_DIAMOND_DISC Une liste à puces contenant un glyphe à puces ARROW, DIAMOND et DISC pour les trois premiers niveaux d'imbrication de listes.
BULLET_STAR_CIRCLE_SQUARE Une liste à puces contenant un glyphe à puces STAR, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de listes.
BULLET_ARROW3D_CIRCLE_SQUARE Une liste à puces contenant un glyphe à puces ARROW3D, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de listes.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Une liste à puces contenant un glyphe à puces LEFTTRIANGLE, DIAMOND et DISC pour les trois premiers niveaux d'imbrication de listes.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Une liste à puces contenant un glyphe à puces DIAMONDX, HOLLOWDIAMOND et SQUARE pour les trois premiers niveaux d'imbrication de listes.
BULLET_DIAMOND_CIRCLE_SQUARE Une liste à puces contenant un glyphe à puces DIAMOND, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de listes.
NUMBERED_DIGIT_ALPHA_ROMAN Une liste numérotée avec DIGIT, ALPHA et ROMAN glyphes numériques pour les trois premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Une liste numérotée avec DIGIT, ALPHA et ROMAN glyphes numériques pour les trois premiers niveaux d'imbrication de liste, suivis de parenthèses.
NUMBERED_DIGIT_NESTED Une liste numérotée avec DIGIT glyphes numériques séparés par un point, où chaque niveau d'imbrication utilise le glyphe du niveau d'imbrication précédent comme préfixe. Exemple: "1", '1.1.', '2', "2.2."
NUMBERED_UPPERALPHA_ALPHA_ROMAN Une liste numérotée avec UPPERALPHA, ALPHA et ROMAN glyphes numériques pour les trois premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Une liste numérotée avec UPPERROMAN, UPPERALPHA et DIGIT glyphes numériques pour les trois premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Une liste numérotée avec ZERODIGIT, ALPHA et ROMAN glyphes numériques pour les trois premiers niveaux d'imbrication de liste, suivis de points.

Remplacer AllShapesWithImageRequest

Remplace toutes les formes correspondant aux critères indiqués par l'image fournie.

Les images qui remplacent les formes sont rectangulaires après avoir été insérées dans la présentation et n'utilisent pas les formes.

Représentation JSON 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
Champs
replaceMethod
(deprecated)

enum (ReplaceMethod)

La méthode de remplacement.

Obsolète : utilisez imageReplaceMethod à la place.

Si vous spécifiez à la fois un replaceMethod et un imageReplaceMethod, le imageReplaceMethod est prioritaire.

imageReplaceMethod

enum (ImageReplaceMethod)

La méthode de remplacement de l'image.

Si vous spécifiez à la fois un replaceMethod et un imageReplaceMethod, le imageReplaceMethod est prioritaire.

Si vous ne spécifiez pas de valeur pour imageReplaceMethod, mais que vous spécifiez une valeur pour replaceMethod, c'est la valeur replaceMethod spécifiée qui est utilisée.

Si vous ne spécifiez aucune de ces valeurs, alors CENTER_INSIDE est utilisé.

pageObjectIds[]

string

Si ce champ n'est pas vide, la correspondance se limite aux éléments de page des pages données.

Renvoie une erreur 400 "Requête incorrecte" si l'ID d'objet de page notes page ou notes master est indiqué ou si une page avec cet ID d'objet n'existe pas dans la présentation.

Champ d'union criteria. Critères que les formes doivent correspondre pour être remplacées. criteria ne peut être que l'un des éléments suivants:
containsText

object (SubstringMatchCriteria)

Si cette valeur est définie, elle remplace toutes les formes contenant le texte donné.

Champ d'union image_source. Type de source de l'image. image_source ne peut être que l'un des éléments suivants:
imageUrl

string

URL de l'image.

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. L'URL elle-même est enregistrée avec l'image et exposée via le champ Image.source_url.

Méthode de remplacement

La méthode de remplacement.

Enums
CENTER_INSIDE Ajuste et centre l'image pour l'adapter aux contours de la forme d'origine tout en conservant les proportions. La taille d'affichage de l'image peut être inférieure à celle de la forme. Il s'agit de la méthode par défaut lorsque aucune n'est spécifiée.
CENTER_CROP Met l'image à l'échelle et centre pour remplir les contours de la forme d'origine. L'image peut être recadrée afin de remplir la forme. La taille d'affichage sera la même que celle de la forme d'origine.

ImageReplaceMethod

La méthode de remplacement de l'image.

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED Méthode de remplacement d'image non spécifiée. Cette valeur ne doit pas être utilisée.
CENTER_INSIDE Ajuste et centre l'image pour l'adapter aux contours de la forme d'origine tout en conservant les proportions. La taille d'affichage de l'image peut être inférieure à celle de la forme. Il s'agit de la méthode par défaut lorsque aucune n'est spécifiée.
CENTER_CROP Met l'image à l'échelle et centre pour remplir les contours de la forme d'origine. L'image peut être recadrée afin de remplir la forme. La taille d'affichage de l'image sera la même que celle d'origine.

Demande d'objet en double

Dupliquer une diapositive ou un élément de page.

Lors de la duplication d'une diapositive, la diapositive en double est créée immédiatement après la diapositive spécifiée. Lorsque vous dupliquez un élément de page, le doublon est placé sur la même page, à la même position que celle d'origine.

Représentation JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Champs
objectId

string

ID de l'objet à dupliquer.

objectIds

map (key: string, value: string)

L'objet dupliqué peut contenir d'autres objets, par exemple en dupliquant une diapositive ou un élément de page de groupe. Cette map définit la manière dont les ID des objets en double sont générés: les clés correspondent aux ID des objets d'origine et leurs valeurs aux ID qui seront attribués à l'objet en double correspondant. L'ID du doublon de l'objet source peut également être spécifié dans ce mappage, en utilisant la même valeur pour le champ objectId en tant que clé et le nouvel ID pour la valeur.

Toutes les clés doivent correspondre aux ID existants dans la présentation. Toutes les valeurs doivent être uniques dans la présentation et doivent commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur du nouvel ID ne doit pas être inférieure à 50.

Si des ID d'objets sources sont omis de la carte, un nouvel ID aléatoire est attribué. Si la carte est vide ou si elle n'est pas configurée, tous les objets en double recevront un nouvel ID aléatoire.

UpdateTextStyleRequest

Mettez à jour le style du texte dans une Shape ou une Table.

Représentation JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la forme ou du tableau avec le texte à styliser.

cellLocation

object (TableCellLocation)

Emplacement de la cellule dans le tableau contenant le texte à styliser. Si objectId fait référence à une table, cellLocation doit avoir une valeur. Sinon, il ne doit pas.

style

object (TextStyle)

Style(s) à définir sur le texte.

Si la valeur d'un style particulier correspond à celle du parent, le style hérité sera défini.

Certaines modifications de style du texte peuvent donner lieu à d'autres changements visant à refléter le comportement de l'éditeur Slides. Pour en savoir plus, consultez la documentation sur TextStyle.

textRange

object (Range)

Plage de texte à appliquer au style.

La plage peut être étendue pour inclure les retours à la ligne adjacents.

Si la plage contient entièrement un paragraphe appartenant à une liste, la puce du paragraphe est également mise à jour avec le style de texte correspondant.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine style est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre le style de texte en gras, définissez fields sur "bold".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

Remplacer AllShapesWithSheetsChartRequest

Remplace toutes les formes correspondant aux critères indiqués par le graphique Google Sheets fourni. Le graphique est mis à l'échelle et centré pour tenir dans les limites de la forme d'origine.

REMARQUE: Pour remplacer les formes par un graphique, vous devez disposer d'au moins une de feuilles de calcul Sheets.readonly, drive.readonly ou drive OAuth.

Représentation JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Champs
containsText

object (SubstringMatchCriteria)

Critères que les formes doivent correspondre pour être remplacées. La requête remplacera toutes les formes contenant le texte donné.

spreadsheetId

string

ID de la feuille de calcul Google Sheets contenant le graphique.

chartId

integer

ID du graphique spécifique dans la feuille de calcul Google Sheets.

linkingMode

enum (LinkingMode)

Mode avec lequel le graphique est associé à la feuille de calcul source. Si aucune valeur n'est spécifiée, le graphique est une image qui n'est pas associée.

pageObjectIds[]

string

Si ce champ n'est pas vide, la correspondance se limite aux éléments de page des pages données.

Renvoie une erreur 400 "Requête incorrecte" si l'ID d'objet de page notes page ou notes master est indiqué ou si une page avec cet ID d'objet n'existe pas dans la présentation.

Mode d'association

Mode avec lequel le graphique est associé à la feuille de calcul source.

Enums
NOT_LINKED_IMAGE Le graphique n'est pas associé à la feuille de calcul source et ne peut pas être mis à jour. Un graphique qui n'est pas associé sera inséré en tant qu'image.
LINKED Associer le graphique permet de le mettre à jour, et les autres collaborateurs voient un lien vers la feuille de calcul.

DeleteParagraphBulletsRequest

Supprime les puces de tous les paragraphes qui se chevauchent avec l'index de texte donné range.

Le niveau d'imbrication de chaque paragraphe est visuellement conservé en ajoutant un retrait au début du paragraphe correspondant.

Représentation JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Champs
objectId

string

ID d'objet de la forme ou du tableau contenant le texte duquel les puces doivent être supprimées.

cellLocation

object (TableCellLocation)

L'emplacement facultatif de la cellule du tableau si le texte à modifier se trouve dans une cellule du tableau. S'il est présent, l'objet objectId doit faire référence à une table.

textRange

object (Range)

Plage de texte à laquelle supprimer les puces en fonction des indices TextElement.

UpdateParagraphStyleRequest

Met à jour le style de tous les paragraphes d'une Shape ou d'une Table qui se chevauchent avec la plage d'index de texte donnée.

Représentation JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la forme ou du tableau avec le texte à styliser.

cellLocation

object (TableCellLocation)

Emplacement de la cellule dans le tableau contenant le ou les paragraphes à mettre en forme. Si objectId fait référence à une table, cellLocation doit avoir une valeur. Sinon, il ne doit pas.

style

object (ParagraphStyle)

Style du paragraphe.

textRange

object (Range)

Plage de texte contenant le ou les paragraphes auxquels appliquer le style.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine style est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour l'alignement du paragraphe, définissez fields sur "alignment".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

UpdateTableBorderPropertiesRequest

Met à jour les propriétés des bordures du tableau dans un Table.

Représentation JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la table.

tableRange

object (TableRange)

Plage de tables représentant le sous-ensemble de la table auquel les mises à jour sont appliquées. Si aucune plage de tables n'est spécifiée, les mises à jour s'appliquent à l'ensemble de la table.

borderPosition

enum (BorderPosition)

Position de bordure dans le tableau à laquelle les mises à jour doivent s'appliquer. Si aucune bordure n'est spécifiée, les mises à jour s'appliquent à toutes les bordures de la plage du tableau.

tableBorderProperties

object (TableBorderProperties)

Propriétés de la bordure du tableau à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine tableBorderProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour la couleur de remplissage continue de la bordure du tableau, définissez fields sur "tableBorderFill.solidFill.color".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

Position de la bordure

Position de la bordure du tableau.

Enums
ALL Toutes les bordures de la plage.
BOTTOM Bordures en bas de la plage.
INNER Bordures à l'intérieur de la plage.
INNER_HORIZONTAL Bordures horizontales à l'intérieur de la plage.
INNER_VERTICAL Bordures verticales à l'intérieur de la plage.
LEFT Bordures à gauche de la plage.
OUTER Bordures le long de la plage.
RIGHT Bordures à droite de la plage.
TOP Bordures en haut de la plage.

UpdateTableColumnPropertiesRequest

Met à jour les propriétés d'une colonne Table.

Représentation JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la table.

columnIndices[]

integer

Liste d'indices basés sur zéro indiquant les colonnes à mettre à jour. Si aucun indice n'est fourni, toutes les colonnes du tableau sont mises à jour.

tableColumnProperties

object (TableColumnProperties)

Propriétés de la colonne du tableau à mettre à jour.

Si la valeur de tableColumnProperties#columnWidth dans la requête est inférieure à 406 400 EMU (32 points), une erreur 400 de requête incorrecte est renvoyée.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine tableColumnProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour mettre à jour la largeur de la colonne, définissez fields sur "columnWidth".

Si ""widthWidth" est inclus dans le masque de champ, mais que la propriété n'est pas configurée,la largeur de colonne est définie par défaut sur 406 400 EMU (32 points).

UpdateTableRowPropertiesRequest

Met à jour les propriétés d'une ligne Table.

Représentation JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la table.

rowIndices[]

integer

Liste d'indices basés sur zéro indiquant les lignes à mettre à jour. Si aucun indice n'est fourni, toutes les lignes du tableau sont mises à jour.

tableRowProperties

object (TableRowProperties)

Propriétés de la ligne du tableau à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine tableRowProperties est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour modifier la hauteur minimale des lignes, définissez fields sur "minRowHeight".

Si "minRowHeight" est inclus dans le masque de champ, mais que la propriété n'est pas configurée, la hauteur de ligne minimale est définie par défaut sur 0.

Demande MergeTableCells

Fusionne les cellules d'une Table.

Représentation JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Champs
objectId

string

ID d'objet de la table.

tableRange

object (TableRange)

Plage qui spécifie les cellules de la table à fusionner.

Le texte des cellules fusionnées sera concaténé et stocké dans la cellule supérieure gauche ("head") de la plage. Si la plage n'est pas rectangulaire (ce qui peut se produire dans les cas où la plage couvre des cellules déjà fusionnées), une erreur 400 de requête incorrecte est renvoyée.

UnmergeTableCellsRequest

Défusionne les cellules d'un Table.

Représentation JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Champs
objectId

string

ID d'objet de la table.

tableRange

object (TableRange)

Plage de tableaux spécifiant les cellules à défusionner.

La fusion des cellules de cette plage ne sera pas affectée, et les cellules déjà fusionnées ne seront pas affectées. Si la plage ne comporte aucune cellule fusionnée, la requête n'aura aucun effet. S'il y a du texte dans l'une des cellules fusionnées, il reste dans la cellule en haut à gauche (en-tête) du bloc de cellules non fusionné obtenu.

Requête GroupObjects

Regroupe les objets pour créer un groupe d'objets. Par exemple, regroupez PageElements pour créer un Group sur la même page que tous les enfants.

Représentation JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Champs
groupObjectId

string

ID d'objet fourni par l'utilisateur pour le groupe à créer.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page dans la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière [a-zA-Z0-9_]). Les caractères restants peuvent inclure ces éléments ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur de l'ID ne doit pas être inférieure à 5 ou supérieure à 50.

Si vous ne spécifiez pas d'ID, un identifiant unique est généré.

childrenObjectIds[]

string

ID des objets à regrouper.

Seuls les éléments de page peuvent être regroupés. La page doit contenir au moins deux éléments qui ne figurent pas dans un autre groupe. Impossible de regrouper certains éléments de pages, tels que videos, tables et placeholders.

Dégrouper les objets de groupe

Dégroupe les objets, tels que groups.

Représentation JSON 
{
  "objectIds": [
    string
  ]
}
Champs
objectIds[]

string

ID des objets à dissocier.

Seuls les groups qui ne se trouvent pas dans d'autres groups peuvent être dissociés. Tous les groupes doivent être sur la même page. Le groupe lui-même est supprimé. Les tailles et positions visuelles de tous les éléments enfants sont conservées.

UpdatePageElementAltTextRequest

Met à jour le titre et/ou la description du texte alternatif d'un page element.

Représentation JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
Champs
objectId

string

ID d'objet de l'élément de page auquel les mises à jour sont appliquées.

title

string

Titre du texte alternatif mis à jour pour l'élément de page. Si cette règle n'est pas configurée, la valeur existante est conservée. Le titre est présenté aux lecteurs d'écran et à d'autres interfaces d'accessibilité. N'utilisez que des valeurs lisibles liées au contenu de l'élément de page.

description

string

Description du texte alternatif mis à jour pour l'élément de page. Si cette règle n'est pas configurée, la valeur existante est conservée. La description est présentée aux lecteurs d'écran et aux autres interfaces d'accessibilité. N'utilisez que des valeurs lisibles liées au contenu de l'élément de page.

Remplacer ImageRequest

Remplace une image existante par une nouvelle.

Le remplacement d'une image supprime des image effects de l'image existante.

Représentation JSON 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Champs
imageObjectId

string

ID de l'image existante qui sera remplacée. L'ID peut être récupéré à partir de la réponse à une requête get.

imageReplaceMethod

enum (ImageReplaceMethod)

Méthode de remplacement.

Champ d'union image_source. Type de source de l'image. image_source ne peut être que l'un des éléments suivants:
url

string

URL de l'image.

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 peut pas dépasser 2 Ko. L'URL est enregistrée avec l'image et exposée via le champ Image.source_url.

Mettre à jour une SlidePropertiesProperties

Met à jour les propriétés d'une diapositive.

Représentation JSON 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
Champs
objectId

string

ID d'objet de la diapositive à laquelle la mise à jour est appliquée

slideProperties

object (SlideProperties)

Propriétés de la diapositive à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Au moins un champ doit être spécifié. La racine "slideProperties" est implicite et ne doit pas être spécifiée. Un seul élément "*" peut être utilisé comme raccourci pour lister tous les champs.

Par exemple, pour indiquer si une diapositive est ignorée, définissez fields sur "isSkipped".

Pour rétablir une valeur par défaut d'une propriété, incluez son nom dans le masque de champ, mais ne définissez pas le champ lui-même.

UpdatePageElementsZOrderRequest

Met à jour l'ordre Z des éléments de page. L'ordre Z est l'ordre des éléments sur la page, de dos à face. L'élément de page situé au premier plan peut couvrir les éléments situés derrière.

Représentation JSON 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
Champs
pageElementObjectIds[]

string

ID des éléments de la page à mettre à jour.

Tous les éléments de la page doivent figurer sur la même page et ne doivent pas être regroupés.

operation

enum (ZOrderOperation)

L'opération d'ordre Z à appliquer aux éléments de la page.

Lors de l'application de l'opération sur plusieurs éléments de page, les ordres Z relatifs à ces éléments de page avant l'opération sont maintenus.

Commande ZZ

Opération permettant de mettre à jour l'ordre de plan d'un élément de page.

Enums
Z_ORDER_OPERATION_UNSPECIFIED Opération non spécifiée.
BRING_TO_FRONT Met les éléments de la page au début de la page.
BRING_FORWARD Permet de faire passer les éléments d'une page vers l'avant d'un élément par rapport au premier dans les éléments de page spécifiés.
SEND_BACKWARD Renvoie les éléments de la page en arrière d'un élément par rapport à l'élément le plus derrière un des éléments de page spécifiés.
SEND_TO_BACK Renvoie les éléments de la page au dos de celle-ci.

UpdateLineCategoryRequest

Met à jour la catégorie d'un line.

Représentation JSON 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
Champs
objectId

string

ID d'objet de la ligne à laquelle la mise à jour est appliquée.

Seule une ligne avec un category indiquant qu'il s'agit d'un "connecteur" peut être mise à jour.

La ligne peut être réacheminée après la modification de sa catégorie.

lineCategory

enum (LineCategory)

Catégorie de ligne à mettre à jour.

Le line type exact est déterminé en fonction de la catégorie vers laquelle effectuer la mise à jour et de la manière dont il est routé avec d'autres éléments de la page.

Requête RerouteLineRequest

Réachemine une line de sorte qu'elle soit connectée aux deux sites de connexion les plus proches sur les éléments de la page connectée.

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

string

ID d'objet de la ligne à réacheminer.

Seule une ligne avec un category indiquant qu'il s'agit d'un "connecteur" peut être réacheminée. Les connexions de début et de fin de la ligne doivent se trouver sur des éléments de page différents.