Cells

Données mobiles

Données sur 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 (par exemple, 1234, 'Hello' ou =NOW() Remarque: Les dates, les heures et les dates et heures sont représentées par des doubles au format 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, il s'agit de la même valeur que userEnteredValue. Ce champ est en lecture seule.

formattedValue

string

Valeur formatée 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 saisi par l'utilisateur pour la cellule.

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

effectiveFormat

object (CellFormat)

Format utilisé par la cellule. Cela inclut les résultats 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

N'importe quelle note dans la cellule.

textFormatRuns[]

object (TextFormatRun)

Exécutions de texte enrichi appliquées aux sous-sections de la cellule. Les exécutions ne sont valides que sur les chaînes saisies par l'utilisateur, et non sur les formules, les valeurs booléennes ou les chiffres. Les propriétés d'une exécution commencent à un indice spécifique dans le texte et se terminent jusqu'à la prochaine exécution. Les exécutions hériteront des propriétés de la cellule, sauf modification explicite.

Lors de l'écriture, les nouvelles exécutions écraseront les exécutions précédentes. Lorsque vous écrivez un nouveau userEnteredValue, les exécutions précédentes sont supprimé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 remplacera toute règle précédente.

pivotTable

object (PivotTable)

Tableau croisé dynamique ancré sur cette cellule. La taille du tableau croisé dynamique est calculée dynamiquement en fonction de ses données, groupes, filtres, valeurs, etc. Seule la cellule en haut à gauche du tableau croisé dynamique contient la définition du tableau. Les autres cellules contiennent les valeurs calculées des résultats du tableau croisé dynamique dans leurs champs effectiveValue.

dataSourceTable

object (DataSourceTable)

Tableau de source de données ancré à cette cellule. La taille de la table de source de données est calculée dynamiquement en fonction de sa configuration. Seule la première cellule du tableau de source de données contient la définition du tableau. Les autres cellules contiennent les valeurs d'affichage de la table de source de données dans leurs champs 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 à une feuille DATA_SOURCE (par exemple, =SUM(DataSheet!Column)).

Format de cellule

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 la représentation des valeurs numériques auprès de 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 à 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 ignoré par une exécution de format). Définir un lien au niveau d'une cellule efface tous les liens existants. Définir le champ "link" dans un élément TextFormatRun a priorité 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 format 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 des formats de date et de nombre pour en savoir plus sur les formats acceptés.

TypeFormatFormat

Format numérique de la cellule. Dans cette documentation, nous partons du principe que les paramètres régionaux sont 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 Format numérique (ex. : 1,000.12)
PERCENT Format de pourcentage (par exemple, 10.12%)
CURRENCY Format de la devise (par exemple, $1,000.12)
DATE Format de date (ex. : 9/26/2008)
TIME Format de l'heure, par exemple 3:59:00 PM
DATE_TIME Format date/heure, par exemple 9/26/08 15:59:00
SCIENTIFIC Mise en forme des nombres scientifiques (ex. : 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 champ "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 d'une 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 encadrée.
SOLID La bordure est une ligne continue fine.
SOLID_MEDIUM La bordure est une ligne continue moyenne.
SOLID_THICK La bordure est une ligne continue épaisse.
NONE Sans bordure. Utilisée uniquement lors de la mise à jour d'une bordure pour l'effacer.
DOUBLE La bordure comporte deux lignes pleines.

Marge intérieure

Quantité de marge intérieure autour de la cellule, en pixels. Lorsque vous mettez à jour une marge intérieure, tous les champs doivent être spécifiés.

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.

Aligner verticalement

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 la partie supérieure de la cellule.
MIDDLE Le texte est explicitement aligné au centre de la cellule.
BOTTOM Le texte est explicitement aligné au bas de la cellule.

Stratégie de retour à la ligne

Encapsuler du texte dans une cellule

Enums
WRAP_STRATEGY_UNSPECIFIED Valeur par défaut, ne pas utiliser.
OVERFLOW_CELL

Les lignes dont la longueur est supérieure à la largeur de la cellule sont é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 s'affichera jamais sur la ligne suivante, sauf si l'utilisateur insère 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 d'encapsulation correspond à l'ancienne stratégie de retour à la ligne de Google Sheets, qui consiste à rogner les mots qui sont plus longs qu'une ligne au lieu de les couper. Cette stratégie n'est pas disponible sur toutes les plates-formes et sera progressivement abandonnée. Exemple :

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

Les lignes plus longues que la cellule sont tronquées. Le texte ne s'affichera jamais sur la ligne suivante, sauf si l'utilisateur insère manuellement une nouvelle ligne. Exemple :

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

Les mots d'une longueur supérieure à une ligne sont encapsulées au niveau du caractère et non rognés. Exemple :

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

Direction du texte

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 s'il faut afficher explicitement un lien hypertexte. S'il n'est pas spécifié, le lien hypertexte est associé.

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

Rotation du texte

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. Mesures en degrés. Les valeurs valides sont comprises entre -90 et 90. Les angles positifs sont inclinés vers le haut, les angles négatifs sont inclinés vers le bas.

Remarque: Pour l'orientation du texte de gauche à droite, les angles positifs sont dans le sens inverse des aiguilles d'une montre. Pour le texte de droite à gauche, ils sont dans le sens horaire.

vertical

boolean

Si la valeur est "true", le texte est lu de haut en bas, mais l'orientation des caractères individuels reste la même. Exemple :

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

Exécuter TextFormat

Exécution d'un format de texte. Le format de cette exécution se poursuit 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 zéro là où commence cette exécution, en unités de code UTF-16.

format

object (TextFormat)

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

Règle de validation des données

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

Vrai si les données non valides doivent être refusées.

showCustomUi

boolean

Vrai si l'interface utilisateur doit être personnalisée en fonction du type de condition. Si la valeur est "true", un menu déroulant s'affiche avec les conditions "Liste".

Table des sources de données

Table de source de données permettant à l'utilisateur d'importer une table statique de données de DataSource dans Sheets. C'est ce que l'on appelle un extrait 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 des colonnes pour 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. columnSelectionType doit être défini sur SELECTED.

filterSpecs[]

object (FilterSpec)

Spécifications des filtres dans le tableau de la source de données

sortSpecs[]

object (SortSpec)

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

rowLimit

integer

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

dataExecutionStatus

object (DataExecutionStatus)

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

DataSourceTableColumnSelectionType

Types de sélection de colonnes de la table de la source de données.

Enums
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Type de sélection de colonnes par défaut. Ne pas utiliser.
SELECTED Sélectionnez les colonnes spécifiées par le champ columns.
SYNC_ALL

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

Si cette option est définie, le tableau de la source de données extrait toutes les colonnes de la source de données au moment de l'actualisation.

Formule de la source de données

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.