Cells

CellData

Données concernant une cellule spécifique.

Représentation JSON
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Champs
userEnteredValue

object (ExtendedValue)

Valeur saisie par l'utilisateur dans la cellule. Ex. : 1234, 'Hello' ou =NOW() Remarque: Les dates, les heures et les dates et heures sont représentées par des doubles dans serial number .

effectiveValue

object (ExtendedValue)

Valeur effective de la cellule. Pour les cellules contenant des formules, il s'agit de la valeur calculée. Pour les cellules contenant des littéraux, ce champ est la même que pour userEnteredValue. Ce champ est en lecture seule.

formattedValue

string

Valeur mise en forme de la cellule. Il s'agit de la valeur telle qu'elle est présentée à l'utilisateur. Ce champ est en lecture seule.

userEnteredFormat

object (CellFormat)

Format de cellule saisi par l'utilisateur.

Lors de l'écriture, le nouveau format sera fusionné avec le format existant.

effectiveFormat

object (CellFormat)

Format effectif utilisé par la cellule. Cela inclut le résultat de l'application d'une mise en forme conditionnelle et, si la cellule contient une formule, le format numérique calculé. Si le format effectif est le format par défaut, il ne sera pas écrit. Ce champ est en lecture seule.

note

string

Toute note sur la cellule.

textFormatRuns[]

object (TextFormatRun)

L'exécution du texte enrichi est appliquée aux sous-sections de la cellule. Les exécutions ne sont valides que pour les chaînes saisies par l'utilisateur, pas pour les formules, les chiffres ou les chiffres. Les propriétés d'une exécution commencent à un index spécifique dans le texte et se poursuivent jusqu'à la prochaine exécution. Les exécutions héritent des propriétés de la cellule, sauf si elles sont explicitement modifiées.

Lors de l'écriture, les nouvelles exécutions remplacent les exécutions précédentes. Lorsque vous écrivez une nouvelle userEnteredValue, les exécutions précédentes sont effacées.

dataValidation

object (DataValidationRule)

Une règle de validation des données sur la cellule, le cas échéant.

Lors de l'écriture, la nouvelle règle de validation des données remplace toute règle précédente.

pivotTable

object (PivotTable)

Tableau croisé dynamique ancré à cette cellule. La taille du tableau croisé dynamique lui-même est calculée de manière dynamique en fonction de ses données, de ses regroupements, de ses filtres, de ses valeurs, etc. Seule la cellule en haut à gauche du tableau croisé dynamique contient la définition du tableau croisé dynamique. Les autres cellules contiennent les valeurs calculées des résultats du tableau croisé dynamique dans leurs effectiveValue .

dataSourceTable

object (DataSourceTable)

Tableau de source de données ancré à cette cellule. La taille de la table de source de données elle-même est calculée de manière dynamique en fonction de sa configuration. Seule la première cellule du tableau contient la définition du tableau. Les autres cellules contiennent les valeurs d'affichage du résultat de la table de source de données dans leur effectiveValue .

dataSourceFormula

object (DataSourceFormula)

Uniquement en sortie. Informations sur une formule de source de données sur la cellule. Le champ est défini si userEnteredValue est une formule faisant référence à certaines DATA_SOURCE d'une feuille de calcul, par exemple =SUM(DataSheet!Column)

CellFormat

Format d'une cellule.

Représentation JSON
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Champs
numberFormat

object (NumberFormat)

Format décrivant comment les valeurs numériques doivent être présentées à l'utilisateur.

backgroundColor
(deprecated)

object (Color)

Couleur d'arrière-plan de la cellule. Obsolète: utilisez backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

Couleur d'arrière-plan de la cellule. Si backgroundColor est également défini, ce champ est prioritaire.

borders

object (Borders)

Bordures de la cellule.

padding

object (Padding)

Marge intérieure de la cellule.

horizontalAlignment

enum (HorizontalAlign)

Alignement horizontal de la valeur dans la cellule.

verticalAlignment

enum (VerticalAlign)

Alignement vertical de la valeur dans la cellule.

wrapStrategy

enum (WrapStrategy)

Stratégie de retour automatique à la ligne pour la valeur de la cellule.

textDirection

enum (TextDirection)

Sens du texte dans la cellule.

textFormat

object (TextFormat)

Format du texte de la cellule (sauf s'il est remplacé par une mise en forme). Le fait de définir un lien au niveau de la cellule ici efface les liens existants dans la cellule. Le fait de définir le champ du lien dans un TextFormatRun prévaut sur le lien au niveau de la cellule.

textRotation

object (TextRotation)

Rotation appliquée au texte de la cellule.

NumberFormat

Format numérique d'une cellule.

Représentation JSON
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Champs
type

enum (NumberFormatType)

Type de format numérique. Lors de l'écriture, ce champ doit être défini.

pattern

string

Chaîne de modèle utilisée pour la mise en forme. Si cette règle n'est pas configurée, un format par défaut basé sur les paramètres régionaux de l'utilisateur est utilisé si nécessaire pour le type donné. Consultez le Guide sur le format des dates et des nombres pour en savoir plus sur les formats acceptés.

NumberFormatType

Format numérique de la cellule. Dans cette documentation, les paramètres régionaux sont supposés être en_US, mais le format réel dépend des paramètres régionaux de la feuille de calcul.

Enums
NUMBER_FORMAT_TYPE_UNSPECIFIED Le format numérique n'est pas spécifié et est basé sur le contenu de la cellule. Ne l'utilisez pas explicitement.
TEXT Mise en forme du texte, par exemple 1000.12
NUMBER Mise en forme des nombres (ex. : 1,000.12
PERCENT Mise en forme des pourcentages (ex. : 10.12%
CURRENCY le format des devises (par exemple, $1,000.12
DATE Mise en forme des dates (par exemple, 9/26/2008
TIME Format de l'heure (ex. : 3:59:00 PM
DATE_TIME Mise en forme de la date et de l'heure, par exemple 9/26/08 15:59:00
SCIENTIFIC Mise en forme des nombres scientifiques (par exemple, 1.01E+03

Bordures

Bordures de la cellule.

Représentation JSON
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Champs
top

object (Border)

Bordure supérieure de la cellule.

bottom

object (Border)

Bordure inférieure de la cellule.

left

object (Border)

Bordure gauche de la cellule.

right

object (Border)

Bordure droite de la cellule.

Border

Bordure le long d'une cellule.

Représentation JSON
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Champs
style

enum (Style)

Style de la bordure.

width
(deprecated)

integer

Largeur de la bordure, en pixels. Obsolète ; la largeur est déterminée par le "style" .

color
(deprecated)

object (Color)

Couleur de la bordure. Obsolète: utilisez colorStyle

colorStyle

object (ColorStyle)

Couleur de la bordure. Si color est également défini, ce champ est prioritaire.

Style

Style de bordure.

Enums
STYLE_UNSPECIFIED Le style n'est pas spécifié. Ne l'utilisez pas.
DOTTED La bordure est en pointillés.
DASHED La bordure est en pointillés.
SOLID La bordure est composée d'une fine ligne continue.
SOLID_MEDIUM La bordure est composée d'une ligne continue moyenne.
SOLID_THICK La bordure est constituée d'une ligne continue épaisse.
NONE Aucune bordure. Utilisé uniquement lors de la modification d'une bordure afin de l'effacer.
DOUBLE La bordure est composée de deux lignes continues.

Marge intérieure

Quantité de marge intérieure autour de la cellule, en pixels. Lors de la mise à jour de la marge intérieure, chaque champ doit être spécifié.

Représentation JSON
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Champs
top

integer

Marge intérieure supérieure de la cellule.

right

integer

Marge intérieure droite de la cellule.

bottom

integer

Marge intérieure inférieure de la cellule.

left

integer

Marge intérieure gauche de la cellule.

VerticalAlign

Alignement vertical du texte dans une cellule.

Enums
VERTICAL_ALIGN_UNSPECIFIED L'alignement vertical n'est pas spécifié. Ne l'utilisez pas.
TOP Le texte est explicitement aligné sur le haut de la cellule.
MIDDLE Le texte est explicitement aligné au milieu de la cellule.
BOTTOM Le texte est explicitement aligné par rapport au bas de la cellule.

WrapStrategy

Comment activer le retour à la ligne automatique dans une cellule

Enums
WRAP_STRATEGY_UNSPECIFIED Valeur par défaut. Ne l'utilisez pas.
OVERFLOW_CELL

Les lignes plus longues que la largeur de la cellule seront écrites dans la cellule suivante, tant que cette cellule est vide. Si la cellule suivante n'est pas vide, le comportement est le même que CLIP Le texte ne sera jamais renvoyé à la ligne suivante, sauf si l'utilisateur n'insère pas manuellement une nouvelle ligne. Exemple :

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

Cette stratégie de retour automatique à la ligne est l'ancienne stratégie de retour à la ligne de Google Sheets, dans laquelle les mots plus longs qu'une ligne sont rognés au lieu d'être tronqués. Cette stratégie n'est pas compatible avec toutes les plates-formes et sera bientôt supprimée. Exemple :

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Les lignes plus longues que la largeur de la cellule sont tronquées. Le texte ne sera jamais renvoyé à la ligne suivante, sauf si l'utilisateur n'insère pas manuellement une nouvelle ligne. Exemple :

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Les mots plus longs qu'une ligne sont encapsulés au niveau des caractères au lieu d'être tronqués. Exemple :

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

Sens du texte dans une cellule.

Enums
TEXT_DIRECTION_UNSPECIFIED L'orientation du texte n'est pas spécifiée. Ne l'utilisez pas.
LEFT_TO_RIGHT L'orientation du texte de gauche à droite a été définie par l'utilisateur.
RIGHT_TO_LEFT L'orientation du texte de droite à gauche a été définie par l'utilisateur.

HyperlinkDisplayType

Indique si un lien hypertexte doit être affiché explicitement. S'il n'est pas spécifié, le lien hypertexte est lié.

Enums
LINKED Un lien hypertexte doit être affiché explicitement.
PLAIN_TEXT Aucun lien hypertexte ne doit s'afficher.

TextRotation

Rotation appliquée au texte d'une cellule.

Représentation JSON
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Champs
Champ d'union type Type de rotation (verticale ou inclinée). type ne peut être que l'un des éléments suivants:
angle

integer

Angle entre l'orientation standard et l'orientation souhaitée. Mesurée en degrés. Les valeurs valides sont comprises entre -90 et 90. Les angles positifs sont orientés vers le haut et les angles négatifs vers le bas.

Remarque: Les angles positifs de l'orientation de gauche à droite sont dans le sens inverse des aiguilles d'une montre, tandis que pour RTL, les angles positifs sont dans le sens des aiguilles d'une montre.

vertical

boolean

Si la valeur est "true", le texte se lit de haut en bas, mais l'orientation des caractères individuels reste inchangée. Exemple :

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

Exécution d'un format de texte. Le format de cette exécution continue jusqu'à l'index de début de la prochaine exécution. Lors de la mise à jour, tous les champs doivent être définis.

Représentation JSON
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
Champs
startIndex

integer

Index de caractère de base zéro où commence l'exécution, en unités de code UTF-16.

format

object (TextFormat)

Format de cette exécution. Les valeurs absentes héritent du format de la cellule.

DataValidationRule

Une règle de validation des données

Représentation JSON
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Champs
condition

object (BooleanCondition)

La condition à laquelle les données de la cellule doivent correspondre.

inputMessage

string

Message à afficher à l'utilisateur lorsqu'il ajoute des données à la cellule.

strict

boolean

"True" si les données non valides doivent être rejetées.

showCustomUi

boolean

"True" si l'interface utilisateur doit être personnalisée en fonction du type de condition. Si "true", "Liste" s'affichent dans un menu déroulant.

DataSourceTable

Une table de source de données, qui permet à l'utilisateur d'importer un tableau statique de données à partir de DataSource dans Sheets. Également appelé "extraction", dans l'éditeur Sheets.

Représentation JSON
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Champs
dataSourceId

string

ID de la source de données à laquelle la table est associée.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Type permettant de sélectionner les colonnes de la table de source de données. La valeur par défaut est SELECTED

columns[]

object (DataSourceColumnReference)

Colonnes sélectionnées pour la table de source de données. La columnSelectionType doit être SELECTED

filterSpecs[]

object (FilterSpec)

Filtrez les spécifications dans le tableau des sources de données.

sortSpecs[]

object (SortSpec)

Triez les spécifications dans la table de source de données. Le résultat du tableau des sources de données est trié en fonction des spécifications de tri, dans l'ordre.

rowLimit

integer

Limite de lignes à renvoyer. Si cette règle n'est pas configurée, une limite par défaut est appliquée. Veuillez vous reporter à l'éditeur Sheets pour connaître les limites par défaut et maximale.

dataExecutionStatus

object (DataExecutionStatus)

Uniquement en sortie. État d'exécution des données.

DataSourceTableColumnSelectionType

Types de sélection de colonnes du tableau de source de données.

Enums
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Type de sélection de colonne par défaut. Ne l'utilisez pas.
SELECTED Sélectionner les colonnes spécifiées par columns .
SYNC_ALL

Synchronisez toutes les colonnes actuelles et futures de la source de données.

Si cette option est définie, la table de source de données récupère toutes les colonnes de la source de données au moment de l'actualisation.

DataSourceFormula

Formule de source de données.

Représentation JSON
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Champs
dataSourceId

string

ID de la source de données à laquelle la formule est associée.

dataExecutionStatus

object (DataExecutionStatus)

Uniquement en sortie. État d'exécution des données.