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 date/heures sont représentées sous forme de valeurs 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.

Lorsque vous écrivez, le nouveau format est 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 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)

Séquences de texte enrichi appliquées aux 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 ou les nombres. Les propriétés d'une exécution commencent à un index spécifique dans le texte et se poursuivent jusqu'à l'exécution suivante. Les exécutions héritent des propriétés de la cellule, sauf si elles sont explicitement modifiées.

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

dataValidation

object (DataValidationRule)

Règle de validation des données dans la cellule, le cas échéant.

Lorsque vous écrivez, 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 son regroupement, 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 contiendront les valeurs calculées des résultats du tableau croisé dynamique dans leurs champs effectiveValue.

dataSourceTable

object (DataSourceTable)

Table de source de données ancrée dans 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 de source de données contient la définition du tableau de source de données. Les autres cellules contiendront les valeurs d'affichage du résultat de la table 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 aux sous-sections de la cellule. Les propriétés d'une exécution commencent à un index spécifique dans le texte et se poursuivent jusqu'à l'exécution suivante.

Lors de la lecture, toutes les courses avec et sans puce sont incluses. Les courses sans puce auront un Chip vide.

Seules les courses avec des chips sont incluses dans les statistiques. Les séquences contenant des chips sont de longueur 1 et sont représentées dans le texte saisi par l'utilisateur par un espace réservé "@". Les nouvelles exécutions écraseront 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 la façon dont 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 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 d'habillage 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 de plage le remplace). Si vous définissez un lien au niveau d'une cellule, les liens existants de cette cellule sont effacés. La définition du champ de lien dans un TextFormatRun est prioritaire par rapport au lien au niveau de la cellule.

textRotation

object (TextRotation)

Rotation appliquée au texte dans 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. Ce champ doit être défini lors de l'écriture.

pattern

string

Chaîne de modèle utilisée pour la mise en forme. Si aucun format n'est défini, un format par défaut basé sur les paramètres régionaux de la feuille de calcul sera utilisé si nécessaire pour le type donné. Pour en savoir plus sur les modèles acceptés, consultez le guide sur les 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. Ne l'utilisez pas 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 en pourcentage, par exemple : 10.12%
CURRENCY Mise en forme des devises, par exemple $1,000.12
DATE Mise en forme de la date, par exemple 9/26/2008
TIME Mise en forme de l'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 scientifique des nombres, 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 est prioritaire.

Style

Style d'une bordure.

Enums
STYLE_UNSPECIFIED Le style n'est pas spécifié. Ne pas utiliser.
DOTTED La bordure est en pointillés.
DASHED La bordure est en pointillés.
SOLID La bordure est une fine ligne continue.
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.

Marges intérieures

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

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

WrapStrategy

Découvrez comment 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 seront é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 passera jamais à 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 représente l'ancienne stratégie de retour à la ligne de Google Sheets, dans laquelle les mots plus longs qu'une ligne sont tronqués plutôt que coupés. 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 seront coupées. Le texte ne passera jamais à 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 dépassent la longueur d'une ligne sont renvoyés à la ligne au niveau du caractère plutôt que 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 Le sens du texte n'est pas spécifié. Ne pas utiliser.
LEFT_TO_RIGHT L'utilisateur a défini le sens du texte de gauche à droite.
RIGHT_TO_LEFT L'utilisateur a défini le sens du texte de droite à gauche.

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é de manière explicite.
PLAIN_TEXT Aucun lien hypertexte ne doit ê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. Mesure exprimé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 : Pour le sens d'écriture de gauche à droite, les angles positifs sont dans le sens inverse des aiguilles d'une montre, tandis que pour le sens d'écriture 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

Une série de texte dans un format donné. Le format de cette exécution se poursuit jusqu'à l'index 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) où commence cette 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

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 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 refusé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 un menu déroulant.

DataSourceTable

Table de source de données, qui permet à l'utilisateur d'importer une table de données statiques depuis DataSource dans Sheets. Dans l'éditeur Sheets, cette option est également appelée "Extraire".

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 source de données 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 le tableau de la source de données. columnSelectionType doit être SELECTED.

filterSpecs[]

object (FilterSpec)

Filtrez les spécifications dans le tableau de la source de données.

sortSpecs[]

object (SortSpec)

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

rowLimit

integer

Limite du nombre de lignes à renvoyer. Si aucune limite n'est définie, une limite par défaut est appliquée. Veuillez consulter l'éditeur Sheets pour connaître les limites par défaut et maximales.

dataExecutionStatus

object (DataExecutionStatus)

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

DataSourceTableColumnSelectionType

Types de sélection des 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 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, la table de la 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.

ChipRun

Exécution d'un chip. Le chip se poursuit jusqu'à l'index de début de la série suivante.

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

integer

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

chip

object (Chip)

Facultatif. Chip de cette course.

Chip

Le 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 de la chip de contact. Si elle n'est pas définie, 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'adresse 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 peuvent 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. Cette valeur est toujours présente.

mimeType

string

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