Cells

CellData

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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
Champs
userEnteredValue

object (ExtendedValue)

Valeur saisie par l'utilisateur dans la cellule (par exemple, 1234, 'Hello' ou =NOW() Remarque: Les dates, heures et dates/heures sont représentées sous forme de 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, cette valeur est identique à 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 la rédaction, le nouveau format sera fusionné avec le format existant.

effectiveFormat

object (CellFormat)

Format effectif 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 de nombre calculé. Si le format effectif est le format par défaut, il n'est pas écrit. Ce champ est en lecture seule.

note

string

Toute note associée à la cellule.

textFormatRuns[]

object (TextFormatRun)

Extraits de texte enrichi appliqués à des sous-sections de la cellule. Les exécutions ne sont valides que pour les chaînes saisies par l'utilisateur, et non pour les formules, les valeurs booléennes ni les nombres. Les propriétés d'une exécution commencent à un indice spécifique dans le texte et se poursuivent jusqu'à l'exécution suivante. Les séries héritent des propriétés de la cellule, sauf si elles sont modifiées explicitement.

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

dataValidation

object (DataValidationRule)

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

Lors de l'écriture, la nouvelle règle de validation des données écrase 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 dynamiquement en fonction de ses données, de son regroupement, de ses filtres, de ses valeurs, etc. Seule la cellule en haut à gauche du tableau croisé dynamique contient sa définition. Les autres cellules contiennent les valeurs calculées des résultats du tableau croisé dynamique dans leurs champs effectiveValue.

dataSourceTable

object (DataSourceTable)

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

dataSourceFormula

object (DataSourceFormula)

Uniquement en sortie. Informations sur une formule de source de données dans 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).

chipRuns[]

object (ChipRun)

Facultatif. Exécutions de chips appliquées à des sous-sections de la cellule. Les propriétés d'une exécution commencent à un indice spécifique dans le texte et se poursuivent jusqu'à l'exécution suivante.

Lors de la lecture, toutes les courses avec puce et sans puce sont incluses. Les exécutions non chippées auront un Chip vide.

Lors de l'écriture, seules les courses avec des chips sont incluses. Les séquences contenant des chips sont de longueur 1 et sont représentées dans le texte saisi par l'utilisateur par un symbole d'espace réservé "@". Les nouvelles exécutions remplaceront les précédentes. L'écriture d'un nouveau userEnteredValue effacera les exécutions précédentes.

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 repré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 prévaut.

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 dans la cellule (sauf si un format est appliqué). Si vous définissez un lien au niveau de la cellule, les liens existants de la cellule sont effacés. La définition du champ de lien dans un TextFormatRun précède 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 du 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 ce paramètre n'est pas défini, un format par défaut basé sur les paramètres régionaux de l'utilisateur est utilisé si nécessaire pour le type donné. Pour en savoir plus sur les formats acceptés, consultez le guide des formats de date et de nombre.

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 dépend du contenu de la cellule. N'utilisez pas cette méthode explicitement.
TEXT Mise en forme du texte, par exemple : 1000.12
NUMBER Mise en forme des nombres (par exemple, 1,000.12)
PERCENT Mise en forme au format "Pourcentage", par exemple : 10.12%
CURRENCY Mise en forme des valeurs monétaires (par exemple, $1,000.12)
DATE Format de date (par exemple, 9/26/2008)
TIME Format d'heure, par exemple : 3:59:00 PM
DATE_TIME Format de date et d'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 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 prévaut.

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 en pointillés.
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 Aucune bordure. Utilisé uniquement lors de la mise à jour d'une bordure pour l'effacer.
DOUBLE La bordure est constituée de deux lignes pleines.

Marge intérieure

Marge intérieure autour de la cellule, en pixels. Lorsque vous mettez à jour la marge intérieure, vous devez spécifier tous les champs.

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é en haut de la cellule.
MIDDLE Le texte est explicitement aligné au milieu de la cellule.
BOTTOM Le texte est explicitement aligné en bas de la cellule.

WrapStrategy

Insérer un retour automatique à la ligne dans une cellule

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

Les lignes plus longues que la largeur de la cellule sont écrites dans la cellule suivante, à condition qu'elle soit vide. Si la cellule suivante n'est pas vide, le comportement est le même que pour 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 de retour à la ligne correspond à l'ancienne stratégie de Google Sheets, qui consiste à couper les mots plus longs qu'une ligne plutôt que de les scinder. Cette stratégie n'est pas compatible avec toutes les plates-formes et est en cours d'abandon. Exemple : 

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

Les lignes plus longues que la largeur de la cellule sont coupé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 qui sont plus longs qu'une ligne sont mis en retour à la ligne au niveau des caractères plutôt que coupés. Exemple : 

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

TextDirection

Sens du texte dans une cellule.

Enums
TEXT_DIRECTION_UNSPECIFIED Le sens du texte n'est pas spécifié. 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 a été définie de droite à gauche par l'utilisateur.

HyperlinkDisplayType

Indique si un lien hypertexte doit être affiché explicitement. Si aucune valeur n'est spécifiée, le lien hypertexte est associé.

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

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 qu'un des éléments suivants:
angle

integer

Angle entre l'orientation standard et l'orientation souhaitée. Mesuré 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 vers le bas.

Remarque: Pour le sens de texte de gauche à droite, les angles positifs sont dans le sens antihoraire, tandis que pour le sens de texte de droite à gauche, ils 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 se poursuit jusqu'à l'indice de début de l'exécution suivante. 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 (basé sur zéro) à partir duquel cette exécution commence, 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.

DataValidationRule

Règle de validation des données.

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

object (BooleanCondition)

Condition à laquelle les données de la cellule doivent répondre.

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'UI doit être personnalisée en fonction du type de condition. Si la valeur est "true", les conditions "List" (Liste) affichent une liste déroulante.

DataSourceTable

Table de source de données, qui permet à l'utilisateur d'importer une table statique de données depuis DataSource dans Sheets. Cette fonctionnalité est également appelée "Extraire" 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 de la source de données est associée.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Type à sélectionner pour les colonnes du tableau de la source de données. La valeur par défaut est SELECTED.

columns[]

object (DataSourceColumnReference)

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

filterSpecs[]

object (FilterSpec)

Spécifications du filtre dans le tableau des sources de données.

sortSpecs[]

object (SortSpec)

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

rowLimit

integer

Nombre maximal de lignes à renvoyer. Si aucune valeur n'est spécifiée, une limite par défaut est appliquée. Pour connaître la limite par défaut et la limite maximale, consultez l'éditeur Sheets.

dataExecutionStatus

object (DataExecutionStatus)

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

DataSourceTableColumnSelectionType

Types de sélection de colonnes dans le tableau 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 valeur est définie, la table de la source de données extrait 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 de l'exécution des données.

ChipRun

Exécution d'un chip. Le chip continue jusqu'à l'indice de début de l'exécution suivante.

Représentation JSON 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
Champs
startIndex

integer

Obligatoire. Index de caractère (basé sur zéro) à partir duquel cette exécution commence, en unités de code UTF-16.

chip

object (Chip)

Facultatif. Chip de cette course.

Puce

Chip intelligent

Représentation JSON 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
Champs
Champ d'union properties. Propriétés du chip. properties ne peut être qu'un des éléments suivants:
personProperties

object (PersonProperties)

Propriétés d'une personne associée.

PersonProperties

Propriétés spécifiques à une personne associée.

Représentation JSON 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
Champs
email

string

Obligatoire. Adresse e-mail associée à cette personne. Ce champ est toujours présent.

displayFormat

enum (DisplayFormat)

Facultatif. Format d'affichage du chip de contact. Si ce n'est pas le cas, le format d'affichage par défaut est utilisé.

DisplayFormat

Format d'affichage préféré, le cas échéant.

Enums
DISPLAY_FORMAT_UNSPECIFIED Valeur par défaut, ne pas utiliser.
DEFAULT Format d'affichage par défaut.
LAST_NAME_COMMA_FIRST_NAME Format d'affichage du nom et du prénom.
EMAIL Format d'affichage de l'e-mail.

RichLinkProperties

Propriétés d'un lien vers une ressource Google (par exemple, un fichier dans Drive, une vidéo YouTube, une adresse Maps ou un événement Agenda) Seuls les fichiers Drive peuvent être écrits sous forme de chips. Tous les autres types de liens enrichis sont en lecture seule.

Les URI ne doivent pas dépasser 2 000 octets lors de l'écriture.

REMARQUE: L'écriture de chips de fichiers Drive nécessite au moins l'un des champs d'application OAuth drive.file, drive.readonly ou drive.

Représentation JSON 
{
  "uri": string,
  "mimeType": string
}
Champs
uri

string

Obligatoire. URI du lien. Il est toujours présent.

mimeType

string

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