Requests

Requête

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 forme ou une cellule de tableau.

insertTableRows

object (InsertTableRowsRequest)

Insère des lignes dans un tableau.

insertTableColumns

object (InsertTableColumnsRequest)

Insère des colonnes dans un tableau.

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 de 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'une 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)

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

updateTextStyle

object (UpdateTextStyleRequest)

Met à jour le style du texte dans une 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 d'une Shape ou Table

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

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

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

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

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

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

mergeTableCells

object (MergeTableCellsRequest)

Fusionne les cellules d'une Table

unmergeTableCells

object (UnmergeTableCellsRequest)

Annule la fusion des cellules d'une Table

groupObjects

object (GroupObjectsRequest)

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

ungroupObjects

object (UngroupObjectsRequest)

Dissocie les objets, tels que groups

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

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

replaceImage

object (ReplaceImageRequest)

Remplace une image existante par une nouvelle image.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

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

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Met à jour l'ordre de plan de page elements

updateLineCategory

object (UpdateLineCategoryRequest)

Met à jour la catégorie d'un line

rerouteLine

object (RerouteLineRequest)

Redirige un line de sorte qu'il soit connecté aux deux sites de connexion les plus proches sur les éléments de la page connectés.

CreateSlideRequest

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 de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). L'ID doit comporter entre 5 et 50 caractères inclus.

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

insertionIndex

integer

L'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 actuel, qui peut avoir l'une des valeurs suivantes:

  • Masque de l'index des diapositives précédentes.
  • Masque de la première diapositive, si "insertionIndex" est égal à zéro.
  • Premier masque de la présentation, s'il n'y a pas de diapositives.

Si l'élément LayoutReference est introuvable dans l'instance maître actuelle, une erreur de requête incorrecte 400 est renvoyée.

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Une liste facultative des mappages d'ID d'objet à partir du placeholder de la mise en page aux espaces réservés créés sur la diapositive à partir de la mise en page spécifiée. Uniquement utilisable lorsque slideLayoutReference est spécifiée.

LayoutReference

Référence de mise en page de diapositive. Elle peut faire référence à l'un des éléments suivants:

  • Une mise en page prédéfinie
  • L'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 Le genre 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: ID d'objet de l'une des mises en page de la présentation.

PredefinedLayout

Types de mise en page prédéfinis. On les trouve couramment dans les présentations. Toutefois, il n'est pas garanti que ces mises en page soient présentes dans le maître actuel, car elles auraient pu être supprimées ou ne pas faire partie du thème utilisé. De plus, les espaces réservés sur chaque mise en page peuvent avoir été modifiés.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED Mise en page non spécifiée.
BLANK Mise en page vierge, 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 un titre et un corps.
TITLE_AND_TWO_COLUMNS Mise en page avec un titre et deux colonnes.
TITLE_ONLY Mise en page comportant uniquement un titre.
SECTION_HEADER Mise en page avec un 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és en 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 qui doit être créé sur une diapositive.

Si vous spécifiez un ID, il doit être unique parmi toutes les pages et tous les éléments de page de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret 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 ni supérieure à 50.

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

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

object (Placeholder)

Espace réservé dans une mise en page qui sera appliqué à une diapositive. Uniquement type et index sont nécessaires. Par exemple, un ensemble prédéfini TITLE_AND_BODY la mise en page comporte généralement 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é à 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 de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret 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 ni supérieure à 50. Si ce champ n'est pas renseigné, 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.

PageElementProperties

Propriétés communes à un élément de page.

Remarque: Lorsque vous créez PageElement, l'API peut modifier les valeurs des deux size et transform, mais la taille visuelle restera inchangé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 de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret 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 ni supérieure à 50.

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

elementProperties

object (PageElementProperties)

Propriétés de l'élément pour le tableau.

La table sera créée à la taille fournie, avec une taille minimale. Si vous ne spécifiez aucune taille, la table sera automatiquement dimensionnée.

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

rows

integer

Nombre de lignes dans la table.

columns

integer

Nombre de colonnes dans le tableau.

InsertTextRequest

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 dans lequel le texte sera inséré.

cellLocation

object (TableCellLocation)

Emplacement facultatif de la cellule du tableau si le texte doit être inséré dans une cellule du tableau. S'il est présent, "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 à cet indice. Le style du nouveau paragraphe sera copié à partir du paragraphe dans l'index d'insertion actuel, y compris les listes et les puces.

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

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

insertionIndex

integer

L'index où le texte sera inséré, en unités de code Unicode, en fonction de TextElement index.

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 les clusters de graphèmes Unicode. Dans ce cas, le texte est inséré immédiatement après l'amas de graphèmes.

InsertTableRowsRequest

Insère des lignes dans un tableau.

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

string

Table dans laquelle 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 est insérée au-dessus (ou en dessous) de la ligne où se trouve la cellule de référence. Si la cellule de référence est une cellule fusionnée, une nouvelle ligne est insérée au-dessus (ou en dessous) de la cellule fusionnée.

insertBelow

boolean

Permet d'insérer ou non 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. Maximum 20 par requête.

InsertTableColumnsRequest

Insère des colonnes dans un tableau.

Les autres colonnes du tableau sont redimensionnées en fonction de 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 où se trouve la cellule de référence. Si la cellule de référence est une cellule fusionnée, une nouvelle colonne est insérée à gauche (ou à droite) de la cellule fusionnée.

insertRight

boolean

Permet d'insérer ou non 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. Maximum 20 par requête.

DeleteTableRowRequest

Supprime une ligne d'une table.

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

string

Tableau dans lequel les lignes doivent être supprimées.

cellLocation

object (TableCellLocation)

Emplacement de la cellule du tableau de référence à partir duquel une ligne sera supprimée.

La ligne sur laquelle s'étend 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, l'intégralité de la table est supprimée.

DeleteTableColumnRequest

Supprime une colonne d'une table.

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

string

Table dans laquelle supprimer les colonnes.

cellLocation

object (TableCellLocation)

Emplacement de la cellule du tableau de référence à partir duquel une colonne sera supprimée.

La colonne dans laquelle cette cellule couvre 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 cette suppression, l'ensemble de la table est supprimé.

ReplaceAllTextRequest

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, limite les correspondances aux éléments des pages indiquées uniquement.

Renvoie une erreur 400 "Requête incorrecte" si l'ID d'objet de page d'une notes master, ou si la présentation ne comporte pas de page avec cet ID d'objet.

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)

Trouve le texte d'une forme correspondant à cette sous-chaîne.

SubstringMatchCriteria

Un critère qui correspond à 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 : pages ou page elements, de la présentation.

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

string

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

Si, après une opération de suppression, group contient un seul élément de page ou aucun, le groupe est également supprimé.

Si un espace réservé est supprimé d'une mise en page, tous les espaces réservés hérités vides sont également supprimés.

UpdatePageElementTransformRequest

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

Modifier la transformation d'un groupe modifie la transformation absolue des éléments de la page de ce groupe, ce qui peut modifier leur apparence visuelle. Consultez la documentation pour PageElement.transform pour en savoir plus.

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 d'entrée utilisée pour mettre à jour l'élément de page.

applyMode

enum (ApplyMode)

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

ApplyMode

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 remplace la matrice existante par la concaténation résultante.
ABSOLUTE Remplace la matrice AffineTransform existante par la nouvelle.

UpdateSlidesPositionRequest

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

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

string

ID des diapositives de la présentation à déplacer. Les diapositives de cette liste doivent s'afficher dans l'ordre de présentation existant, sans doublons.

insertionIndex

integer

Index à l'endroit où les diapositives doivent être insérées, basé sur la disposition des diapositives avant le déplacement Doit être compris entre zéro et le nombre de diapositives inclus dans la présentation.

DeleteTextRequest

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

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

string

ID de l'objet de la forme ou de la table dont le texte sera supprimé.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

Plage de texte à supprimer, basée sur TextElement index.

Il y a toujours un caractère de retour à la ligne implicite à la fin du texte d'une forme ou d'une cellule de tableau qui ne peut pas être supprimé. Range.Type.ALL utilisera 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'un retour à la ligne implicite, la valeur maximale est 2 pour textRange.start_index et 3 pour textRange.end_index

La suppression de texte qui dépasse la limite d'un paragraphe peut entraîner la modification des styles de paragraphe et des listes lors de la fusion des deux paragraphes.

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

Plage

Spécifie une plage contiguë d'une collection indexée, telle que des caractères dans le texte.

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

integer

Indice facultatif de base zéro du début de la collection. Obligatoire pour FIXED_RANGE et FROM_START_INDEX plages.

endIndex

integer

Indice facultatif de base zéro à la fin de la collection. Obligatoire pour FIXED_RANGE plages.

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 Une plage fixe. Les startIndex et endIndex doit être spécifié.
FROM_START_INDEX Commence la plage à startIndex et se poursuit jusqu'à la fin de la collecte. La endIndex ne doit pas être spécifiée.
ALL Définit la plage de sorte qu'elle corresponde à la longueur totale de la collection. Les startIndex et endIndex ne doit pas être spécifiée.

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 de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret 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 ni supérieure à 50.

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

elementProperties

object (PageElementProperties)

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

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

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

La PageElementProperties.transform est facultative. Si vous ne spécifiez pas de transformation, l'image est placée dans l'angle supérieur 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 extraite une fois au moment de l'insertion et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo et ne doivent pas dépasser 25 mégapixels, et doivent être au format PNG, JPEG ou GIF.

L'URL fournie doit être accessible au public et ne doit pas dépasser 2 Ko. L'URL est enregistrée avec l'image et affichée via la Image.source_url .

CreateVideoRequest

Crée une vidéo.

REMARQUE: Pour créer une vidéo depuis Google Drive, l'application à l'origine de la demande doit disposer d'au moins l'une des habilitations OAuth "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 de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret 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 ni supérieure à 50.

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

elementProperties

object (PageElementProperties)

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

La PageElementProperties.size est facultative. Si vous ne spécifiez pas de taille, le serveur choisit une taille par défaut.

La 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 dans l'angle supérieur gauche de la page.

source

enum (Source)

Source vidéo.

id

string

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

Ex. : Pour les vidéos 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é d'accès à la ressource dans l'en-tête HTTP d'un sous-ensemble d'anciens fichiers. Pour en savoir plus, consultez Accéder aux fichiers partagés par lien à l'aide de clés de ressource

CreateSheetsChartRequest

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

REMARQUE: Pour créer un graphique, vous devez disposer d'au moins l'une des habilitations Google Sheets.readonly, Sheets, drive.readonly, drive.file ou Drive.

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 page 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 ni supérieure à 50. Si ce champ n'est pas renseigné, un identifiant unique est généré.

elementProperties

object (PageElementProperties)

Propriétés de l'élément pour le graphique.

Lorsque les proportions de la taille fournie ne correspondent pas à celles du graphique, celui-ci est mis à l'échelle et centré par rapport à la taille afin d'en préserver 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é d'accès à la ressource à l'en-tête HTTP pour un sous-ensemble d'anciens fichiers. Pour en savoir plus, consultez Accéder aux fichiers partagés par lien à l'aide de clés de ressource

chartId

integer

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

linkingMode

enum (LinkingMode)

Mode d'association du graphique à la feuille de calcul source. Si aucune valeur n'est spécifiée, le graphique est une image sans lien.

LinkingMode

Mode d'association du graphique à 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 lié est inséré en tant qu'image.
LINKED Associer le graphique permet de le mettre à jour, et les autres collaborateurs verront 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 de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret 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 ni supérieure à 50.

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

elementProperties

object (PageElementProperties)

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

lineCategory
(deprecated)

enum (Category)

Catégorie de la ligne à créer.

<ph type="x-smartling-placeholder"></ph> Obsolète : utilisez category à la place.

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

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

category

enum (LineCategory)

Catégorie de la ligne à créer.

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

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

Si vous ne spécifiez pas de valeur pour le paramètre category, mais spécifiez une valeur pour lineCategory, puis la valeur lineCategory est utilisée.

Si vous ne spécifiez ni l'une ni l'autre, STRAIGHT est utilisé.

Catégorie

Catégories de lignes.

<ph type="x-smartling-placeholder">

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

RefreshSheetsChartRequest

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

REMARQUE: Pour actualiser les graphiques, vous devez disposer d'au moins l'une des habilitations Google Sheets.readonly, Sheets, drive.readonly ou Drive.

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

string

ID de l'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 forme à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine shapeProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

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.

Vous devez spécifier au moins un champ. La racine imageProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

UpdateVideoPropertiesRequest

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 à laquelle les modifications sont appliquées.

videoProperties

object (VideoProperties)

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

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine videoProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

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.

Vous devez spécifier au moins un champ. La racine pageProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

UpdateTableCellPropertiesRequest

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 la table représentant le sous-ensemble de la table auquel les mises à jour sont appliquées. Si aucune plage n'est spécifiée, les mises à jour s'appliqueront à l'ensemble de la table.

tableCellProperties

object (TableCellProperties)

Propriétés des cellules du tableau à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine tableCellProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

TableRange

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

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 un tableau 3 x 3 dans lequel toutes les cellules de la dernière ligne sont fusionnées. Le tableau se présente comme suit:

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

Une plage de tableau dont l'emplacement = (0, 0), l'étendue des lignes = 3 et l'intervalle des colonnes = 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)

Emplacement de départ de la plage du tableau.

rowSpan

integer

Étendue des lignes de la plage du tableau.

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 ligne à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine lineProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

Par exemple, pour modifier la couleur de remplissage de la ligne, définissez fields à "lineFill.solidFill.color"

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

CreateParagraphBulletsRequest

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

Le niveau d'imbrication de chaque paragraphe sera déterminé en comptant les tabulations du début devant chaque paragraphe. Pour éviter un espace excessif entre la puce et le paragraphe correspondant, cette requête supprime ces tabulations de début. Cela peut modifier les index de certaines parties du texte.

Si le paragraphe qui précède la mise à jour se trouve dans une liste dont le préréglage correspond, les paragraphes mis à jour sont ajoutés à la liste précédente.

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

string

ID d'objet de la forme ou de la table contenant le texte auquel ajouter les puces.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

BulletGlyphPreset

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

Ces modèles utilisent les types de puces suivants:

  • ARROW : flèche correspondant à un point de code Unicode U+2794
  • ARROW3D : flèche ombrée en 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 plein, correspondant à un point de code Unicode U+25c6
  • DIAMONDX : losange suivi d'un "x", correspondant à un point de code Unicode U+2756
  • HOLLOWDIAMOND : losange creux 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 : étoile correspondant à un point de code Unicode U+2605
  • ALPHA : une lettre minuscule, telle que "a", "b" ou "c".
  • UPPERALPHA : une lettre majuscule, telle que "A", "B" ou "C".
  • DIGIT : un nombre, tel que "1", "2" ou "3".
  • ZERODIGIT : nombre où un numéro à un chiffre est précédé d'un zéro, comme "01", "02" ou "03". Les nombres comportant plus d'un chiffre ne sont pas précédés d'un zéro.
  • ROMAN : chiffre romain minuscule, tel que "i", "ii" ou "iii".
  • UPPERROMAN : chiffre romain en majuscules, tel que "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 avec une DISC, CIRCLE et SQUARE une puce pour les 3 premiers niveaux d'imbrication de liste.
BULLET_DIAMONDX_ARROW3D_SQUARE Une liste à puces avec une DIAMONDX, ARROW3D et SQUARE une puce pour les 3 premiers niveaux d'imbrication de liste.
BULLET_CHECKBOX Une liste à puces avec CHECKBOX des puces pour tous les niveaux d'imbrication de liste.
BULLET_ARROW_DIAMOND_DISC Une liste à puces avec une ARROW, DIAMOND et DISC une puce pour les 3 premiers niveaux d'imbrication de liste.
BULLET_STAR_CIRCLE_SQUARE Une liste à puces avec une STAR, CIRCLE et SQUARE une puce pour les 3 premiers niveaux d'imbrication de liste.
BULLET_ARROW3D_CIRCLE_SQUARE Une liste à puces avec une ARROW3D, CIRCLE et SQUARE une puce pour les 3 premiers niveaux d'imbrication de liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Une liste à puces avec une LEFTTRIANGLE, DIAMOND et DISC une puce pour les 3 premiers niveaux d'imbrication de liste.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Une liste à puces avec une DIAMONDX, HOLLOWDIAMOND et SQUARE une puce pour les 3 premiers niveaux d'imbrication de liste.
BULLET_DIAMOND_CIRCLE_SQUARE Une liste à puces avec une DIAMOND, CIRCLE et SQUARE une puce pour les 3 premiers niveaux d'imbrication de liste.
NUMBERED_DIGIT_ALPHA_ROMAN Une liste numérotée avec DIGIT, ALPHA et ROMAN des glyphes numériques pour les 3 premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Une liste numérotée avec DIGIT, ALPHA et ROMAN des glyphes numériques pour les 3 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, chaque niveau d'imbrication utilisant le glyphe du niveau d'imbrication précédent comme préfixe Par exemple : "1.", "1.1.", '2.', "2.2.".
NUMBERED_UPPERALPHA_ALPHA_ROMAN Une liste numérotée avec UPPERALPHA, ALPHA et ROMAN des glyphes numériques pour les 3 premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Une liste numérotée avec UPPERROMAN, UPPERALPHA et DIGIT des glyphes numériques pour les 3 premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Une liste numérotée avec ZERODIGIT, ALPHA et ROMAN des glyphes numériques pour les 3 premiers niveaux d'imbrication de liste, suivis de points.

ReplaceAllShapesWithImageRequest

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

Les images remplaçant les formes sont rectangulaires après avoir été insérées dans la présentation et ne prennent pas la forme des 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)

Méthode replace.

<ph type="x-smartling-placeholder"></ph> Obsolète : utilisez imageReplaceMethod à la place.

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

imageReplaceMethod

enum (ImageReplaceMethod)

La méthode de remplacement d'image.

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

Si vous ne spécifiez pas de valeur pour le paramètre imageReplaceMethod, mais spécifiez une valeur pour replaceMethod, puis la valeur replaceMethod est utilisée.

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

pageObjectIds[]

string

Si ce champ n'est pas vide, limite les correspondances aux éléments des pages indiquées uniquement.

Renvoie une erreur 400 "Requête incorrecte" si l'ID d'objet de page d'une notes page ou un notes master, ou si la présentation ne contient pas de page avec cet ID d'objet.

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

object (SubstringMatchCriteria)

Si elle est définie, cette requête remplacera 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 extraite une fois au moment de l'insertion et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne doivent pas dépasser 25 mégapixels et doivent ê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 la Image.source_url .

ReplaceMethod

Méthode replace.

<ph type="x-smartling-placeholder">

Enums
CENTER_INSIDE Redimensionne et centre l'image pour l'adapter aux limites de la forme d'origine, et conserve ses proportions. La taille de rendu de l'image peut être inférieure à la taille de la forme. Il s'agit de la méthode par défaut lorsqu'aucune méthode n'est spécifiée.
CENTER_CROP Redimensionne et centre l'image pour remplir les limites de la forme d'origine. L'image peut être recadrée afin de remplir la forme. La taille de rendu de l'image sera identique à celle de la forme d'origine.

ImageReplaceMethod

La méthode de remplacement d'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 Redimensionne et centre l'image pour l'adapter aux limites de la forme d'origine, et conserve ses proportions. La taille de rendu de l'image peut être inférieure à la taille de la forme. Il s'agit de la méthode par défaut lorsqu'aucune méthode n'est spécifiée.
CENTER_CROP Redimensionne et centre l'image pour remplir les limites de la forme d'origine. L'image peut être recadrée afin de remplir la forme. La taille de rendu de l'image sera identique à la forme d'origine.

DuplicateObjectRequest

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

Lorsque vous dupliquez une diapositive, la diapositive dupliquée 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 l'original.

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 lors de la duplication d'une diapositive ou d'un élément de page d'un groupe. Ce mappage définit la manière dont les identifiants des objets dupliqués sont générés: les clés sont les identifiants des objets d'origine et leurs valeurs sont les identifiants qui seront attribués à l'objet dupliqué correspondant. L'identifiant du doublon de l'objet source peut également être spécifié dans cette carte, en utilisant la même valeur du paramètre objectId comme clé et l'ID nouvellement souhaité comme 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 commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière) [a-zA-Z0-9_]); les autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). La longueur du nouvel identifiant ne doit pas être inférieure à 5 ni supérieure à 50.

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

UpdateTextStyleRequest

Modifiez le style du texte dans une Shape ou 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 auquel appliquer un style.

cellLocation

object (TableCellLocation)

Emplacement de la cellule dans le tableau contenant le texte auquel appliquer un style. Si objectId fait référence à un tableau, cellLocation doit comporter une valeur. Sinon, il ne doit pas en avoir.

style

object (TextStyle)

Style(s) à appliquer au texte.

Si la valeur d'un style particulier correspond à celle du parent, ce style sera défini sur hériter.

Certaines modifications de style de texte peuvent entraîner d'autres modifications visant à refléter le comportement de l'éditeur Slides. Consultez la documentation TextStyle pour en savoir plus.

textRange

object (Range)

Plage de texte auquel appliquer un style.

La plage peut être étendue pour inclure les sauts de 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.

Vous devez spécifier au moins un champ. La racine style est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

Par exemple, pour mettre le style du texte en gras, définissez fields à "bold"

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

ReplaceAllShapesWithSheetsChartRequest

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

REMARQUE: Pour remplacer des formes par un graphique, vous devez disposer d'au moins l'une des habilitations Google Sheets.readonly, Sheets, drive.readonly ou Drive.

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

object (SubstringMatchCriteria)

Critères auxquels 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 d'association du graphique à la feuille de calcul source. Si aucune valeur n'est spécifiée, le graphique est une image sans lien.

pageObjectIds[]

string

Si ce champ n'est pas vide, limite les correspondances aux éléments des pages indiquées uniquement.

Renvoie une erreur 400 "Requête incorrecte" si l'ID d'objet de page d'une notes page ou un notes master, ou si la présentation ne contient pas de page avec cet ID d'objet.

LinkingMode

Mode d'association du graphique à 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 lié est inséré en tant qu'image.
LINKED Associer le graphique permet de le mettre à jour, et les autres collaborateurs verront un lien vers la feuille de calcul.

DeleteParagraphBulletsRequest

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

Le niveau d'imbrication de chaque paragraphe sera préservé visuellement 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 de la table contenant le texte dans lequel les puces doivent être supprimées.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

Plage de texte dont les puces doivent être supprimées, en fonction de TextElement index.

UpdateParagraphStyleRequest

Met à jour le style de tous les paragraphes d'une Shape ou Table qui chevauchent la plage d'indices de texte indiqué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 auquel appliquer un style.

cellLocation

object (TableCellLocation)

Emplacement de la cellule dans le tableau contenant le ou les paragraphes auxquels appliquer un style. Si objectId fait référence à un tableau, cellLocation doit comporter une valeur. Sinon, il ne doit pas en avoir.

style

object (ParagraphStyle)

Style du paragraphe.

textRange

object (Range)

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

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine style est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

Par exemple, pour modifier l'alignement d'un paragraphe, définissez fields à "alignment"

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

UpdateTableBorderPropertiesRequest

Met à jour les propriétés des bordures de 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 la table représentant le sous-ensemble de la table auquel les mises à jour sont appliquées. Si aucune plage n'est spécifiée, les mises à jour s'appliqueront à l'ensemble de la table.

borderPosition

enum (BorderPosition)

Position de la bordure dans la plage du tableau à laquelle les mises à jour doivent s'appliquer. Si aucune position de 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 bordure du tableau à mettre à jour.

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine tableBorderProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

BorderPosition

Position de la bordure du tableau.

Enums
ALL Toutes les bordures de la plage
BOTTOM Frontières situées en bas de la plage.
INNER Bordures situées à 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 situées en dehors de la plage.
RIGHT Frontières à droite de la plage.
TOP Frontières situées en haut de la plage.

UpdateTableColumnPropertiesRequest

Met à jour les propriétés d'un 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 des index de base zéro spécifiant les colonnes à mettre à jour. Si aucun indice n'est fourni, toutes les colonnes du tableau seront 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 de requête incorrecte 400 est renvoyée.

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine tableColumnProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

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

UpdateTableRowPropertiesRequest

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

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

string

ID d'objet de la table.

rowIndices[]

integer

Liste des index de base zéro spécifiant les lignes à mettre à jour. Si aucun indice n'est fourni, toutes les lignes du tableau seront mises à jour.

tableRowProperties

object (TableRowProperties)

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

fields

string (FieldMask format)

Champs à mettre à jour.

Vous devez spécifier au moins un champ. La racine tableRowProperties est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

Par exemple, pour mettre à jour la hauteur de ligne minimale, définissez fields à "minRowHeight"

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

MergeTableCellsRequest

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 du tableau spécifiant les cellules à fusionner.

Tout texte des cellules fusionnées sera concaténé et stocké dans la cellule située en haut à gauche ("head") de la plage. Si la plage est non rectangulaire (ce qui peut se produire dans certains cas lorsque la plage couvre des cellules déjà fusionnées), une erreur de requête incorrecte 400 est renvoyée.

UnmergeTableCellsRequest

Annule la fusion des 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 du tableau spécifiant les cellules du tableau dont la fusion doit être annulée.

Toutes les cellules fusionnées de cette plage seront annulées, et les cellules dont la fusion a déjà été annulée ne seront pas affectées. Si la plage ne contient pas de cellules fusionnées, la requête n'a aucun effet. Si l'une des cellules fusionnées contient du texte, il reste affiché dans la cellule supérieure gauche ("head") du bloc de cellules non fusionnées obtenu.

GroupObjectsRequest

Regroupe les objets pour créer un groupe d'objets. Par exemple, les groupes PageElements pour créer 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 de 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 autres caractères peuvent inclure ceux-ci, ainsi qu'un tiret 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 ni supérieure à 50.

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

childrenObjectIds[]

string

ID des objets à regrouper.

Seuls les éléments de page peuvent être regroupés. Au moins deux éléments de page doivent figurer sur une même page qui ne font pas déjà partie d'un autre groupe. Certains éléments de la page, tels que videos, tables et placeholders ne peuvent pas être regroupés.

UngroupObjectsRequest

Dissocie les objets, tels que groups

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

string

ID des objets à dégrouper.

Uniquement groups qui ne sont pas à l'intérieur d'autres groups peuvent être dissociées. Tous les groupes doivent être sur la même longueur d'onde. Le groupe lui-même est supprimé. Les tailles et positions visuelles de tous les enfants sont conservées.

UpdatePageElementAltTextRequest

Met à jour le titre et/ou la description du texte alternatif d'une 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 de l'élément de page. Si cette règle n'est pas configurée, la valeur existante est conservée. Le titre est visible par les lecteurs d'écran et les autres interfaces d'accessibilité. N'utilisez que des valeurs lisibles par l'humain qui sont liées au contenu de l'élément de la page.

description

string

Texte alternatif de description de l'élément de page mis à jour. 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 par l'humain qui sont liées au contenu de l'élément de la page.

ReplaceImageRequest

Remplace une image existante par une nouvelle image.

Le remplacement d'une image supprime image effects à partir 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'identifiant peut être récupéré à partir de la réponse d'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 extraite une fois au moment de l'insertion et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne doivent pas dépasser 25 mégapixels et doivent être au format PNG, JPEG ou GIF.

La longueur de l'URL fournie ne peut pas dépasser 2 Ko. L'URL est enregistrée avec l'image et affichée via la Image.source_url .

UpdateSlidePropertiesRequest

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 sur 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.

Vous devez spécifier au moins un champ. La racine "slideProperties" est implicite et ne doit pas être spécifié. Une seule "*" peut servir de raccourci pour répertorier chaque champ.

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

Pour rétablir la valeur par défaut d'une propriété, incluez son nom de champ dans le masque de champ, mais laissez le champ non défini.

UpdatePageElementsZOrderRequest

Met à jour l'ordre de plan des éléments de la page. L'ordre de plan est un ordre des éléments sur la page, de l'arrière vers le début. L'élément de page situé au premier plan peut recouvrir les éléments situés derrière.

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

string

ID des objets des éléments de 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)

Opération d'ordre de plan à appliquer aux éléments de la page.

Lorsque vous appliquez l'opération à plusieurs éléments de page, les ordres de plan relatifs dans ces éléments de la page avant que l'opération ne soit maintenue.

ZOrderOperation

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 Affiche les éléments de la page au début de la page.
BRING_FORWARD Déplace les éléments de page d'un élément vers l'avant sur la page par rapport à l'élément le plus en avant dans les éléments de page spécifiés.
SEND_BACKWARD Déplace les éléments de page d'un élément vers l'arrière sur la page, par rapport à l'élément le plus éloigné sur l'un des éléments de page spécifiés.
SEND_TO_BACK Envoie les éléments de page au verso de la page.

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 le signe category indiquant qu'il s'agit d'un "connecteur" peuvent être mises à jour.

La ligne pourra être réacheminée après la mise à jour de sa catégorie.

lineCategory

enum (LineCategory)

Catégorie de ligne à mettre à jour.

Le mot clé exact line type est déterminé en fonction de la catégorie à mettre à jour et de la manière dont elle est acheminée pour se connecter à d'autres éléments de la page.

RerouteLineRequest

Redirige un line de sorte qu'il soit connecté aux deux sites de connexion les plus proches sur les éléments de la page connectés.

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

string

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

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