REST Resource: documents

{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

string

Uniquement en sortie. ID du document.

string

Titre du document.

object (Tab)

Onglets faisant partie d'un document.

Les onglets peuvent contenir des onglets enfants, c'est-à-dire des onglets imbriqués dans un autre onglet. Les onglets enfants sont représentés par le champ Tab.childTabs.

string

Uniquement en sortie. ID de la révision du document. Peut être utilisé dans les requêtes de mise à jour pour spécifier la révision d'un document à laquelle appliquer les mises à jour et le comportement de la requête si le document a été modifié depuis cette révision. Ce champ n'est renseigné que si l'utilisateur est autorisé à modifier le document.

L'ID de révision n'est pas un numéro séquentiel, mais une chaîne opaque. Le format de l'ID de révision peut changer au fil du temps. Un ID de révision renvoyé n'est valide que pendant 24 heures après avoir été renvoyé et ne peut pas être partagé entre les utilisateurs. Si l'ID de révision reste inchangé entre les appels, cela signifie que le document n'a pas changé. À l'inverse, un ID modifié (pour le même document et l'utilisateur) signifie généralement que le document a été mis à jour. Toutefois, un ID modifié peut également être dû à des facteurs internes, tels que des modifications de format.

enum (SuggestionsViewMode)

Uniquement en sortie. Mode d'affichage des suggestions appliqué au document.

Remarque: Lorsque vous modifiez un document, les modifications doivent être basées sur un document avec SUGGESTIONS_INLINE.

object (Body)

Uniquement en sortie. Corps principal du document.

Ancien champ: utilisez plutôt Document.tabs.documentTab.body, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (Header))

Uniquement en sortie. En-têtes du document, indexés par l'ID de l'en-tête.

Ancien champ: utilisez plutôt Document.tabs.documentTab.headers, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (Footer))

Uniquement en sortie. Pieds de page du document, indexés par leur ID.

Ancien champ: utilisez plutôt Document.tabs.documentTab.footers, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (Footnote))

Uniquement en sortie. Les notes de bas de page du document, triées par ID de note de bas de page.

Ancien champ: utilisez plutôt Document.tabs.documentTab.footnotes, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

object (DocumentStyle)

Uniquement en sortie. Style du document.

Ancien champ: utilisez plutôt Document.tabs.documentTab.documentStyle, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (SuggestedDocumentStyle))

Uniquement en sortie. Modifications suggérées apportées au style du document, triées par ID de suggestion.

Ancien champ: utilisez plutôt Document.tabs.documentTab.suggestedDocumentStyleChanges, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

object (NamedStyles)

Uniquement en sortie. Styles nommés du document.

Ancien champ: utilisez plutôt Document.tabs.documentTab.namedStyles, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (SuggestedNamedStyles))

Uniquement en sortie. Modifications suggérées apportées aux styles nommés du document, triées par ID de suggestion.

Ancien champ: utilisez plutôt Document.tabs.documentTab.suggestedNamedStylesChanges, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (List))

Uniquement en sortie. Les listes du document, triées par ID de liste.

Ancien champ: utilisez plutôt Document.tabs.documentTab.lists, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (NamedRanges))

Uniquement en sortie. Les plages nommées du document, triées par nom.

Ancien champ: utilisez plutôt Document.tabs.documentTab.namedRanges, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (InlineObject))

Uniquement en sortie. Objets intégrés dans le document, indexés par ID d'objet.

Ancien champ: utilisez plutôt Document.tabs.documentTab.inlineObjects, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

map (key: string, value: object (PositionedObject))

Uniquement en sortie. Objets positionnés dans le document, indexés par ID d'objet.

Ancien champ: utilisez plutôt Document.tabs.documentTab.positionedObjects, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

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

object (TabProperties)

Propriétés de l'onglet, comme l'ID et le titre.

object (Tab)

Onglets enfants imbriqués dans cet onglet.

object (DocumentTab)

Onglet contenant le contenu du document, comme du texte et des images.

{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}

string

Uniquement en sortie. ID de l'onglet. Ce champ ne peut pas être modifié.

string

Nom visible par l'utilisateur de l'onglet.

string

Facultatif. ID de l'onglet parent. Vide lorsque l'onglet actuel est un onglet de niveau racine, ce qui signifie qu'il n'a pas de parents.

integer

Index basé sur zéro de l'onglet dans le parent.

integer

Uniquement en sortie. Profondeur de l'onglet dans le document. Les onglets de niveau racine commencent à 0.

{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

object (Body)

Corps principal de l'onglet du document.

map (key: string, value: object (Header))

En-têtes de l'onglet du document, triés par ID d'en-tête.

map (key: string, value: object (Footer))

Pieds de page de l'onglet du document, triés par ID de pied de page.

map (key: string, value: object (Footnote))

Les notes de bas de page de l'onglet du document, triées par ID de note de bas de page.

object (DocumentStyle)

Style de l'onglet du document.

map (key: string, value: object (SuggestedDocumentStyle))

Modifications suggérées apportées au style de l'onglet du document, triées par ID de suggestion.

object (NamedStyles)

Styles nommés de l'onglet de document.

map (key: string, value: object (SuggestedNamedStyles))

Modifications suggérées apportées aux styles nommés de l'onglet de document, triées par ID de suggestion.

map (key: string, value: object (List))

Les listes de l'onglet "Document", triées par ID de liste.

map (key: string, value: object (NamedRanges))

Plages nommées dans l'onglet du document, triées par nom.

map (key: string, value: object (InlineObject))

Objets intégrés dans l'onglet du document, triés par ID d'objet.

map (key: string, value: object (PositionedObject))

Objets positionnés dans l'onglet du document, triés par ID d'objet.

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

object (StructuralElement)

Contenu du corps.

Les indices du contenu du corps commencent à zéro.

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}

integer

Indice de début (basé sur zéro) de cet élément structurel, en unités de code UTF-16.

integer

Indice de fin de cet élément structurel, à partir de zéro, exclusif, en unités de code UTF-16.

object (Paragraph)

Élément structurel de type paragraphe.

object (SectionBreak)

Élément structurel de type saut de section.

object (Table)

Élément structurel de type tableau.

object (TableOfContents)

Élément structurel de type table des matières.

{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}

object (ParagraphElement)

Contenu du paragraphe, décomposé en parties

object (ParagraphStyle)

Style de ce paragraphe.

map (key: string, value: object (SuggestedParagraphStyle))

Le style de paragraphe suggéré est appliqué à ce paragraphe, identifié par l'ID de suggestion.

object (Bullet)

Puce de ce paragraphe. En l'absence de cette balise, le paragraphe n'appartient à aucune liste.

map (key: string, value: object (SuggestedBullet))

Modifications suggérées pour la puce de ce paragraphe.

string

ID des objets positionnés associés à ce paragraphe.

map (key: string, value: object (ObjectReferences))

ID des objets positionnés suggérés pour être associés à ce paragraphe, triés par ID de suggestion.

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}

integer

Indice de début basé sur zéro de cet élément de paragraphe, en unités de code UTF-16.

integer

Index de fin de cet élément de paragraphe, exclusif, en unités de code UTF-16.

object (TextRun)

Élément de paragraphe de texte.

object (AutoText)

Élément de paragraphe de texte automatique.

object (PageBreak)

Élément de paragraphe de saut de page.

object (ColumnBreak)

Élément de paragraphe de saut de colonne.

object (FootnoteReference)

Élément de paragraphe de référence à une note de bas de page.

object (HorizontalRule)

Élément de paragraphe avec ligne horizontale.

object (Equation)

Élément de paragraphe d'équation.

object (InlineObjectElement)

Élément de paragraphe d'objet intégré.

object (Person)

Élément de paragraphe qui renvoie à une personne ou à une adresse e-mail.

object (RichLink)

Élément de paragraphe qui redirige vers une ressource Google (par exemple, un fichier Google Drive, une vidéo YouTube ou un événement Agenda).

{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

Texte de cette exécution.

Tous les éléments autres que textuels de l'exécution sont remplacés par le caractère Unicode U+E907.

string

ID d'insertion suggérés. Un TextRun peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cette exécution.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré change pour cette exécution, en fonction de l'ID de suggestion.

{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}

boolean

Indique si le texte est affiché en gras ou non.

boolean

Indique si le texte est en italique ou non.

boolean

Indique si le texte est souligné ou non.

boolean

Indique si le texte est barré ou non.

boolean

Indique si le texte est en petites majuscules.

object (OptionalColor)

Couleur d'arrière-plan du texte. Si elle est définie, la couleur est une couleur RVB ou transparente, en fonction du champ color.

object (OptionalColor)

Couleur de premier plan du texte. Si elle est définie, la couleur est une couleur RVB ou transparente, en fonction du champ color.

object (Dimension)

Taille de la police du texte.

object (WeightedFontFamily)

Famille de polices et épaisseur de police du texte.

Si une requête de modification spécifie des valeurs pour weightedFontFamily et bold, weightedFontFamily est appliqué en premier, puis bold.

Si weightedFontFamily#weight n'est pas défini, la valeur par défaut est 400.

Si weightedFontFamily est défini, weightedFontFamily#fontFamily doit également être défini avec une valeur non vide. Sinon, une erreur 400 "Bad Request" est renvoyée.

enum (BaselineOffset)

Décalage vertical du texte par rapport à sa position normale.

Le texte avec des décalages de ligne de base SUPERSCRIPT ou SUBSCRIPT est automatiquement affiché dans une taille de police plus petite, calculée en fonction du champ fontSize. Les modifications apportées à ce champ n'ont aucune incidence sur fontSize.

object (Link)

Destination du lien hypertexte du texte. Si cette valeur n'est pas définie, aucun lien n'est créé. Les liens ne sont pas hérités du texte parent.

Modifier le lien dans une requête de mise à jour entraîne d'autres modifications du style de texte de la plage:

• Lorsque vous définissez un lien, la couleur de premier plan du texte est remplacée par la couleur de lien par défaut et le texte est souligné. Si ces champs sont modifiés dans la même requête, ces valeurs seront utilisées à la place des valeurs par défaut du lien.
• Si vous définissez un lien sur une plage de texte qui chevauche un lien existant, le lien existant sera également mis à jour pour pointer vers la nouvelle URL.
• Les associations ne peuvent pas être définies sur des caractères de nouvelle ligne. Par conséquent, définir un lien sur une plage de texte qui traverse une limite de paragraphe, comme "ABC\n123", séparera le ou les caractères de retour à la ligne dans leurs propres séquences de texte. Le lien sera appliqué séparément aux exécutions avant et après le retour à la ligne.
• Si vous supprimez un lien, le style de texte de la plage est mis à jour pour correspondre au style du texte précédent (ou aux styles de texte par défaut si le texte précédent est un autre lien), sauf si des styles différents sont définis dans la même requête.

{
  "color": {
    object (Color)
  }
}

object (Color)

Si cette valeur est définie, elle sera utilisée comme couleur opaque. Si cette valeur n'est pas définie, elle représente une couleur transparente.

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

Valeur de couleur RVB.

{
  "red": number,
  "green": number,
  "blue": number
}

number

Composant rouge de la couleur, compris entre 0,0 et 1,0.

number

Composant vert de la couleur, compris entre 0,0 et 1,0.

number

Composant bleu de la couleur, de 0,0 à 1,0.

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

L'ampleur.

enum (Unit)

Unités de l'ampleur.

{
  "fontFamily": string,
  "weight": integer
}

string

Famille de polices du texte.

La famille de polices peut être n'importe quelle police du menu "Police" de Docs ou de Google Fonts. Si le nom de la police n'est pas reconnu, le texte est affiché en Arial.

integer

Épaisseur de la police. Ce champ peut prendre n'importe quelle valeur multiple de 100 comprise entre 100 et 900 inclus. Cette plage correspond aux valeurs numériques décrites dans la spécification CSS 2.1, section 15.6, les valeurs non numériques étant interdites.

La valeur par défaut est 400 ("normal").

L'épaisseur de la police ne constitue qu'un seul composant de l'épaisseur de la police affichée. Une combinaison de la valeur weight et de la valeur bold résolue du style de texte détermine l'épaisseur affichée, après prise en compte de l'héritage:

• Si le texte est en gras et que la pondération est inférieure à 400, la pondération affichée est de 400.
• Si le texte est en gras et que la pondération est supérieure ou égale à 400, mais inférieure à 700, la pondération affichée est 700.
• Si le poids est supérieur ou égal à 700, le poids affiché est égal au poids.
• Si le texte n'est pas en gras, l'épaisseur de rendu est égale à l'épaisseur.

{

  // Union field destination can be only one of the following:
  "url": string,
  "tabId": string,
  "bookmark": {
    object (BookmarkLink)
  },
  "heading": {
    object (HeadingLink)
  },
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

URL externe.

string

ID d'un onglet de ce document.

object (BookmarkLink)

Un signet dans ce document.

Dans les documents contenant un seul onglet, les liens vers les signets de l'onglet unique continuent de renvoyer Link.bookmarkId lorsque le paramètre includeTabsContent est défini sur false ou non défini. Sinon, ce champ est renvoyé.

object (HeadingLink)

Titre de ce document.

Dans les documents contenant un seul onglet, les liens vers les titres de l'onglet continuent de renvoyer Link.headingId lorsque le paramètre includeTabsContent est défini sur false ou non défini. Sinon, ce champ est renvoyé.

string

ID d'un favori dans ce document.

Ancien champ: définissez includeTabsContent sur true et utilisez Link.bookmark pour les opérations de lecture et d'écriture. Ce champ n'est renvoyé que lorsque includeTabsContent est défini sur false dans les documents contenant un seul onglet et des liens vers un favori dans l'onglet unique. Sinon, Link.bookmark est renvoyé.

Si ce champ est utilisé dans une requête d'écriture, le favori est considéré comme provenant de l'ID de l'onglet spécifié dans la requête. Si aucun ID d'onglet n'est spécifié dans la requête, il est considéré comme provenant du premier onglet du document.

string

ID d'un titre de ce document.

Ancien champ: définissez includeTabsContent sur true et utilisez Link.heading pour les opérations de lecture et d'écriture. Ce champ n'est renvoyé que lorsque includeTabsContent est défini sur false dans les documents contenant un seul onglet et des liens vers un titre dans l'onglet unique. Sinon, Link.heading est renvoyé.

Si ce champ est utilisé dans une requête d'écriture, l'en-tête est considéré comme provenant de l'ID de l'onglet spécifié dans la requête. Si aucun ID d'onglet n'est spécifié dans la requête, il est considéré comme provenant du premier onglet du document.

{
  "id": string,
  "tabId": string
}

string

ID d'un favori dans ce document.

string

ID de l'onglet contenant ce favori.

{
  "id": string,
  "tabId": string
}

string

ID d'un titre de ce document.

string

ID de l'onglet contenant cet en-tête.

{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

object (TextStyle)

TextStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec textStyleSuggestionState pour voir quels champs ont changé et quelles sont leurs nouvelles valeurs.

object (TextStyleSuggestionState)

Masque indiquant les champs de l'TextStyle de base qui ont été modifiés dans cette suggestion.

{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}

boolean

Indique si une modification a été suggérée pour bold.

boolean

Indique si une modification a été suggérée pour italic.

boolean

Indique si une modification a été suggérée pour underline.

boolean

Indique si une modification a été suggérée pour strikethrough.

boolean

Indique si une modification a été suggérée pour smallCaps.

boolean

Indique si une modification a été suggérée pour backgroundColor.

boolean

Indique si une modification a été suggérée pour foregroundColor.

boolean

Indique si une modification a été suggérée pour fontSize.

boolean

Indique si une modification a été suggérée pour weightedFontFamily.

boolean

Indique si une modification a été suggérée pour baselineOffset.

boolean

Indique si une modification a été suggérée pour link.

{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

enum (Type)

Type de ce texte automatique.

string

ID d'insertion suggérés. Un AutoText peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cet AutoText.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par ce texte AutoText, associé à l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID d'insertion suggérés. Un PageBreak peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de ce saut de page.

Comme pour le contenu textuel, comme les passages de texte et les références de note de bas de page, le style de texte d'un saut de page peut affecter la mise en page du contenu ainsi que le style du texte inséré à côté.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par ce saut de page, associé à l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID d'insertion suggérés. Un ColumnBreak peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de ce saut de colonne.

Comme pour le contenu textuel, comme les passages de texte et les références de note de bas de page, le style de texte d'un saut de colonne peut affecter la mise en page du contenu, ainsi que le style du texte inséré à côté.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par ce saut de colonne, associé à l'ID de suggestion.

{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID de l'footnote contenant le contenu de cette référence de note de bas de page.

string

Numéro affiché de cette note de bas de page.

string

ID d'insertion suggérés. Un FootnoteReference peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cette référence de note de bas de page.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par cette référence de note de bas de page, référencée par l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID d'insertion suggérés. Un HorizontalRule peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cette HorizontalRule.

Comme pour le contenu textuel, comme les passages de texte et les références de note de bas de page, le style de texte d'une ligne horizontale peut affecter la mise en page du contenu ainsi que le style du texte inséré à côté.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par cette règle horizontale, indexée par l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

ID d'insertion suggérés. Un Equation peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID de l'InlineObject que cet élément contient.

string

ID d'insertion suggérés. Un InlineObjectElement peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cet élément InlineObject.

Comme pour le contenu textuel, comme les lignes de texte et les références de note de bas de page, le style de texte d'un élément d'objet intégré peut affecter la mise en page du contenu ainsi que le style du texte inséré à côté.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par cet objet InlineObject, indexé par l'ID de suggestion.

{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}

string

Uniquement en sortie. Identifiant unique de ce lien.

string

ID des suggestions qui insèrent ce lien vers une personne dans le document. Un Person peut comporter plusieurs ID d'insertion s'il s'agit d'une modification suggérée imbriquée (une suggestion dans une suggestion faite par un autre utilisateur, par exemple). Si ce champ est vide, le lien vers cette personne n'est pas une suggestion d'insertion.

string

ID des suggestions qui suppriment le lien vers cette personne du document. Un Person peut avoir plusieurs ID de suppression si, par exemple, plusieurs utilisateurs suggèrent de le supprimer. Si ce champ est vide, le lien vers cette personne ne sera pas suggéré pour suppression.

object (TextStyle)

Style de texte de cet objet Person.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par Person, avec l'ID de suggestion comme clé.

object (PersonProperties)

Uniquement en sortie. Propriétés de cet objet Person. Ce champ est toujours présent.

{
  "name": string,
  "email": string
}

string

Uniquement en sortie. Nom de la personne si celui-ci s'affiche dans le texte du lien au lieu de son adresse e-mail.

string

Uniquement en sortie. Adresse e-mail associée à ce Person. Ce champ est toujours présent.

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

Uniquement en sortie. ID de ce lien.

string

ID des suggestions qui insèrent ce lien dans le document. Un RichLink peut comporter plusieurs ID d'insertion s'il s'agit d'une modification suggérée imbriquée (une suggestion dans une suggestion faite par un autre utilisateur, par exemple). Si ce champ est vide, le lien vers cette personne n'est pas une suggestion d'insertion.

string

ID des suggestions qui suppriment ce lien du document. Un RichLink peut avoir plusieurs ID de suppression si, par exemple, plusieurs utilisateurs suggèrent de le supprimer. Si ce champ est vide, le lien vers cette personne ne sera pas suggéré pour suppression.

object (TextStyle)

Style de texte de cet objet RichLink.

map (key: string, value: object (SuggestedTextStyle))

Le style de texte suggéré est remplacé par ce RichLink, associé à l'ID de suggestion.

object (RichLinkProperties)

Uniquement en sortie. Propriétés de cet objet RichLink. Ce champ est toujours présent.

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

Uniquement en sortie. Titre de l'RichLink tel qu'il apparaît dans le lien. Ce titre correspond au titre de la ressource associée au moment de l'insertion ou de la dernière mise à jour du lien. Ce champ est toujours présent.

string

Uniquement en sortie. URI de l'RichLink. Il est toujours présent.

string

Uniquement en sortie. Type MIME de l'RichLink, le cas échéant (par exemple, lorsqu'il s'agit d'un fichier dans Drive).

{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}

string

ID de l'en-tête du paragraphe. Si ce champ est vide, ce paragraphe n'est pas un titre.

Cette propriété est en lecture seule.

enum (NamedStyleType)

Type de style nommé du paragraphe.

Étant donné que la mise à jour du type de style nommé affecte d'autres propriétés de ParagraphStyle, le type de style nommé est appliqué avant que les autres propriétés ne soient mises à jour.

enum (Alignment)

Alignement du texte de ce paragraphe.

number

Espace entre les lignes, exprimé en pourcentage de la valeur normale (100, 0). Si cette valeur n'est pas définie, elle est héritée du parent.

enum (ContentDirection)

Sens du texte de ce paragraphe. Si cette valeur n'est pas définie, la valeur par défaut est LEFT_TO_RIGHT, car l'orientation du paragraphe n'est pas héritée.

enum (SpacingMode)

Mode d'espacement du paragraphe.

object (Dimension)

Espace supplémentaire au-dessus du paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

object (Dimension)

Espace supplémentaire sous le paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

object (ParagraphBorder)

La bordure entre ce paragraphe et les paragraphes précédents et suivants. Si cette valeur n'est pas définie, elle est héritée du parent.

La bordure entre les paragraphes est affichée lorsque le paragraphe adjacent a les mêmes propriétés de bordure et d'indentation.

Vous ne pouvez pas mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (ParagraphBorder)

La bordure en haut de ce paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

La bordure supérieure est affichée lorsque le paragraphe ci-dessus présente des propriétés de bordure et de retrait différentes.

Vous ne pouvez pas mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (ParagraphBorder)

Bordure en bas de ce paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

La bordure inférieure est affichée lorsque le paragraphe ci-dessous présente des propriétés de bordure et d'indentation différentes.

Vous ne pouvez pas mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (ParagraphBorder)

Bordure à gauche de ce paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

Vous ne pouvez pas mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (ParagraphBorder)

Bordure à droite de ce paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

Vous ne pouvez pas mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (Dimension)

Taille du retrait de la première ligne du paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

object (Dimension)

Indentation du paragraphe sur le côté correspondant au début du texte, en fonction du sens actuel du paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

object (Dimension)

Indentation du paragraphe sur le côté correspondant à la fin du texte, en fonction du sens du paragraphe actuel. Si cette valeur n'est pas définie, elle est héritée du parent.

object (TabStop)

Liste des tabulations de ce paragraphe. La liste des tabulations n'est pas héritée.

Cette propriété est en lecture seule.

boolean

Indique si toutes les lignes du paragraphe doivent être disposées sur la même page ou dans la même colonne, si possible. Si cette valeur n'est pas définie, elle est héritée du parent.

boolean

Indique si au moins une partie de ce paragraphe doit être mise en page sur la même page ou dans la même colonne que le paragraphe suivant, si possible. Si cette valeur n'est pas définie, elle est héritée du parent.

boolean

Indique si les orphelins et les veuves doivent être évités pour le paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

object (Shading)

Ombrage du paragraphe. Si cette valeur n'est pas définie, elle est héritée du parent.

boolean

Indique si le paragraphe actuel doit toujours commencer au début d'une page. Si cette valeur n'est pas définie, elle est héritée du parent.

Si vous essayez de mettre à jour pageBreakBefore pour des paragraphes dans des régions non prises en charge, y compris Table, Header, Footer et Footnote, l'état du document peut être incorrect et renvoyer une erreur 400 (mauvaise requête).

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

Couleur de la bordure.

object (Dimension)

Largeur de la bordure.

object (Dimension)

Marge intérieure de la bordure.

enum (DashStyle)

Style de la bordure.

{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}

object (Dimension)

Décalage entre cet arrêt de tabulation et la marge de début.

enum (TabStopAlignment)

Alignement de cet arrêt d'onglet. Si ce champ n'est pas défini, la valeur par défaut est START.

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

Couleur d'arrière-plan de l'ombre de ce paragraphe.

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}

object (ParagraphStyle)

ParagraphStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec paragraphStyleSuggestionState pour voir quels champs ont changé et quelles sont leurs nouvelles valeurs.

object (ParagraphStyleSuggestionState)

Masque indiquant les champs de l'ParagraphStyle de base qui ont été modifiés dans cette suggestion.

{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}

boolean

Indique si une modification a été suggérée pour headingId.

boolean

Indique si une modification a été suggérée pour namedStyleType.

boolean

Indique si une modification a été suggérée pour alignment.

boolean

Indique si une modification a été suggérée pour lineSpacing.

boolean

Indique si une modification a été suggérée pour direction.

boolean

Indique si une modification a été suggérée pour spacingMode.

boolean

Indique si une modification a été suggérée pour spaceAbove.

boolean

Indique si une modification a été suggérée pour spaceBelow.

boolean

Indique si une modification a été suggérée pour borderBetween.

boolean

Indique si une modification a été suggérée pour borderTop.

boolean

Indique si une modification a été suggérée pour borderBottom.

boolean

Indique si une modification a été suggérée pour borderLeft.

boolean

Indique si une modification a été suggérée pour borderRight.

boolean

Indique si une modification a été suggérée pour indentFirstLine.

boolean

Indique si une modification a été suggérée pour indentStart.

boolean

Indique si une modification a été suggérée pour indentEnd.

boolean

Indique si une modification a été suggérée pour keepLinesTogether.

boolean

Indique si une modification a été suggérée pour keepWithNext.

boolean

Indique si une modification a été suggérée pour avoidWidowAndOrphan.

object (ShadingSuggestionState)

Masque indiquant les champs de shading qui ont été modifiés dans cette suggestion.

boolean

Indique si une modification a été suggérée pour pageBreakBefore.

{
  "backgroundColorSuggested": boolean
}

boolean

Indique si une modification a été suggérée pour le Shading.

{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}

string

ID de la liste à laquelle ce paragraphe appartient.

integer

Niveau d'imbrication de ce paragraphe dans la liste.

object (TextStyle)

Style de texte spécifique au paragraphe appliqué à cette puce.

{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}

object (Bullet)

Bullet qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec bulletSuggestionState pour voir quels champs ont changé et quelles sont leurs nouvelles valeurs.

object (BulletSuggestionState)

Masque indiquant les champs de l'Bullet de base qui ont été modifiés dans cette suggestion.

{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

boolean

Indique si une modification a été suggérée pour le listId.

boolean

Indique si une modification a été suggérée pour le nestingLevel.

object (TextStyleSuggestionState)

Masque indiquant les champs de text style qui ont été modifiés dans cette suggestion.

{
  "objectIds": [
    string
  ]
}

string

ID des objets.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}

string

ID d'insertion suggérés. Un SectionBreak peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (SectionStyle)

Style de la section après ce saut de section.

{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}

object (SectionColumnProperties)

Propriétés des colonnes de la section.

Si elle est vide, la section contient une colonne avec les propriétés par défaut dans l'éditeur Docs. Vous pouvez modifier une section pour qu'elle ne comporte pas plus de trois colonnes.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

enum (ColumnSeparatorStyle)

Style des séparateurs de colonnes.

Vous pouvez définir ce style même si la section ne comporte qu'une seule colonne.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

enum (ContentDirection)

Orientation du contenu de cette section. Si ce champ n'est pas défini, la valeur par défaut est LEFT_TO_RIGHT.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge supérieure de la page de la section. Si ce champ n'est pas défini, la valeur par défaut est marginTop à partir de DocumentStyle.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge inférieure de la page de la section. Si ce champ n'est pas défini, la valeur par défaut est marginBottom à partir de DocumentStyle.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge de droite de la section. Si ce champ n'est pas défini, la valeur par défaut est marginRight à partir de DocumentStyle. La modification de la marge droite entraîne le redimensionnement des colonnes de cette section. Étant donné que la marge affecte la largeur de la colonne, elle est appliquée avant les propriétés de la colonne.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge de gauche de la section. Si ce champ n'est pas défini, la valeur par défaut est marginLeft à partir de DocumentStyle. La modification de la marge de gauche entraîne le redimensionnement des colonnes de cette section. Étant donné que la marge affecte la largeur de la colonne, elle est appliquée avant les propriétés de la colonne.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge de l'en-tête de la section. Si ce champ n'est pas défini, la valeur par défaut est marginHeader à partir de DocumentStyle. Si elle est mise à jour, useCustomHeaderFooterMargins est définie sur "true" dans DocumentStyle. La valeur de useCustomHeaderFooterMargins sur DocumentStyle indique si une marge d'en-tête est respectée pour cette section.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge du pied de page de la section. Si ce champ n'est pas défini, la valeur par défaut est marginFooter à partir de DocumentStyle. Si elle est mise à jour, useCustomHeaderFooterMargins est définie sur "true" dans DocumentStyle. La valeur de useCustomHeaderFooterMargins sur DocumentStyle indique si une marge de pied de page est respectée pour cette section.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

enum (SectionType)

Uniquement en sortie. Type de section.

string

ID de l'en-tête par défaut. Si cette valeur n'est pas définie, elle hérite de la SectionStyle SectionBreak's précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de defaultHeaderId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID du pied de page par défaut. Si cette valeur n'est pas définie, elle hérite de la SectionStyle SectionBreak's précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de defaultFooterId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID de l'en-tête utilisé uniquement pour la première page de la section. Si useFirstPageHeaderFooter est défini sur "true", cette valeur est utilisée pour l'en-tête de la première page de la section. Si la valeur est "false", l'en-tête de la première page de la section utilise defaultHeaderId. Si cette valeur n'est pas définie, elle hérite de la SectionStyle SectionBreak's précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de firstPageHeaderId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID du pied de page utilisé uniquement pour la première page de la section. Si useFirstPageHeaderFooter est défini sur "true", cette valeur est utilisée pour le pied de page de la première page de la section. Si la valeur est "false", le pied de page de la première page de la section utilise defaultFooterId. Si cette valeur n'est pas définie, elle hérite de la SectionStyle SectionBreak's précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de firstPageFooterId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID de l'en-tête utilisé uniquement pour les pages paires. Si la valeur de useEvenPageHeaderFooter de DocumentStyle est "true", cette valeur est utilisée pour les en-têtes des pages paires de la section. Si la valeur est "false", les en-têtes des pages paires utilisent defaultHeaderId. Si cette valeur n'est pas définie, elle hérite de la SectionStyle SectionBreak's précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de evenPageHeaderId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID du pied de page utilisé uniquement pour les pages paires. Si la valeur de useEvenPageHeaderFooter de DocumentStyle est "true", cette valeur est utilisée pour les pieds de page des pages paires de la section. Si la valeur est "false", les pieds de page des pages paires utilisent defaultFooterId. Si cette valeur n'est pas définie, elle hérite de la SectionStyle SectionBreak's précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de evenPageFooterId de DocumentStyle.

Cette propriété est en lecture seule.

boolean

Indique si les ID d'en-tête / pied de page de la première page doivent être utilisés pour la première page de la section. Si elle n'est pas définie, elle hérite de useFirstPageHeaderFooter de DocumentStyle pour la première section. Si la valeur n'est pas définie pour les secteurs suivants, elle doit être interprétée comme "false".

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

integer

Numéro de page à partir duquel commencer à compter le nombre de pages de cette section. Si cette valeur n'est pas définie, la numérotation des pages continue à partir de la section précédente. Si la valeur n'est pas définie dans le premier SectionBreak, reportez-vous à pageNumberStart de DocumentStyle.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

boolean

Facultatif. Indique si les dimensions de pageSize de DocumentStyle doivent être inversées pour cette section, ce qui permet de modifier l'orientation de la page entre le mode portrait et le mode paysage. Si cette valeur n'est pas définie, elle hérite de flipPageOrientation de DocumentStyle.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

Uniquement en sortie. Largeur de la colonne.

object (Dimension)

Marge intérieure à la fin de la colonne.

{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}

integer

Nombre de lignes dans la table.

integer

Nombre de colonnes dans le tableau.

Un tableau peut ne pas être rectangulaire. Il est donc possible que certaines lignes comportent un nombre différent de cellules.

object (TableRow)

Contenu et style de chaque ligne.

string

ID d'insertion suggérés. Un Table peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TableStyle)

Style de la table.

{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}

integer

Index de début basé sur zéro de cette ligne, en unités de code UTF-16.

integer

Index de fin de cette ligne, à partir de zéro, en unités de code UTF-16 (exclusif).

object (TableCell)

Contenu et style de chaque cellule de cette ligne.

Il est possible qu'un tableau ne soit pas rectangulaire. Par conséquent, le nombre de cellules de certaines lignes peut être différent de celui des autres lignes du même tableau.

string

ID d'insertion suggérés. Un TableRow peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TableRowStyle)

Style de la ligne du tableau.

map (key: string, value: object (SuggestedTableRowStyle))

Le style suggéré change pour cette ligne, avec l'ID de suggestion comme clé.

{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}

integer

Index de début de cette cellule, basé sur zéro, en unités de code UTF-16.

integer

Index de fin de cette cellule, à partir de zéro, exclusif, en unités de code UTF-16.

object (StructuralElement)

Contenu de la cellule.

object (TableCellStyle)

Style de la cellule.

string

ID d'insertion suggérés. Un TableCell peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

map (key: string, value: object (SuggestedTableCellStyle))

Modifications suggérées apportées au style des cellules du tableau, triées par ID de suggestion.

{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}

integer

Nombre de lignes couvertes par la cellule.

Cette propriété est en lecture seule.

integer

Colonne s'étendant sur la cellule.

Cette propriété est en lecture seule.

object (OptionalColor)

Couleur d'arrière-plan de la cellule.

object (TableCellBorder)

Bordure gauche de la cellule.

object (TableCellBorder)

Bordure droite de la cellule.

object (TableCellBorder)

Bordure supérieure de la cellule.

object (TableCellBorder)

Bordure inférieure de la cellule.

object (Dimension)

Marge intérieure gauche de la cellule.

object (Dimension)

Marge intérieure droite de la cellule.

object (Dimension)

Marge intérieure supérieure de la cellule.

object (Dimension)

Marge intérieure inférieure de la cellule.

enum (ContentAlignment)

Alignement du contenu dans la cellule de la table. L'alignement par défaut correspond à celui des cellules de table nouvellement créées dans l'éditeur Docs.

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

Couleur de la bordure.

Cette couleur ne peut pas être transparente.

object (Dimension)

Largeur de la bordure.

enum (DashStyle)

Style de la bordure.

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}

object (TableCellStyle)

TableCellStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec tableCellStyleSuggestionState pour voir quels champs ont changé et quelles sont leurs nouvelles valeurs.

object (TableCellStyleSuggestionState)

Masque indiquant les champs de l'TableCellStyle de base qui ont été modifiés dans cette suggestion.

{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}

boolean

Indique si une modification a été suggérée pour rowSpan.

boolean

Indique si une modification a été suggérée pour columnSpan.

boolean

Indique si une modification a été suggérée pour backgroundColor.

boolean

Indique si une modification a été suggérée pour borderLeft.

boolean

Indique si une modification a été suggérée pour borderRight.

boolean

Indique si une modification a été suggérée pour borderTop.

boolean

Indique si une modification a été suggérée pour borderBottom.

boolean

Indique si une modification a été suggérée pour paddingLeft.

boolean

Indique si une modification a été suggérée pour paddingRight.

boolean

Indique si une modification a été suggérée pour paddingTop.

boolean

Indique si une modification a été suggérée pour paddingBottom.

boolean

Indique si une modification a été suggérée pour contentAlignment.

{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}

object (Dimension)

Hauteur minimale de la ligne. La ligne sera affichée dans l'éditeur Docs avec une hauteur égale ou supérieure à cette valeur afin d'afficher tout le contenu des cellules de la ligne.

boolean

Indique si la ligne est un en-tête de tableau.

boolean

Indique si la ligne ne peut pas dépasser les limites de page ou de colonne.

{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}

object (TableRowStyle)

TableRowStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec tableRowStyleSuggestionState pour voir quels champs ont changé et quelles sont leurs nouvelles valeurs.

object (TableRowStyleSuggestionState)

Masque indiquant les champs de l'TableRowStyle de base qui ont été modifiés dans cette suggestion.

{
  "minRowHeightSuggested": boolean
}

boolean

Indique si une modification a été suggérée pour minRowHeight.

{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}

object (TableColumnProperties)

Propriétés de chaque colonne.

Notez que dans Docs, les tableaux contiennent des lignes et les lignes contiennent des cellules, comme dans HTML. Les propriétés d'une ligne se trouvent donc dans la tableRowStyle de la ligne.

{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}

enum (WidthType)

Type de largeur de la colonne.

object (Dimension)

Largeur de la colonne. Défini lorsque le widthType de la colonne est FIXED_WIDTH.

{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

object (StructuralElement)

Contenu de la table des matières.

string

ID d'insertion suggérés. Un TableOfContents peut comporter plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

ID de l'en-tête.

object (StructuralElement)

Contenu de l'en-tête.

Les indices du contenu d'un en-tête commencent à zéro.

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

ID du pied de page.

object (StructuralElement)