Mettre à jour un document

Type d'opération

Sélectionnez l'une des méthodes suivantes :

• Find and Replace : emplacez le texte existant dans le document par un nouveau texte.

• Insert Text : insérez du texte dans un document.

• Update Text Style : mettez à jour le style d'un texte dans un document.

• Create Paragraph Bullets : créez des puces de paragraphe dans un document.

• Update Paragraph Style : mettez à jour un paragraphe dans un document.

• Insert Inline Image : insérez une image en ligne dans un document Consultez Insérer une image en ligne dans Aide relative au connecteur Google Docs.

Document

ID

ID unique du document.

Mettre à jour

Rechercher

Texte à remplacer.

Ce champ s'affiche lorsque vous sélectionnez Find and Replace pour l'option Type d'operation.

Remplacer par

Texte qui remplace ce que l'utilisateur a saisi dans l'entrée Rechercher.

Lorsque ce champ est vide ou non sélectionné, le champ Texte à remplacer est supprimé du document.

Ce champ s'affiche lorsque vous sélectionnez Find and Replace pour l'option Type d'operation.

Respecter la casse ?

Sélectionnez True si la recherche doit tenir compte des majuscules et des minuscules. Sinon, définissez la valeur sur False.

Ce champ s'affiche lorsque vous sélectionnez Find and Replace pour l'option Type d'operation.

Texte

Texte à insérer dans le document.

Consultez Texte dans Aide relative au connecteur Google Docs.

Ce champ s'affiche lorsque vous sélectionnez Insert Text pour l'option Operation Type.

Index

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

La valeur de l'index est relative au début du segment spécifié par la valeur de l'ID de segment. Si vous utilisez cette valeur sans saisir l'lD de segment, le corps et le texte sont définis sur le corps.

Consultez Index dans Aide relative au connecteur Google Docs .

Ce champ s'affiche lorsque vous sélectionnez Insert Text or Insert Inline Image pour l'option Type d'opération.

Index de départ

Index de départ basé sur zéro de cette plage.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style, Create Paragraph Bullets, ou Update Paragraph Style pour l'option Type d'opération.

Index de fin

Index de fin basé sur zéro de cette plage, exclusif.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style, Create Paragraph Bullets, ou Update Paragraph Style pour l'option Type d'opération.

ID de segment

ID correspondant à l'emplacement de l'en-tête, du pied de page ou de la note de bas de page.

Si la valeur ID de segment est vide, l'ID du corps du document est utilisé.

Si ce champ est renseigné, mais que le champ Index est vide, l'emplacement utilisé se trouve à la fin du corps du texte, de l'en-tête, du pied de page ou de la note de bas de page. Sinon, l'emplacement se trouve immédiatement avant le dernier saut de ligne du segment de document.

Consultez ID de segment dans Aide relative au connecteur Google Docs.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style, Create Paragraph Bullets, Update Paragraph Styleou Insert Inline Image pour l'option Type d'opération.

Restaurer les valeurs par défaut ?

Sélectionnez True si les entrées sélectionnées doivent être définies sur leurs valeurs par défaut. Sinon, définissez la valeur sur False.

Pour rétablir les valeurs par défaut des entrées, sélectionnez-les en tant que champs de saisie.

Les champs suivants ne peuvent pas être définis sur la valeur par défaut et sont ignorés :

• Font Weight

• Link

• Link Type

Ce champ s'affiche lorsque vous sélectionnez Update Text Style or Update Paragraph Style pour l'option Operation Type.

Gras

Sélectionnez True pour mettre le texte en gras. Sinon, définissez la valeur sur False.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Italique

Sélectionnez True pour mettre le texte en italique. Sinon, définissez la valeur sur False.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Souligné

Sélectionnez True pour mettre le texte en souligné. Sinon, définissez la valeur sur False.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Barré

Sélectionnez True pour barrer le texte. Sinon, définissez la valeur sur False.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Petites capitales

Sélectionnez True pour mettre le texte en petites majuscules. Sinon, définissez la valeur sur False.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Couleur d'arrière-plan

Couleur d'arrière-plan du texte.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Couleur de premier plan

Couleur de premier plan du texte.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Taille de police

Taille de la police du texte.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

La taille par défaut est 11.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Famille de polices

Famille de polices du texte.

Toute police du menu Police de Google Docs ou de Google Fonts est acceptable.

La police par défaut est Arial.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Poids de la police

Poids de la police.

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

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

Ce champ doit être utilisé avec le champ Famille de polices, sinon la carte renvoie une erreur.

Consultez Poids de la police dans Aide relative au connecteur Google Docs.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Décalage de base

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

• Unspecified : le décalage de référence du texte est hérité du parent.
• None : le texte n'est pas décalé verticalement.
• Superscript : le texte est décalé verticalement vers le haut (exposant).
• Subscript : le texte est décalé verticalement vers le bas (indice).

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Lien

Une référence à une autre partie d'un document ou à d'une ressource URL externe.

Si ce champ est renseigné, vous devez également renseigner le champ Type de lien.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Type de lien

Le type de lien à référencer :

• External URL : Un URL externe
• Bookmark ID : l'ID d'un signet dans ce document.
• Heading ID : l'ID d'un titre dans ce document.

Si ce champ est renseigné, vous devez également renseigner le champ Lien.

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Créer des puces de paragraphe

Les champs suivants sont associés à l'option Create Paragraph Bullets.

Type de puce prédéfini

Type de puce à utiliser.

• Disc - Circle - Square

• DiamondX - Arrow3D - Square

• Checkbox

• Arrow - Diamond - Disc

• Star - Circle - Square

• Arrow3D - Circle - Square

• LeftTriangle - Diamond - Disc

• DiamondX - HollowDiamond - Square

• Diamond - Circle - Square

• Decimal - Alpha - Roman

• Parenthesis - Decimal - Alpha - Roman

• Numbered - Decimal - Nested

• UpperAlpha - Alpha - Roman

• UpperRoman - UpperAlpha - Decimal

• ZeroDecimal - Alpha - Roman

Ce champ s'affiche lorsque vous sélectionnez Update Text Style pour l'option Type d'operation.

Type de style nommé

Type de style nommé du paragraphe.

• Normal Text
• Title
• Subtitle
• Heading 1
• Heading 2
• Heading 3
• Heading 4
• Heading 5
• Heading 6

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Alignement du texte

Alignement du texte pour ce paragraphe.

• Inherited : l'alignement du paragraphe est hérité du parent.

• Start

• Center

• End

• Justified

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Espacement des lignes

La quantité d'espace entre les lignes, en pourcentage de la normale, où la normale est représentée par 100.

Sens du texte

Sens du texte de ce paragraphe.

Si cette valeur n'est pas définie, la valeur par défaut est Left to right, car le sens du paragraphe n'est pas hérité.

• Left to right
• Right to left

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Mode d'espacement

Mode d'espacement du paragraphe.

• Inherited : l'alignement du paragraphe est hérité du parent.
• Never collapse : l'espacement des paragraphes est toujours rendu.
• Collapse lists : l'espacement des paragraphes est ignoré entre les éléments de la liste.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Espace au-dessus

Quantité d'espace supplémentaire au-dessus du paragraphe.

Si cette valeur n'est pas définie, elle hérite de celle du parent.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Espace en dessous

Quantité d'espace supplémentaire en dessous du paragraphe.

Si cette valeur n'est pas définie, elle hérite de celle du parent.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Indentation de la première ligne

Quantité d'indentation pour la première ligne du paragraphe.

Si cette valeur n'est pas définie, elle hérite de celle du parent.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Indentation de début

Quantité d'indentation du paragraphe sur le côté qui correspond au début du texte, en fonction du sens actuel du paragraphe.

Si cette valeur n'est pas définie, elle hérite de celle du parent.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Indentation de fin

Quantité d'indentation du paragraphe sur le côté qui correspond à la fin du texte, en fonction du sens actuel du paragraphe.

Si cette valeur n'est pas définie, elle hérite de celle du parent.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Garder les lignes ensemble ?

Sélectionnez True si toutes les lignes du paragraphe doivent, dans la mesure du possible, être disposées sur la même page ou dans la même colonne. Sinon, définissez la valeur sur False.

Si cette valeur n'est pas définie, elle hérite de celle du parent.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Garder avec le suivant ?

Sélectionnez True si, dans la mesure du possible, au moins une partie de ce paragraphe doit être disposée sur la même page ou dans la même colonne que le paragraphe suivant. Sinon, définissez la valeur sur False.

Si cette valeur n'est pas définie, elle hérite de celle du parent.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

Ombrage

Couleur d'ombrage du paragraphe.

Ce champ s'affiche lorsque vous sélectionnez Update Paragraph Style pour l'option Type d'operation.

URL de l'image

Un indicateur de ressource uniforme (URI) d'image. L'image est extraite au moment de l'insertion et une copie est stockée pour être affichée dans le document.

Les images doivent avoir une taille inférieure à 50 Mo, ne peuvent pas dépasser 25 mégapixels et doivent être au format PNG, JPEG ou GIF.

La longueur de l'URI fourni ne doit pas dépasser 2 Ko. L'URI est enregistré avec l'image et exposé via le champ ImageProperties.content_uri.

Ce champ s'affiche lorsque vous sélectionnez Insert Inline Image pour l'option Type d'operation.

Hauteur d'image

Hauteur de l'image.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

Consultez Hauteur de l'image dans Aide relative au connecteur Google Docs.

Ce champ s'affiche lorsque vous sélectionnez Insert Inline Image pour l'option Type d'operation.

Largeur d'image

Largeur de l'image.

Les unités de mesure sont exprimées en points, équivalents à 1/72 de pouce.

Consultez Largeur d'image dans Aide relative au Google Docsconnecteur .

Ce champ s'affiche lorsque vous sélectionnez Insert Inline Image pour l'option Type d'operation.

Contrôle d'écriture

ID de révision

ID unique de la révision.

Type de révision

Choisir le type de révision :

• Required : ID de révision cible facultatif du document auquel s'applique la requête d'écriture. S'il ne s'agit pas de la dernière révision du document, la requête n'est pas traitée et renvoie une erreur 400.

  Lorsqu'un ID de révision requis est renvoyé dans une réponse, il désigne l'ID de révision du document après l'application de la requête.

• Target : ID de révision cible facultatif du document auquel s'applique la requête d'écriture.

  Si des modifications ont été appermissions par les collaborateurs après la lecture du document à l'aide de l'API, toute modification produite par cette requête d'écriture est appliquée aux modifications de collaborateurs. Il en résulte une nouvelle révision du document qui intègre à la fois les modifications des collaborateurs et les modifications de la requête, le serveur Google Docs résolvant les modifications conflictuelles. Lorsqu'il utilise un ID de révision cible, le client de l'API est considéré comme un autre collaborateur du document.

  L'ID de révision cible ne peut être utilisé que pour écrire dans les versions récentes d'un document. Si la révision cible est trop éloignée de la dernière révision, la requête n'est pas traitée et renvoie une erreur 400. Renvoyez la requête après avoir récupéré la dernière version du document. Généralement, un ID de révision reste valide pour être utilisé comme révision cible pendant plusieurs minutes après sa lecture, mais pour les documents fréquemment modifiés, ce délai peut être plus court.

Résultat

ID de révision obligatoire

L'ID de révision du document.

Utilisez l'ID de révision dans les requêtes de mise à jour pour indiquer à quelle révision d'un document les mises à jour doivent être appliquées et comment la requête doit se comporter si le document a été modifié depuis cette révision.

Ce champ s'affiche lorsque vous sélectionnez Insert Text, Update Text Style, Create Paragraph Bulletsou Update Paragraph Style pour l'option Type d'opération.

Occurrences modifiées

Le nombre de modèles modifiés par la carte.

Ce champ s'affiche lorsque vous sélectionnez Find and Replace pour l'option Type d'operation.

ID d'objet de l'image en ligne

L'ID d'objet de l'image inséré.

Ce champ s'affiche lorsque vous sélectionnez Insert Inline Image pour l'option Type d'operation.