Requests

Requête

Type unique de mise à jour à appliquer à une présentation.

Représentation JSON
{

  "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)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
}
Champs
Type de mise à jour. Un seul champ est requis. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
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 une table.

insertTableColumns

object (InsertTableColumnsRequest)

Insère des colonnes dans un tableau.

deleteTableRow

object (DeleteTableRowRequest)

Supprime une ligne d'un tableau.

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

Duplique un élément de diapositive ou 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'un Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Annule la fusion des cellules d'une Table.

groupObjects

object (GroupObjectsRequest)

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

ungroupObjects

object (UngroupObjectsRequest)

Dissocie les objets, comme 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)

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

insertComment

object (InsertCommentRequest)

Insère un CommentThread dans la présentation.

addCommentReply

object (AddCommentReplyRequest)

Ajoute une réponse à un CommentThread.

updateCommentPost

object (UpdateCommentPostRequest)

Met à jour un post existant (post principal ou réponse) d'un CommentThread.

deleteComment

object (DeleteCommentRequest)

Supprime un CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Supprime une réponse Post d'une CommentThread.

Fin des champs qui s'excluent mutuellement.

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 caractères restants peuvent inclure ceux-ci, 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, inclus.

Si vous ne spécifiez pas d'ID, un ID 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, basée sur la diapositive mère actuelle, qui peut être l'une des suivantes :

  • Index de la diapositive précédente dans le masque.
  • Le masque de la première diapositive, si l'insertionIndex est nul.
  • Le premier masque de la présentation, s'il n'y a pas de diapositives.

Si LayoutReference n'est pas trouvé dans le fichier maître actuel, une erreur 400 (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'objet à partir des placeholder (s) de la mise en page vers les 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é.

LayoutReference

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

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

  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
}
Champs
Type de LayoutReference. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
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.

Fin des champs qui s'excluent mutuellement.

PredefinedLayout

Types de mise en page prédéfinis. Il s'agit de mises en page courantes dans les présentations. Toutefois, rien ne garantit que ces mises en page sont présentes dans le modèle actuel, car elles peuvent avoir été supprimées ou ne pas faire partie du thème utilisé. De plus, il est possible que les espaces réservés de chaque mise en page aient é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 un titre et un corps.
TITLE_AND_TWO_COLUMNS Mise en page avec un titre et deux colonnes.
TITLE_ONLY Mise en page avec un titre uniquement.
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 sur une seule colonne.
MAIN_POINT Mise en page avec un point principal.
BIG_NUMBER Mise en page avec un titre de 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,

  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
}
Champs
objectId

string

ID d'objet fourni par l'utilisateur pour l'espace réservé identifié ci-dessus à 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 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 caractères restants peuvent inclure ceux-ci, ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). L'ID doit comporter entre 5 et 50 caractères.

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

Type permettant d'identifier un espace réservé dans une mise en page. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
layoutPlaceholder

object (Placeholder)

Espace réservé d'une mise en page qui sera appliqué à une diapositive. Seuls les champs type et index sont nécessaires. Par exemple, une mise en page prédéfinie TITLE_AND_BODY peut généralement comporter 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é d'une mise en page qui sera appliquée à une diapositive.

Fin des champs qui s'excluent mutuellement.

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 caractères restants peuvent inclure ceux-ci, ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). L'ID doit comporter entre 5 et 50 caractères. Si ce champ n'est pas renseigné, un identifiant unique sera 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 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 restera inchangée.

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

string

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

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 indiquée, sous réserve d'une taille minimale. Si aucune taille n'est fournie, la taille de la table sera définie automatiquement.

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

rows

integer

Nombre de lignes dans la table.

columns

integer

Nombre de colonnes dans la table.

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. Si l'objectId est présent, il doit faire référence à un tableau.

text

string

Texte à insérer.

L'insertion d'un caractère de nouvelle ligne crée implicitement un ParagraphMarker à cet index. Le style de paragraphe du nouveau paragraphe sera copié à partir du paragraphe à l'index d'insertion actuel, y compris les listes et les puces.

Les styles de texte pour le texte inséré seront déterminés automatiquement, en conservant généralement le style du texte voisin. Dans la plupart des cas, le texte est ajouté à l'élément TextRun qui existe à 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 à usage privé du plan multilingue de base Unicode (U+E000-U+F8FF) seront supprimés du texte inséré.

insertionIndex

integer

Index où le texte sera inséré, en unités de code Unicode, basé sur les 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 éviter les insertions dans les clusters de graphèmes Unicode. Dans ce cas, le texte sera inséré immédiatement après le groupe de graphèmes.

InsertTableRowsRequest

Insère des lignes dans une table.

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

string

Table dans laquelle insérer les lignes.

cellLocation

object (TableCellLocation)

Emplacement de la cellule de tableau de référence à partir de laquelle 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

Indique s'il faut 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 demande.

InsertTableColumnsRequest

Insère des colonnes dans un tableau.

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

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

string

Table dans laquelle insérer des colonnes.

cellLocation

object (TableCellLocation)

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

Une nouvelle colonne est 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

Indique si de nouvelles colonnes doivent être insérées à 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 demande.

DeleteTableRowRequest

Supprime une ligne d'un tableau.

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

string

Table à partir de laquelle supprimer des lignes.

cellLocation

object (TableCellLocation)

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

La ligne sur laquelle cette cellule s'étend sera supprimée. Si la cellule est fusionnée, plusieurs lignes seront supprimées. Si aucune ligne ne reste dans la table après cette suppression, la table entière est supprimée.

DeleteTableColumnRequest

Supprime une colonne d'une table.

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

string

Table à partir de laquelle supprimer des colonnes.

cellLocation

object (TableCellLocation)

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

La colonne sur laquelle cette cellule s'étend sera supprimée. S'il s'agit d'une cellule fusionnée, plusieurs colonnes seront supprimées. Si aucune colonne ne reste dans le tableau après cette suppression, l'ensemble du tableau est supprimé.

ReplaceAllTextRequest

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

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

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
Champs
replaceText

string

Texte qui remplacera le texte correspondant.

pageObjectIds[]

string

Si cette valeur n'est pas vide, elle limite les correspondances aux éléments de page uniquement sur les pages indiquées.

Renvoie une erreur 400 Bad Request si l'ID d'objet d'une notes master est fourni, ou si une page avec cet ID d'objet n'existe pas dans la présentation.

Critères utilisés pour faire correspondre le texte à remplacer. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
containsText

object (SubstringMatchCriteria)

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

Fin des champs qui s'excluent mutuellement.

SubstringMatchCriteria

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

Représentation JSON
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": 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.
searchByRegex

boolean

Facultatif. "True" si la valeur à rechercher doit être traitée comme une expression régulière. Toutes les barres obliques inverses du modèle doivent être échappées.

  • True : le texte de recherche est traité comme une expression régulière.
  • False : le texte de recherche est traité comme une sous-chaîne pour la correspondance.

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, un group ne contient qu'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 vides hérités sont également supprimés.

UpdatePageElementTransformRequest

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

La mise à jour de la transformation d'un groupe modifie 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 de 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 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 à celle existante et remplace celle-ci par la concaténation obtenue.
ABSOLUTE Remplace la matrice AffineTransform existante par la nouvelle.

UpdateSlidesPositionRequest

Modifie 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 être dans l'ordre de la présentation existante, sans doublons.

insertionIndex

integer

Index où 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 de la présentation (inclus).

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 d'objet de la forme ou du tableau à partir duquel le texte sera supprimé.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

Plage de texte à supprimer, basée sur les 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, qui ne peut pas être supprimé. Range.Type.ALL utilisera les limites correctes, mais il convient d'être prudent 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 saut de ligne implicite, la valeur maximale est de 2 pour textRange.start_index et de 3 pour textRange.end_index.

Si vous supprimez du texte qui chevauche la limite d'un paragraphe, les styles de paragraphe et les listes peuvent être modifiés, car les deux paragraphes sont fusionnés.

Les plages qui n'incluent qu'une seule unité de code d'une paire de substituts sont étendues pour inclure les deux unités de code.

Plage

Spécifie une plage contiguë d'une collection indexée, comme des caractères dans un 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 à la fois startIndex et endIndex.
FROM_START_INDEX La plage commence à startIndex et se poursuit jusqu'à la fin de la collecte. Le paramètre endIndex ne doit pas être spécifié.
ALL Définit la plage sur la longueur totale de la collection. Vous ne devez spécifier ni startIndex, ni endIndex.

CreateImageRequest

Crée une image.

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

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

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 le format de la taille fournie ne correspond pas à celui de l'image, l'image est mise à l'échelle et centrée par rapport à la taille afin de conserver le format. 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 sera placée en haut à gauche de la page.

Type de source d'image. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
url

string

URL de l'image.

L'image est récupérée une seule 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 ni 25 mégapixels, et doivent être au format PNG, JPEG ou GIF.

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

Fin des champs qui s'excluent mutuellement.

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

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 propriété PageElementProperties.size est facultative. Si vous ne spécifiez pas de taille, le serveur en choisit une par défaut.

La propriété PageElementProperties.transform est facultative. La transformation ne doit pas comporter de composantes de cisaillement. Si vous ne spécifiez pas de transformation, la vidéo sera 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 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.

CreateSheetsChartRequest

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

REMARQUE : Pour créer un graphique, vous devez disposer d'au moins l'un des niveaux d'accès OAuth suivants : spreadsheets.readonly, spreadsheets, 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.

Si un ID est spécifié, 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 de mot [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 sera généré.

elementProperties

object (PageElementProperties)

Propriétés des éléments du graphique.

Lorsque le format de la taille fournie ne correspond pas à celui du graphique, ce dernier est mis à l'échelle et centré par rapport à la taille afin de conserver le format. 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 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 de liaison du graphique à la feuille de calcul source. Si aucune valeur n'est spécifiée, le graphique sera une image non associée.

LinkingMode

Mode de liaison 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 non associé sera inséré en tant qu'image.
LINKED Associer le graphique permet de le mettre à jour. 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 caractères restants peuvent inclure ceux-ci, ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). L'ID doit comporter entre 5 et 50 caractères.

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.

Obsolète : utilisez category à la place.

Le line type exact créé est déterminé en fonction de la catégorie et de la façon 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 façon 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 en spécifiez une pour lineCategory, la valeur lineCategory spécifiée est utilisée.

Si vous ne spécifiez aucune de ces options, 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 lorsqu'aucune n'est spécifiée.
BENT Connecteurs coudés, y compris les connecteurs 2 à 5.
CURVED Connecteurs en arc, y compris les connecteurs en arc 2 à 5.

RefreshSheetsChartRequest

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

REMARQUE : L'actualisation des graphiques nécessite au moins l'un des niveaux d'accès OAuth spreadsheets.readonly, spreadsheets, drive.readonly ou drive.

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 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ée. Un seul "*" 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 la valeur par défaut d'une propriété, incluez le nom de son champ dans le masque de champ, mais laissez le champ lui-même 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 modifications 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ée. Un seul "*" 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 la valeur par défaut d'une propriété, incluez le nom de son champ dans le masque de champ, mais laissez le champ lui-même 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ée. Un seul "*" 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 la valeur par défaut d'une propriété, incluez le nom de son champ dans le masque de champ, mais laissez le champ lui-même 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ée. Un seul "*" 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 la valeur par défaut d'une propriété, incluez le nom de son champ dans le masque de champ, mais laissez le champ lui-même 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 tableau représentant le sous-ensemble du tableau auquel les modifications sont appliquées. Si aucune plage de tableau n'est spécifiée, les modifications s'appliqueront à l'ensemble du tableau.

tableCellProperties

object (TableCellProperties)

Propriétés de la cellule 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ée. Un seul "*" 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 d'une cellule de tableau, définissez fields sur "tableCellBackgroundFill.solidFill.color".

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

TableRange

Une plage de tableau 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, imaginons un tableau 3x3 dans lequel 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), l'étendue de ligne = 3 et l'étendue 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)

Emplacement de départ de la plage de tableau.

rowSpan

integer

Étendue de ligne de la plage de tableau.

columnSpan

integer

Étendue de colonne de la plage de 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.

Vous devez spécifier au moins un champ. La racine lineProperties est implicite et ne doit pas être spécifiée. Un seul "*" 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 la valeur par défaut d'une propriété, incluez le nom de son champ dans le masque de champ, mais laissez le champ lui-même 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 est déterminé en comptant les tabulations en début de paragraphe. Pour éviter un espace excessif entre la puce et le paragraphe correspondant, ces tabulations de début sont supprimées par cette demande. Cela peut modifier les index des parties du texte.

Si le paragraphe qui précède immédiatement les paragraphes en cours de mise à jour se trouve dans une liste avec un préréglage correspondant, les paragraphes en cours de mise à jour sont ajoutés à cette 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 du tableau contenant le texte auquel ajouter des puces.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

BulletGlyphPreset

Motifs prédéfinis de glyphes de puces 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 avec ombrage 3D, correspondant au point de code Unicode U+27a2
  • CHECKBOX : carré creux, correspondant au point de code Unicode U+274f
  • CIRCLE : cercle vide, correspondant au point de code Unicode U+25cb
  • DIAMOND : losange plein, correspondant au point de code Unicode U+25c6
  • DIAMONDX : un losange avec un "x", correspondant au point de code Unicode U+2756
  • HOLLOWDIAMOND : losange vide, correspondant au point de code Unicode U+25c7
  • DISC : cercle plein, correspondant à un point de code Unicode U+25cf
  • SQUARE : carré plein, correspondant au point de code Unicode U+25a0
  • STAR : étoile, correspondant à un point de code Unicode U+2605
  • ALPHA : lettre minuscule, comme "a", "b" ou "c".
  • UPPERALPHA  : une lettre majuscule, comme "A", "B" ou "C".
  • DIGIT  : un nombre, comme "1", "2" ou "3".
  • ZERODIGIT : nombre à un chiffre précédé 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 en minuscules, comme "i", "ii" ou "iii".
  • UPPERROMAN  : chiffre romain en majuscules, comme "I", "II" ou "III".
  • LEFTTRIANGLE : triangle pointant vers la gauche, correspondant à un point de code Unicode U+25c4
Enums
BULLET_DISC_CIRCLE_SQUARE Liste à puces avec des glyphes de puce DISC, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de liste.
BULLET_DIAMONDX_ARROW3D_SQUARE Liste à puces avec des glyphes de puce DIAMONDX, ARROW3D et SQUARE pour les trois premiers niveaux d'imbrication de liste.
BULLET_CHECKBOX Liste à puces avec CHECKBOX glyphes de puces pour tous les niveaux d'imbrication de la liste.
BULLET_ARROW_DIAMOND_DISC Liste à puces avec des glyphes de puces ARROW, DIAMOND et DISC pour les trois premiers niveaux d'imbrication de liste.
BULLET_STAR_CIRCLE_SQUARE Liste à puces avec des glyphes de puce STAR, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de liste.
BULLET_ARROW3D_CIRCLE_SQUARE Liste à puces avec des glyphes de puces ARROW3D, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Liste à puces avec des glyphes de puces LEFTTRIANGLE, DIAMOND et DISC pour les trois premiers niveaux d'imbrication de liste.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Liste à puces avec des glyphes de puce DIAMONDX, HOLLOWDIAMOND et SQUARE pour les trois premiers niveaux d'imbrication de liste.
BULLET_DIAMOND_CIRCLE_SQUARE Liste à puces avec des glyphes de puce DIAMOND, CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de liste.
NUMBERED_DIGIT_ALPHA_ROMAN Liste numérotée avec des glyphes numériques DIGIT, ALPHA et ROMAN pour les trois premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Liste numérotée avec des glyphes numériques DIGIT, ALPHA et ROMAN pour les trois premiers niveaux d'imbrication de liste, suivis de parenthèses.
NUMBERED_DIGIT_NESTED Liste numérotée avec des glyphes numériques DIGIT séparés par des points, 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 Liste numérotée avec des glyphes numériques UPPERALPHA, ALPHA et ROMAN pour les trois premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Liste numérotée avec des glyphes numériques UPPERROMAN, UPPERALPHA et DIGIT pour les trois premiers niveaux d'imbrication de liste, suivis de points.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Liste numérotée avec des glyphes numériques ZERODIGIT, ALPHA et ROMAN pour les trois premiers niveaux d'imbrication de liste, suivis de points.

ReplaceAllShapesWithImageRequest

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 ne prennent pas la forme des formes.

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

  "containsText": {
    object (SubstringMatchCriteria)
  }

  "imageUrl": string
}
Champs
replaceMethod
(deprecated)

enum (ReplaceMethod)

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)

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 en spécifiez une pour replaceMethod, la valeur replaceMethod spécifiée est utilisée.

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

pageObjectIds[]

string

Si cette valeur n'est pas vide, elle limite les correspondances aux éléments de page uniquement sur les pages indiquées.

Renvoie une erreur 400 Bad Request si l'ID d'objet de la page d'un notes page ou d'un notes master est fourni, ou si une page avec cet ID d'objet n'existe pas dans la présentation.

Critères auxquels les formes doivent correspondre pour être remplacées. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
containsText

object (SubstringMatchCriteria)

Si cette option est définie, cette requête remplacera toutes les formes contenant le texte indiqué.

Fin des champs qui s'excluent mutuellement.
Type de source d'image. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
imageUrl

string

URL de l'image.

L'image est récupérée une seule 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 ni 25 mégapixels, et doivent être au format PNG, JPEG ou GIF.

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.

Fin des champs qui s'excluent mutuellement.

ReplaceMethod

Méthode de remplacement.

Enums
CENTER_INSIDE Redimensionne et centre l'image pour l'adapter aux limites de la forme d'origine, tout en conservant le format de l'image. La taille de l'image affichée peut être inférieure à celle de la forme. Il s'agit de la méthode par défaut lorsqu'aucune n'est spécifiée.
CENTER_CROP Met à l'échelle et centre l'image pour remplir les limites de la forme d'origine. L'image peut être recadrée pour remplir la forme. La taille de l'image affichée sera identique à celle de la forme d'origine.

ImageReplaceMethod

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 Redimensionne et centre l'image pour l'adapter aux limites de la forme d'origine, tout en conservant le format de l'image. La taille de l'image affichée peut être inférieure à celle de la forme. Il s'agit de la méthode par défaut lorsqu'aucune n'est spécifiée.
CENTER_CROP Met à l'échelle et centre l'image pour remplir les limites de la forme d'origine. L'image peut être recadrée pour remplir la forme. La taille de l'image affichée sera la même que celle de la forme d'origine.

DuplicateObjectRequest

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

Lorsque vous dupliquez une diapositive, elle est créée immédiatement après celle que vous avez spécifiée. Lorsque vous dupliquez un élément de page, la copie est placée sur la même page, au même emplacement 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 lorsqu'une diapositive ou un élément de page de groupe sont dupliqués. Ce mappage définit la façon dont les ID des objets dupliqués sont générés : les clés sont les ID des objets d'origine et leurs valeurs sont les ID qui seront attribués aux objets dupliqués correspondants. L'ID dupliqué de l'objet source peut également être spécifié dans cette carte, en utilisant la même valeur du champ objectId comme clé et le nouvel ID souhaité comme valeur.

Toutes les clés doivent correspondre à des 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 caractères restants 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 ID ne doit pas être inférieure à 5 ni supérieure à 50.

Si des ID d'objets sources sont omis de la carte, un nouvel ID aléatoire sera attribué. Si la carte est vide ou non définie, tous les objets en double recevront un nouvel ID aléatoire.

UpdateTextStyleRequest

Mettez à jour le style du texte dans un Shape ou un 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 contenant le texte à mettre en forme.

cellLocation

object (TableCellLocation)

Emplacement de la cellule dans le tableau contenant le texte à mettre en forme. Si objectId fait référence à un tableau, cellLocation doit avoir une valeur. Sinon, il ne doit pas l'être.

style

object (TextStyle)

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

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

Certaines modifications de style de texte peuvent entraîner d'autres modifications destinées à refléter le comportement de l'éditeur Slides. Pour en savoir plus, consultez la documentation de TextStyle.

textRange

object (Range)

Plage de texte à mettre en forme.

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ée. Un seul "*" peut être utilisé comme raccourci pour lister tous les champs.

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

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

ReplaceAllShapesWithSheetsChartRequest

Remplace toutes les formes correspondant aux critères indiqués par le graphique Google Sheets fourni. Le graphique sera 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'un des niveaux d'accès OAuth suivants : spreadsheets.readonly, spreadsheets, 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 indiqué.

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 de liaison du graphique à la feuille de calcul source. Si aucune valeur n'est spécifiée, le graphique sera une image non associée.

pageObjectIds[]

string

Si cette valeur n'est pas vide, elle limite les correspondances aux éléments de page uniquement sur les pages indiquées.

Renvoie une erreur 400 Bad Request si l'ID d'objet de la page d'un notes page ou d'un notes master est fourni, ou si une page avec cet ID d'objet n'existe pas dans la présentation.

LinkingMode

Mode de liaison 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 non associé sera inséré en tant qu'image.
LINKED Associer le graphique permet de le mettre à jour. 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 conservé 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 du tableau contenant le texte dont vous souhaitez supprimer les puces.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

Plage de texte à partir de laquelle supprimer les puces, en fonction des index TextElement.

UpdateParagraphStyleRequest

Met à jour le style de tous les paragraphes d'un Shape ou d'un Table qui chevauchent 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 contenant le texte à mettre en forme.

cellLocation

object (TableCellLocation)

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

style

object (ParagraphStyle)

Style du paragraphe.

textRange

object (Range)

Plage de texte contenant le ou les paragraphes à mettre en forme.

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ée. Un seul "*" 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 la valeur par défaut d'une propriété, incluez le nom de son champ dans le masque de champ, mais laissez le champ lui-même non défini.

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

borderPosition

enum (BorderPosition)

Position de la bordure dans la plage du tableau à laquelle les modifications doivent s'appliquer. Si aucune position de bordure n'est spécifiée, les modifications s'appliqueront à toutes les bordures de la plage de 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ée. Un seul "*" peut être utilisé comme raccourci pour lister tous les champs.

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

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

BorderPosition

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 extérieures 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 des index basés sur zéro spécifiant les colonnes à mettre à jour. Si aucun index 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 400 (requête incorrecte) 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ée. Un seul "*" 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 "columnWidth" est inclus dans le masque de champ, mais que la propriété n'est pas définie,la largeur de la colonne sera 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 des index basés sur zéro spécifiant les lignes à mettre à jour. Si aucun index 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ée. Un seul "*" peut être utilisé comme raccourci pour lister tous les champs.

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

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

MergeTableCellsRequest

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

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

UnmergeTableCellsRequest

Annule la fusion des 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 tableau spécifiant les cellules du tableau à dissocier.

Toutes les cellules fusionnées de cette plage seront séparées, et les cellules déjà séparées ne seront pas affectées. Si la plage ne comporte aucune cellule fusionnée, la requête n'aura aucun effet. Si du texte figure dans l'une des cellules fusionnées, il restera dans la cellule en haut à gauche ("tête") du bloc de cellules non fusionnées obtenu.

GroupObjectsRequest

Regroupe des objets pour créer un groupe d'objets. Par exemple, les groupes 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 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 caractères restants peuvent inclure ceux-ci, ainsi qu'un trait d'union ou un deux-points (correspond à l'expression régulière [a-zA-Z0-9_-:]). L'ID doit comporter entre 5 et 50 caractères.

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

childrenObjectIds[]

string

ID d'objet des objets à regrouper.

Seuls les éléments de page peuvent être regroupés. Il doit y avoir au moins deux éléments de page sur la même page qui ne se trouvent pas déjà dans un autre groupe. Certains éléments de page, tels que videos, tables et placeholders ne peuvent pas être regroupés.

UngroupObjectsRequest

Dissocie les objets, comme groups.

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

string

ID d'objet des objets à dissocier.

Seuls les groups qui ne sont pas inclus dans d'autres groups peuvent être dissociés. Tous les groupes doivent se trouver sur la même page. Le groupe lui-même est supprimé. La taille et la position visuelles de tous les 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 modifications sont appliquées.

title

string

Titre du texte alternatif mis à jour pour l'élément de page. Si elle n'est pas définie, la valeur existante sera conservée. Le titre est exposé aux lecteurs d'écran et à d'autres interfaces d'accessibilité. N'utilisez que des valeurs lisibles par un humain et 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 elle n'est pas définie, la valeur existante sera conservée. La description est exposée aux lecteurs d'écran et à d'autres interfaces d'accessibilité. N'utilisez que des valeurs lisibles par un humain et liées au contenu de l'élément de page.

ReplaceImageRequest

Remplace une image existante par une nouvelle.

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

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

  "url": string
}
Champs
imageObjectId

string

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

imageReplaceMethod

enum (ImageReplaceMethod)

Méthode de remplacement.

Type de source d'image. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
url

string

URL de l'image.

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

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.

Fin des champs qui s'excluent mutuellement.

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 à 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ée. Un seul "*" 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 la valeur par défaut d'une propriété, incluez le nom de son champ dans le masque de champ, mais laissez le champ lui-même non défini.

UpdatePageElementsZOrderRequest

Met à jour l'ordre Z des éléments de la page. L'ordre Z est l'ordre des éléments sur la page, de l'arrière-plan vers l'avant-plan. L'élément de page au premier plan peut masquer les éléments situés derrière lui.

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

string

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

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

operation

enum (ZOrderOperation)

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

Lorsque vous appliquez l'opération à plusieurs éléments de page, les ordres Z relatifs au sein de ces éléments de page avant l'opération sont conservés.

ZOrderOperation

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

Enums
Z_ORDER_OPERATION_UNSPECIFIED Opération non spécifiée.
BRING_TO_FRONT Place les éléments de la page au premier plan.
BRING_FORWARD Fait avancer les éléments de la page d'un élément par rapport à celui le plus en avant parmi les éléments de page spécifiés.
SEND_BACKWARD Envoie les éléments de la page vers l'arrière d'un élément par rapport à celui qui se trouve le plus en arrière parmi les éléments de page spécifiés.
SEND_TO_BACK Envoie les éléments de la page à l'arrière-plan.

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.

Il est possible que la ligne soit redirigée après la modification de sa catégorie.

lineCategory

enum (LineCategory)

Catégorie de ligne à laquelle effectuer la mise à jour.

Le line type exact est déterminé en fonction de la catégorie à mettre à jour et de la façon dont il est routé 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 page connectés.

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

string

ID d'objet de la ligne à rediriger.

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

InsertCommentRequest

Insère un CommentThread dans la présentation.

Représentation JSON
{
  "content": string,
  "assigneeEmailAddress": string,

  "objectId": string,
  "shapeTextAnchor": {
    object (ShapeTextAnchor)
  },
  "tableCellTextAnchor": {
    object (TableCellTextAnchor)
  },
  "tableAnchor": {
    object (TableAnchor)
  }
}
Champs
content

string

Texte du commentaire, en texte brut.

Ce contenu textuel sera traité de la même manière que les commentaires créés dans l'éditeur Slides. Il aura des comportements similaires pour la mise en forme, les notifications, etc.

Ce champ est obligatoire et ne doit pas dépasser 2 048 unités de code UTF-8.

assigneeEmailAddress

string

Facultatif. Adresse e-mail de la personne à laquelle le commentaire est attribué.

Laissez ce champ vide pour un commentaire non attribué.

Ne doit pas dépasser 2 048 unités de code UTF-8.

Emplacement dans la présentation auquel le commentaire est associé. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
objectId

string

ID d'objet de Page ou PageElement associé à ce commentaire. Si l'objectId spécifié est un Group, le commentaire sera ancré à 100 descendants non groupés du groupe au maximum.

shapeTextAnchor

object (ShapeTextAnchor)

Ancre un commentaire à une plage de texte spécifique dans un Shape.

tableCellTextAnchor

object (TableCellTextAnchor)

Ancre un commentaire à une plage de texte spécifique dans une seule cellule d'un Table.

tableAnchor

object (TableAnchor)

Ancre un commentaire à une plage de cellules spécifique dans une Table. Renvoie une erreur 400 Bad Request si aucune cellule de la plage ne contient de texte.

Fin des champs qui s'excluent mutuellement.

ShapeTextAnchor

Ancre vers une plage de texte spécifique dans un Shape's text. Pour insérer des commentaires dans les notes du présentateur, utilisez ShapeTextAnchor avec l'ID d'objet speaker notes.

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

string

ID d'objet de l'élément de page contenant le texte.

textRange

object (Range)

Plage de texte pour l'ancrage.

TableCellTextAnchor

Ancre vers une plage de texte spécifique dans le TextElement du TableCell.

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

string

ID d'objet de la table contenant la cellule.

cellLocation

object (TableCellLocation)

Emplacement de la cellule dans le tableau.

textRange

object (Range)

Plage de texte pour l'ancrage.

TableAnchor

Ancre vers une plage de cellules spécifique dans une Table. Permet d'ancrer un commentaire à l'ensemble du texte de chaque cellule d'une plage dans un tableau.

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

string

ID d'objet de la table.

tableRange

object (TableRange)

Plage de cellules du tableau auxquelles appliquer l'ancrage. Si ce paramètre est omis, toutes les cellules du tableau seront utilisées pour l'ancrage.

AddCommentReplyRequest

Insère une réponse Post dans un CommentThread.

Représentation JSON
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
Champs
commentId

string

ID de la CommentThread à laquelle ajouter la réponse.

post

object (Post)

Le Post représentant la réponse.

UpdateCommentPostRequest

Met à jour un Post dans un CommentThread.

Renvoie une erreur 400 (requête incorrecte) si :

  • L'utilisateur à l'origine de la demande n'est pas l'auteur du post.
Représentation JSON
{
  "commentId": string,
  "postId": string,
  "content": string
}
Champs
commentId

string

ID de la CommentThread à laquelle appartient le post.

postId

string

ID du post en cours de modification.

content

string

Nouveau texte du commentaire, en texte brut.

Ce contenu textuel sera traité de la même manière que les commentaires créés dans l'éditeur Slides. Il aura des comportements similaires pour la mise en forme, les notifications, etc.

Ce champ est obligatoire et ne doit pas dépasser 2 048 unités de code UTF-8.

DeleteCommentRequest

Supprime un CommentThread.

Renvoie une erreur 400 Bad Request si l'utilisateur qui envoie la requête n'est pas l'auteur de headPost.

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

string

ID de l'CommentThread en cours de suppression.

DeleteCommentReplyRequest

Supprime une réponse Post d'une CommentThread.

Renvoie une erreur 400 (requête incorrecte) si :

  • L'utilisateur à l'origine de la demande n'est pas l'auteur du post.

  • Le post de réponse contient un comment action.

  • Le post de réponse contient un assignee.

Représentation JSON
{
  "commentId": string,
  "postId": string
}
Champs
commentId

string

ID de la CommentThread à laquelle appartient le post.

postId

string

ID de la réponse Post à supprimer.