Données mobiles
Données sur une cellule spécifique.
Représentation JSON |
---|
{ "userEnteredValue": { object ( |
Champs | |
---|---|
userEnteredValue
|
Valeur saisie par l'utilisateur dans la cellule (par exemple,
|
effectiveValue
|
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
|
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
|
Format saisi par l'utilisateur pour la cellule. Lors de l'écriture, le nouveau format sera fusionné avec le format existant. |
effectiveFormat
|
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. |
hyperlink
|
Lien hypertexte vers cette cellule, le cas échéant. Si la cellule contient plusieurs liens hypertextes, ce champ est vide. Ce champ est en lecture seule. Pour la définir, utilisez une formule |
note
|
N'importe quelle note dans la cellule. |
textFormatRuns[]
|
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 |
dataValidation
|
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
|
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 |
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 |
dataSourceFormula
|
Uniquement en sortie. Informations sur une formule de source de données sur la cellule. Le champ est défini si |
Format de cellule
Format d'une cellule.
Représentation JSON |
---|
{ "numberFormat": { object ( |
Champs | |
---|---|
numberFormat
|
Format décrivant la représentation des valeurs numériques auprès de l'utilisateur. |
backgroundColor
|
Couleur d'arrière-plan de la cellule. Obsolète: utilisez |
backgroundColorStyle
|
Couleur d'arrière-plan de la cellule. Si |
borders
|
Bordures de la cellule. |
padding
|
Marge intérieure de la cellule. |
horizontalAlignment
|
Alignement horizontal de la valeur dans la cellule. |
verticalAlignment
|
Alignement vertical de la valeur dans la cellule. |
wrapStrategy
|
Stratégie de retour à la ligne pour la valeur de la cellule. |
textDirection
|
Sens du texte dans la cellule. |
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 |
hyperlinkDisplayType
|
Le cas échéant, comment un lien hypertexte doit être affiché dans la cellule. |
textRotation
|
Rotation appliquée au texte de la cellule. |
NumberFormat
Format numérique d'une cellule.
Représentation JSON |
---|
{
"type": enum (
|
Champs | |
---|---|
type
|
Type de format numérique. Lors de l'écriture, ce champ doit être défini. |
pattern
|
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 ( |
Champs | |
---|---|
top
|
Bordure supérieure de la cellule. |
bottom
|
Bordure inférieure de la cellule. |
left
|
Bordure gauche de la cellule. |
right
|
Bordure droite de la cellule. |
Border
Bordure le long d'une cellule
Représentation JSON |
---|
{ "style": enum ( |
Champs | |
---|---|
style
|
Style de la bordure. |
width
|
Largeur de la bordure, en pixels. Obsolète. La largeur est déterminée par le champ "style". |
color
|
Couleur de la bordure. Obsolète: utilisez |
colorStyle
|
Couleur de la bordure. Si |
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
|
Marge intérieure supérieure de la cellule. |
right
|
Marge intérieure droite de la cellule. |
bottom
|
Marge intérieure inférieure de la cellule. |
left
|
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
|
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 :
|
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 :
|
WRAP
|
Les mots d'une longueur supérieure à une ligne sont encapsulées au niveau du caractère et non rognés. Exemple :
|
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 | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
Valeur par défaut: le lien hypertexte est affiché. Ne l'utilisez pas. |
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 |
Champs | |
---|---|
Champ d'union type . Type de rotation, verticale ou inclinée.
type ne peut être que l'un des éléments suivants:
|
|
angle
|
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
|
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 :
|
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 (
|
Champs | |
---|---|
startIndex
|
Index de caractère commençant par cette exécution. |
format
|
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 (
|
Champs | |
---|---|
condition
|
La condition à laquelle les données de la cellule doivent correspondre. |
inputMessage
|
Message à afficher à l'utilisateur lorsqu'il ajoute des données à la cellule. |
strict
|
Vrai si les données non valides doivent être refusées. |
showCustomUi
|
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 ( |
Champs | |
---|---|
dataSourceId
|
ID de la source de données à laquelle la table est associée. |
columnSelectionType
|
Type permettant de sélectionner des colonnes pour la table de source de données. La valeur par défaut est |
columns[]
|
Colonnes sélectionnées pour la table de source de données. |
filterSpecs[]
|
Spécifications des filtres dans le tableau de la source de données |
sortSpecs[]
|
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
|
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
|
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 (
|
Champs | |
---|---|
dataSourceId
|
ID de la source de données à laquelle la formule est associée. |
dataExecutionStatus
|
Uniquement en sortie. État d'exécution des données. |