Requête
Un seul type de mise à jour à appliquer à une présentation.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union kind . Type de mise à jour. Un seul champ est requis.
kind ne peut être qu'un des éléments suivants:
|
|
createSlide
|
Crée une diapositive. |
createShape
|
Crée une forme. |
createTable
|
Crée une table. |
insertText
|
Insère du texte dans une forme ou une cellule de tableau. |
insertTableRows
|
Insère des lignes dans une table. |
insertTableColumns
|
Insère des colonnes dans un tableau. |
deleteTableRow
|
Supprime une ligne d'une table. |
deleteTableColumn
|
Supprime une colonne d'une table. |
replaceAllText
|
Remplace toutes les instances du texte spécifié. |
deleteObject
|
Supprime une page ou un élément de page de la présentation. |
updatePageElementTransform
|
Met à jour la transformation d'un élément de page. |
updateSlidesPosition
|
Met à jour la position d'un ensemble de diapositives dans la présentation. |
deleteText
|
Supprime le texte d'une forme ou d'une cellule de tableau. |
createImage
|
Crée une image. |
createVideo
|
Crée une vidéo. |
createSheetsChart
|
Crée un graphique Google Sheets intégré. |
createLine
|
Crée une ligne. |
refreshSheetsChart
|
Actualise un graphique Google Sheets. |
updateShapeProperties
|
Met à jour les propriétés d'un |
updateImageProperties
|
Met à jour les propriétés d'un |
updateVideoProperties
|
Met à jour les propriétés d'un |
updatePageProperties
|
Met à jour les propriétés d'un |
updateTableCellProperties
|
Met à jour les propriétés d'un |
updateLineProperties
|
Met à jour les propriétés d'un |
createParagraphBullets
|
Crée des puces pour les paragraphes. |
replaceAllShapesWithImage
|
Remplace toutes les formes correspondant à certains critères par une image. |
duplicateObject
|
Duplique un élément de diapositive ou de page. |
updateTextStyle
|
Met à jour le style du texte dans un élément |
replaceAllShapesWithSheetsChart
|
Remplace toutes les formes correspondant à certains critères par un graphique Google Sheets. |
deleteParagraphBullets
|
Supprime les puces des paragraphes. |
updateParagraphStyle
|
Met à jour le style des paragraphes dans un élément |
updateTableBorderProperties
|
Met à jour les propriétés des bordures de la table dans un |
updateTableColumnProperties
|
Met à jour les propriétés d'une colonne |
updateTableRowProperties
|
Met à jour les propriétés d'une ligne |
mergeTableCells
|
Fusionne les cellules d'un |
unmergeTableCells
|
Défusionne les cellules d'un |
groupObjects
|
Regroupe des objets, tels que des éléments de page. |
ungroupObjects
|
Dissocie des objets, tels que |
updatePageElementAltText
|
Met à jour le titre et/ou la description du texte alternatif d'un |
replaceImage
|
Remplace une image existante par une nouvelle. |
updateSlideProperties
|
Met à jour les propriétés d'une diapositive |
updatePageElementsZOrder
|
Met à jour l'ordre Z de |
updateLineCategory
|
Met à jour la catégorie d'un |
rerouteLine
|
Redirige un |
CreateSlideRequest
Crée une diapositive.
Représentation JSON |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
Champs | |
---|---|
objectId
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si vous ne spécifiez pas d'ID, un ID unique est généré. |
insertionIndex
|
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
|
Référence de mise en page de la diapositive à insérer, en fonction du maître actuel, qui peut être l'un des éléments suivants:
Si le LayoutReference n'est pas trouvé dans le maître actuel, une erreur 400 "Request not valid" (Requête non valide) est renvoyée.
Si vous ne spécifiez pas de référence de mise en page, la diapositive utilise la mise en page |
placeholderIdMappings[]
|
Liste facultative de mappages d'ID d'objets à partir des |
LayoutReference
Référence de la mise en page des diapositives. Il peut s'agir de l'un des éléments suivants:
- Une mise en page prédéfinie
- Une des mises en page de la présentation.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union kind . Type de LayoutReference.
kind ne peut être qu'un des éléments suivants:
|
|
predefinedLayout
|
Mise en page prédéfinie. |
layoutId
|
ID de mise en page: ID de l'objet de l'une des mises en page de la présentation. |
PredefinedLayout
Types de mise en page prédéfinis. Il s'agit de mises en page couramment utilisées dans les présentations. Toutefois, rien ne garantit que ces mises en page sont présentes dans le master actuel, car elles ont pu être supprimées ou ne pas faire partie du thème utilisé. De plus, les espaces réservés de chaque mise en page peuvent avoir été modifiés.
Enums | |
---|---|
PREDEFINED_LAYOUT_UNSPECIFIED
|
Mise en page non spécifiée. |
BLANK
|
Mise en page vide, sans espace réservé. |
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 ne comportant qu'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 dans une seule colonne. |
MAIN_POINT
|
Mise en page avec un point principal. |
BIG_NUMBER
|
Mise en page avec un grand titre numérique. |
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 |
Champs | |
---|---|
objectId
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si vous ne spécifiez pas d'ID, un ID unique est généré. |
Champ d'union kind . Type permettant d'identifier un espace réservé dans une mise en page.
kind ne peut être qu'un des éléments suivants:
|
|
layoutPlaceholder
|
Espace réservé d'une mise en page qui sera appliqué à une diapositive. Seuls |
layoutPlaceholderObjectId
|
ID de l'objet de l'espace réservé d'une mise en page qui sera appliquée à une diapositive. |
CreateShapeRequest
Crée une forme.
Représentation JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Champs | |
---|---|
objectId
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière |
elementProperties
|
Propriétés de l'élément pour la forme. |
shapeType
|
Type de forme. |
PageElementProperties
Propriétés courantes d'un élément de page.
Remarque: Lorsque vous créez initialement un PageElement
, l'API peut modifier les valeurs de size
et de transform
, mais la taille visuelle ne change pas.
Représentation JSON |
---|
{ "pageObjectId": string, "size": { object ( |
Champs | |
---|---|
pageObjectId
|
ID de l'objet de la page sur laquelle se trouve l'élément. |
size
|
Taille de l'élément. |
transform
|
Transformation de l'élément. |
CreateTableRequest
Crée une table.
Représentation JSON |
---|
{
"objectId": string,
"elementProperties": {
object ( |
Champs | |
---|---|
objectId
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si vous ne spécifiez pas d'ID, un ID unique est généré. |
elementProperties
|
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 table est redimensionnée automatiquement. Les transformations de table doivent avoir une échelle de 1 et ne comporter aucun composant de cisaillement. Si aucune transformation n'est fournie, le tableau est centré sur la page. |
rows
|
Nombre de lignes dans la table. |
columns
|
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 ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la forme ou de la table dans laquelle le texte sera inséré. |
cellLocation
|
Emplacement facultatif de la cellule de table si le texte doit être inséré dans une cellule de table. Le cas échéant, l'attribut objectId doit faire référence à une table. |
text
|
Texte à insérer.
L'insertion d'un caractère de nouvelle ligne crée implicitement un
Les styles de texte pour le texte inséré sont déterminés automatiquement, en conservant généralement le style du texte voisin. Dans la plupart des cas, le texte est ajouté à l' Certains caractères de contrôle (U+0000-U+0008, U+000C-U+001F) et 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
|
Indice où le texte sera inséré, en unités de code Unicode, en fonction des indices L'index est basé sur zéro et calculé à partir du début de la chaîne. L'index peut être ajusté pour empêcher les insertions dans les groupes de graphèmes Unicode. Dans ce cas, le texte est inséré immédiatement après le cluster de graphèmes. |
InsertTableRowsRequest
Insère des lignes dans une table.
Représentation JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
Champs | |
---|---|
tableObjectId
|
Tableau dans lequel insérer des lignes. |
cellLocation
|
Emplacement de la cellule de la table 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 fusionnée, une nouvelle ligne est insérée au-dessus (ou en dessous) de la cellule fusionnée. |
insertBelow
|
Indique si de nouvelles lignes doivent être insérées sous l'emplacement de la cellule de référence.
|
number
|
Nombre de lignes à insérer. 20 maximum par requête. |
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 ( |
Champs | |
---|---|
tableObjectId
|
Tableau dans lequel insérer des colonnes. |
cellLocation
|
Emplacement de la cellule de la table 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 contenant la cellule de référence. Si la cellule de référence est fusionnée, une nouvelle colonne est insérée à gauche (ou à droite) de la cellule fusionnée. |
insertRight
|
Indique si de nouvelles colonnes doivent être insérées à droite de l'emplacement de la cellule de référence.
|
number
|
Nombre de colonnes à insérer. 20 maximum par requête. |
DeleteTableRowRequest
Supprime une ligne d'une table.
Représentation JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
Champs | |
---|---|
tableObjectId
|
Table à partir de laquelle supprimer des lignes. |
cellLocation
|
Emplacement de la cellule de la table de référence à partir de laquelle 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. 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 ( |
Champs | |
---|---|
tableObjectId
|
Table à partir de laquelle supprimer des colonnes. |
cellLocation
|
Emplacement de la cellule de la table de référence à partir de laquelle une colonne sera supprimée. La colonne sur laquelle s'étend cette cellule sera supprimée. S'il s'agit d'une cellule fusionnée, plusieurs colonnes seront supprimées. Si aucune colonne ne reste dans la table après cette suppression, la table entière est supprimée. |
ReplaceAllTextRequest
Remplace toutes les instances de texte correspondant à un critère par replace text
.
Représentation JSON |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
Champs | |
---|---|
replaceText
|
Texte qui remplacera le texte correspondant. |
pageObjectIds[]
|
Si ce champ n'est pas vide, les correspondances sont limitées aux éléments de page uniquement sur les pages données.
Renvoie une erreur 400 "Bad Request" si l'ID de l'objet de page d'un |
Champ d'union criteria . Critères utilisés pour faire correspondre le texte à remplacer.
criteria ne peut être qu'un des éléments suivants:
|
|
containsText
|
Recherche du texte dans une forme correspondant à cette sous-chaîne. |
SubstringMatchCriteria
Critère correspondant à une chaîne de texte spécifique dans une forme ou un tableau.
Représentation JSON |
---|
{ "text": string, "matchCase": boolean, "searchByRegex": boolean } |
Champs | |
---|---|
text
|
Texte à rechercher dans la forme ou le tableau. |
matchCase
|
Indique si la recherche doit respecter la casse:
|
searchByRegex
|
Facultatif. "True" si la valeur de recherche doit être traitée comme une expression régulière. Les barres obliques inverses du modèle doivent être échappées.
|
DeleteObjectRequest
Supprime un objet, pages
ou page elements
, de la présentation.
Représentation JSON |
---|
{ "objectId": string } |
Champs | |
---|---|
objectId
|
ID de l'objet de la page ou de l'élément de page à supprimer.
Si, après une opération de suppression, un Si vous supprimez un espace réservé dans 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 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 ( |
Champs | |
---|---|
objectId
|
ID de l'objet de l'élément de page à mettre à jour. |
transform
|
Matrice de transformation d'entrée utilisée pour mettre à jour l'élément de page. |
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 à l'ancienne et la remplace par la concaténation obtenue. |
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[]
|
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
|
Indice à partir duquel les diapositives doivent être insérées, en fonction de la disposition 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 ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la forme ou du tableau à partir duquel le texte sera supprimé. |
cellLocation
|
Emplacement facultatif de la cellule de tableau si le texte doit être supprimé d'une cellule de tableau. Le cas échéant, l'attribut objectId doit faire référence à une table. |
textRange
|
Plage de texte à supprimer, en fonction des index
Un caractère de nouvelle ligne implicite est toujours ajouté à la fin du texte d'une forme ou d'une cellule de tableau. Il ne peut pas être supprimé.
Si vous supprimez du texte qui traverse une limite de 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 substitution sont développées pour inclure les deux unités de code. |
Plage
Spécifie une plage contiguë d'une collection indexée, comme les caractères d'un texte.
Représentation JSON |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum ( |
Champs | |
---|---|
startIndex
|
Index facultatif basé sur zéro du début de la collection. Obligatoire pour les plages |
endIndex
|
Index facultatif basé sur zéro de la fin de la collection. Obligatoire pour les plages |
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
|
Démarre la plage à startIndex et se poursuit jusqu'à la fin de la collection. endIndex ne doit pas être spécifié.
|
ALL
|
Définit la plage sur la longueur totale de la collection. Vous ne devez pas spécifier à la fois startIndex et endIndex .
|
CreateImageRequest
Crée une image.
Représentation JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Champs | |
---|---|
objectId
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si vous ne spécifiez pas d'ID, un ID unique est généré. |
elementProperties
|
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 redimensionnée 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é
La propriété |
Champ d'union image_source . Type de source d'image.
image_source ne peut être qu'un des éléments suivants:
|
|
url
|
URL de l'image. L'image est récupérée une fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, 25 mégapixels et ê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 |
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 une habilitation OAuth drive, drive.readonly ou drive.file.
Représentation JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Champs | |
---|---|
objectId
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si vous ne spécifiez pas d'ID, un ID unique est généré. |
elementProperties
|
Propriétés de l'élément pour la vidéo.
La propriété
La propriété |
source
|
Source vidéo. |
id
|
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, l'ID est 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.https://drive.google.com/file/d/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 à l'en-tête HTTP pour un sous-ensemble d'anciens fichiers. Pour en savoir plus, consultez la section Accéder aux fichiers partagés par lien à l'aide de clés de ressources. |
CreateSheetsChartRequest
Crée un graphique Google Sheets intégré.
REMARQUE: La création de graphiques nécessite au moins l'un des champs d'application OAuth spreadsheets.readonly, spreadsheets, drive.readonly, drive.file ou drive.
Représentation JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Champs | |
---|---|
objectId
|
ID d'objet fourni par l'utilisateur. Le cas échéant, 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 un caractère de mot [a-zA-Z0-9_] et être suivi d'un nombre quelconque de caractères suivants [a-zA-Z0-9_-:]. Sa longueur ne doit pas être inférieure à cinq ni supérieure à 50 caractères. Si ce champ n'est pas renseigné, un identifiant unique sera généré. |
elementProperties
|
Propriétés des éléments du graphique. Lorsque le format de la taille fournie ne correspond pas à celui du graphique, le graphique 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
|
ID de la feuille de calcul Google Sheets contenant le graphique. Vous devrez peut-être ajouter une clé de ressource à l'en-tête HTTP pour un sous-ensemble d'anciens fichiers. Pour en savoir plus, consultez la section Accéder aux fichiers partagés par lien à l'aide de clés de ressources. |
chartId
|
ID du graphique spécifique dans la feuille de calcul Google Sheets. |
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
|
En associant le graphique, vous pouvez 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 ( |
Champs | |
---|---|
objectId
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si vous ne spécifiez pas d'ID, un ID unique est généré. |
elementProperties
|
Propriétés de l'élément pour la ligne. |
lineCategory
|
Catégorie de la ligne à créer.
Obsolète
: utilisez plutôt
La
Si vous spécifiez à la fois un |
category
|
Catégorie de la ligne à créer.
La
Si vous spécifiez à la fois un
Si vous ne spécifiez pas de valeur pour
Si vous ne spécifiez aucune de ces options, |
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 tordus, 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: Pour actualiser les graphiques, vous devez disposer au moins d'un des champs d'application OAuth spreadsheets.readonly, spreadsheets, drive.readonly ou drive.
Représentation JSON |
---|
{ "objectId": string } |
Champs | |
---|---|
objectId
|
ID de l'objet du graphique à actualiser. |
UpdateShapePropertiesRequest
Mettez à jour les propriétés d'un Shape
.
Représentation JSON |
---|
{
"objectId": string,
"shapeProperties": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la forme à laquelle les mises à jour sont appliquées. |
shapeProperties
|
Propriétés de la forme à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour modifier la couleur de remplissage unie de l'arrière-plan de la forme, définissez 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 lui-même non défini. |
UpdateImagePropertiesRequest
Mettez à jour les propriétés d'un Image
.
Représentation JSON |
---|
{
"objectId": string,
"imageProperties": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de l'image à laquelle les mises à jour sont appliquées. |
imageProperties
|
Propriétés de l'image à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour mettre à jour la couleur du contour de l'image, définissez 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 lui-même non défini. |
UpdateVideoPropertiesRequest
Mettez à jour les propriétés d'un Video
.
Représentation JSON |
---|
{
"objectId": string,
"videoProperties": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la vidéo à laquelle les mises à jour sont appliquées. |
videoProperties
|
Propriétés vidéo à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour mettre à jour la couleur du contour de la vidéo, définissez 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 lui-même non défini. |
UpdatePagePropertiesRequest
Met à jour les propriétés d'un Page
.
Représentation JSON |
---|
{
"objectId": string,
"pageProperties": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la page à laquelle la mise à jour s'applique. |
pageProperties
|
Propriétés de la page à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour modifier la couleur de remplissage unie de l'arrière-plan de la page, définissez 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 lui-même non défini. |
UpdateTableCellPropertiesRequest
Mettez à jour les propriétés d'un TableCell
.
Représentation JSON |
---|
{ "objectId": string, "tableRange": { object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la table. |
tableRange
|
Plage du tableau représentant le sous-ensemble de la table auquel les mises à jour sont appliquées. Si aucune plage de table n'est spécifiée, les mises à jour s'appliquent à l'ensemble de la table. |
tableCellProperties
|
Propriétés des cellules de la table à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour modifier la couleur de remplissage unie de l'arrière-plan des cellules de la table, définissez 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 lui-même non défini. |
TableRange
Une plage de table représente une référence à un sous-ensemble d'une table.
Notez que les cellules spécifiées par une plage de table ne forment pas nécessairement un rectangle. Par exemple, imaginons que nous ayons un tableau 3 x 3 dans lequel toutes les cellules de la dernière ligne sont fusionnées. La table se présente comme suit:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Une plage de tableau avec l'emplacement (0, 0), la plage de lignes = 3 et la plage de colonnes = 2 spécifie les cellules suivantes:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
Représentation JSON |
---|
{
"location": {
object ( |
Champs | |
---|---|
location
|
Emplacement de début de la plage du tableau. |
rowSpan
|
Nombre de lignes de la plage du tableau. |
columnSpan
|
Nombre de colonnes de la plage du tableau. |
UpdateLinePropertiesRequest
Met à jour les propriétés d'un Line
.
Représentation JSON |
---|
{
"objectId": string,
"lineProperties": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la ligne à laquelle la mise à jour s'applique. |
lineProperties
|
Propriétés de la ligne à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour modifier la couleur de remplissage unie de la ligne, définissez 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 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 sera déterminé en comptant les tabulations avant chaque paragraphe. Pour éviter un espace excessif entre la puce et le paragraphe correspondant, ces tabulations initiales sont supprimées par cette requête. Cela peut modifier les indices de certaines parties du texte.
Si le paragraphe immédiatement avant les paragraphes mis à jour figure dans une liste avec un préréglage correspondant, les paragraphes mis à jour sont ajoutés à cette liste précédente.
Représentation JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la forme ou du tableau contenant le texte auquel ajouter des puces. |
cellLocation
|
Emplacement facultatif de la cellule de tableau si le texte à modifier se trouve dans une cellule de tableau. Le cas échéant, l'attribut objectId doit faire référence à une table. |
textRange
|
Plage de texte à laquelle appliquer les préréglages de puces, en fonction des index |
bulletPreset
|
Types de glyphes à utiliser. La valeur par défaut est le préréglage |
BulletGlyphPreset
Modèles prédéfinis de glyphes à puces pour les listes dans le texte.
Ces modèles utilisent les types de puces suivants:
-
ARROW
: une flèche, correspondant à un point de code Unicode U+2794 -
ARROW3D
: flèche avec un ombrage 3D, correspondant à un point de code Unicode U+27a2 -
CHECKBOX
: carré vide, correspondant à un point de code Unicode U+274f -
CIRCLE
: cercle vide, correspondant à un point de code Unicode U+25cb -
DIAMOND
: diamant plein, correspondant à un point de code Unicode U+25c6 -
DIAMONDX
: losange avec un "x", correspondant à un point de code Unicode U+2756 -
HOLLOWDIAMOND
: losange vide, correspondant à un point de code Unicode U+25c7 -
DISC
: cercle plein, correspondant à un point de code Unicode U+25cf -
SQUARE
: carré plein, correspondant à un point de code Unicode U+25a0 -
STAR
: étoile, correspondant au point de code Unicode U+2605 -
ALPHA
: lettre minuscule, comme "a", "b" ou "c". -
UPPERALPHA
: lettre majuscule, comme "A", "B" ou "C". -
DIGIT
: un nombre, comme "1", "2" ou "3". -
ZERODIGIT
: nombre dont les chiffres à un seul chiffre sont précédés d'un zéro, par exemple "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, comme "i", "ii" ou "iii". -
UPPERROMAN
: chiffre romain majuscule, comme "I", "II" ou "III". -
LEFTTRIANGLE
: Triangle pointant vers la gauche, correspondant à un point de code Unicode U+25c4
Enums | |
---|---|
BULLET_DISC_CIRCLE_SQUARE
|
Liste à puces avec des glyphes de puces DISC , CIRCLE et SQUARE pour les trois premiers niveaux d'imbrication de liste.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Liste à puces avec des glyphes de puces DIAMONDX , ARROW3D et SQUARE pour les trois premiers niveaux d'imbrication de liste.
|
BULLET_CHECKBOX
|
Liste à puces avec des glyphes de puces CHECKBOX 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 puces 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 puces DIAMONDX , HOLLOWDIAMOND et SQUARE pour les trois premiers niveaux d'imbrication de liste.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Liste à puces avec des glyphes de puces 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 la 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 donné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 ( |
Champs | |
---|---|
replaceMethod
|
Méthode de remplacement.
Obsolète
: utilisez plutôt
Si vous spécifiez à la fois un |
imageReplaceMethod
|
Méthode de remplacement d'image.
Si vous spécifiez à la fois un
Si vous ne spécifiez pas de valeur pour Si vous ne spécifiez aucune de ces options, CENTER_INSIDE est utilisé. |
pageObjectIds[]
|
Si ce champ n'est pas vide, les correspondances sont limitées aux éléments de page uniquement sur les pages données.
Renvoie une erreur 400 "Bad Request" si l'ID d'objet de page d'un |
Champ d'union criteria . Critères que les formes doivent respecter pour être remplacées.
criteria ne peut être qu'un des éléments suivants:
|
|
containsText
|
Si ce paramètre est défini, cette requête remplacera toutes les formes contenant le texte donné. |
Champ d'union image_source . Type de source d'image.
image_source ne peut être qu'un des éléments suivants:
|
|
imageUrl
|
URL de l'image. L'image est récupérée une fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.
L'URL fournie ne doit pas dépasser 2 ko. L'URL elle-même est enregistrée avec l'image et exposée via le champ |
ReplaceMethod
Méthode de remplacement.
Enums | |
---|---|
CENTER_INSIDE
|
Échelle et centre l'image pour l'adapter aux limites de la forme d'origine, tout en conservant son format. La taille de rendu de l'image 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
|
Échelle et centre l'image pour qu'elle remplisse les limites de la forme d'origine. L'image peut être recadrée pour remplir la forme. La taille de rendu de l'image sera identique à celle de la forme d'origine. |
ImageReplaceMethod
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
|
Échelle et centre l'image pour l'adapter aux limites de la forme d'origine, tout en conservant son format. La taille de rendu de l'image 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
|
Échelle et centre l'image pour qu'elle remplisse les limites de la forme d'origine. L'image peut être recadrée pour remplir la forme. La taille de rendu de l'image sera identique à 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 la diapositive spécifiée. Lorsque vous dupliquez un élément de page, il est placé sur la même page et à la même position que l'élément d'origine.
Représentation JSON |
---|
{ "objectId": string, "objectIds": { string: string, ... } } |
Champs | |
---|---|
objectId
|
Identifiant de l'objet à dupliquer. |
objectIds
|
L'objet dupliqué peut contenir d'autres objets, par exemple lorsque vous dupliquez une diapositive ou un élément de page de groupe. Ce mappage définit la manière dont les ID des objets en double sont générés: les clés sont les ID des objets d'origine et les valeurs sont les ID qui seront attribués à l'objet en double correspondant. L'ID du double de l'objet source peut également être spécifié dans cette carte, en utilisant la même valeur du champ
Toutes les clés doivent correspondre à des ID existants dans la présentation. Toutes les valeurs doivent être uniques dans la présentation et doivent commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si des ID d'objets sources sont omis de la carte, un nouvel ID aléatoire leur sera attribué. Si la carte est vide ou non définie, tous les objets en double reçoivent un nouvel ID aléatoire. |
UpdateTextStyleRequest
Représentation JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la forme ou du tableau contenant le texte à styliser. |
cellLocation
|
Emplacement de la cellule dans le tableau contenant le texte à styliser. Si |
style
|
(ou plusieurs) styles à 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 destinées à refléter le comportement de l'éditeur Slides. Pour en savoir plus, consultez la documentation de |
textRange
|
Plage de texte à styliser. 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
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour mettre le style de texte en gras, définissez 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 lui-même non défini. |
ReplaceAllShapesWithSheetsChartRequest
Remplace toutes les formes correspondant aux critères donné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 au moins d'un des champs d'application OAuth spreadsheets.readonly, spreadsheets, drive.readonly ou drive.
Représentation JSON |
---|
{ "containsText": { object ( |
Champs | |
---|---|
containsText
|
Critères que les formes doivent respecter pour être remplacées. La requête remplacera toutes les formes contenant le texte donné. |
spreadsheetId
|
ID de la feuille de calcul Google Sheets contenant le graphique. |
chartId
|
ID du graphique spécifique dans la feuille de calcul Google Sheets. |
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[]
|
Si ce champ n'est pas vide, les correspondances sont limitées aux éléments de page uniquement sur les pages données.
Renvoie une erreur 400 "Bad Request" si l'ID de l'objet de la page est fourni pour un |
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
|
En associant le graphique, vous pouvez 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 conservé visuellement en ajoutant un retrait au début du paragraphe correspondant.
Représentation JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la forme ou du tableau contenant le texte à partir duquel vous souhaitez supprimer les puces. |
cellLocation
|
Emplacement facultatif de la cellule de tableau si le texte à modifier se trouve dans une cellule de tableau. Le cas échéant, l'attribut objectId doit faire référence à une table. |
textRange
|
Plage de texte à partir de laquelle supprimer les puces, en fonction des index |
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 ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la forme ou du tableau contenant le texte à styliser. |
cellLocation
|
Emplacement de la cellule dans le tableau contenant le ou les paragraphes à mettre en forme. Si |
style
|
Style du paragraphe. |
textRange
|
Plage de texte contenant le ou les paragraphes à mettre en forme. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour mettre à jour l'alignement du paragraphe, définissez 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 lui-même non défini. |
UpdateTableBorderPropertiesRequest
Met à jour les propriétés des bordures de la table dans un Table
.
Représentation JSON |
---|
{ "objectId": string, "tableRange": { object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la table. |
tableRange
|
Plage du tableau représentant le sous-ensemble de la table auquel les mises à jour sont appliquées. Si aucune plage de table n'est spécifiée, les mises à jour s'appliquent à l'ensemble de la table. |
borderPosition
|
Position de la bordure dans la plage de tableau à laquelle les mises à jour doivent s'appliquer. Si aucune position de bordure n'est spécifiée, les modifications s'appliquent à toutes les bordures de la plage de la table. |
tableBorderProperties
|
Propriétés de la bordure du tableau à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour modifier la couleur de remplissage unie de la bordure de la table, définissez 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 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 à l'extérieur 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 ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la table. |
columnIndices[]
|
Liste des indices basés sur zéro spécifiant les colonnes à mettre à jour. Si aucun indice n'est fourni, toutes les colonnes de la table sont mises à jour. |
tableColumnProperties
|
Propriétés des colonnes du tableau à mettre à jour.
Si la valeur de |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour mettre à jour la largeur de la colonne, définissez Si "columnWidth" est inclus dans le masque de champ, mais que la propriété n'est pas définie,la largeur de la colonne est définie par défaut sur 406 400 EMU (32 points). |
UpdateTableRowPropertiesRequest
Met à jour les propriétés d'une ligne Table
.
Représentation JSON |
---|
{
"objectId": string,
"rowIndices": [
integer
],
"tableRowProperties": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la table. |
rowIndices[]
|
Liste des indices basés sur zéro spécifiant les lignes à mettre à jour. Si aucun indice n'est fourni, toutes les lignes de la table sont mises à jour. |
tableRowProperties
|
Propriétés de la ligne de la table à mettre à jour. |
fields
|
Champs à mettre à jour.
Vous devez spécifier au moins un champ. Le
Par exemple, pour mettre à jour la hauteur de ligne minimale, définissez 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 ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la table. |
tableRange
|
Plage du tableau spécifiant les cellules du tableau à fusionner. Tout texte contenu dans les cellules fusionnées est concaténé et stocké dans la cellule supérieure gauche ("en-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 de requête incorrecte 400 est renvoyée. |
UnmergeTableCellsRequest
Défusionne les cellules d'un Table
.
Représentation JSON |
---|
{
"objectId": string,
"tableRange": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la table. |
tableRange
|
Plage de la table spécifiant les cellules de la table à dissocier. Toutes les cellules fusionnées de cette plage seront dissociées, et les cellules déjà dissociées ne seront pas affectées. Si la plage ne contient aucune cellule fusionnée, la requête ne sera pas exécutée. Si du texte figure dans l'une des cellules fusionnées, il reste dans la cellule supérieure gauche ("en-tête") du bloc de cellules non fusionnées qui en résulte. |
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
|
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 la présentation. L'ID doit commencer par un caractère alphanumérique ou un trait de soulignement (correspond à l'expression régulière Si vous ne spécifiez pas d'ID, un ID unique est généré. |
childrenObjectIds[]
|
ID des objets à regrouper.
Seuls les éléments de page peuvent être regroupés. La page doit comporter au moins deux éléments qui ne font pas déjà partie d'un autre groupe. Certains éléments de page, tels que |
UngroupObjectsRequest
Dissocie des objets, tels que groups
.
Représentation JSON |
---|
{ "objectIds": [ string ] } |
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
|
ID de l'objet de l'élément de page auquel les mises à jour sont appliquées. |
title
|
Titre du texte alternatif mis à jour de l'élément de page. Si cette valeur n'est pas définie, la valeur existante est conservée. Le titre est exposé aux lecteurs d'écran et aux autres interfaces d'accessibilité. N'utilisez que des valeurs lisibles par l'utilisateur liées au contenu de l'élément de page. |
description
|
Description du texte alternatif mis à jour de l'élément de page. Si cette valeur n'est pas définie, la valeur existante est conservée. La description est exposée aux lecteurs d'écran et aux autres interfaces d'accessibilité. N'utilisez que des valeurs lisibles par l'utilisateur 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 ( |
Champs | |
---|---|
imageObjectId
|
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
|
Méthode de remplacement. |
Champ d'union image_source . Type de source d'image.
image_source ne peut être qu'un des éléments suivants:
|
|
url
|
URL de l'image. L'image est récupérée une fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.
L'URL fournie ne doit pas dépasser 2 ko. L'URL est enregistrée avec l'image et exposée via le champ |
UpdateSlidePropertiesRequest
Met à jour les propriétés d'une diapositive.
Représentation JSON |
---|
{
"objectId": string,
"slideProperties": {
object ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la diapositive à laquelle la mise à jour s'applique. |
slideProperties
|
Propriétés de la diapositive à mettre à jour. |
fields
|
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
Par exemple, pour indiquer si une diapositive doit être ignorée, définissez 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 lui-même non défini. |
UpdatePageElementsZOrderRequest
Met à jour l'ordre Z des éléments de la page. L'ordre Z est un ordre des éléments de la page de l'arrière vers l'avant. L'élément de la page situé à l'avant peut recouvrir les éléments situés derrière lui.
Représentation JSON |
---|
{
"pageElementObjectIds": [
string
],
"operation": enum ( |
Champs | |
---|---|
pageElementObjectIds[]
|
ID des objets 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
|
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 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
|
Déplace les éléments de la page vers l'avant d'un élément par rapport à l'élément le plus en avant des éléments de page spécifiés. |
SEND_BACKWARD
|
Déplace les éléments de la page vers l'arrière d'un élément par rapport à l'élément le plus éloigné des éléments de la page spécifiés. |
SEND_TO_BACK
|
Place 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 ( |
Champs | |
---|---|
objectId
|
ID de l'objet de la ligne à laquelle la mise à jour s'applique.
Seule une ligne avec un La ligne peut être réacheminée après la mise à jour de sa catégorie. |
lineCategory
|
Catégorie de ligne à mettre à jour.
La valeur exacte de |
RerouteLineRequest
Redirige un line
de sorte qu'il soit connecté aux deux sites de connexion les plus proches des éléments de page connectés.
Représentation JSON |
---|
{ "objectId": string } |
Champs | |
---|---|
objectId
|
ID de l'objet de la ligne à rediriger.
Seule une ligne avec un |