Feuille de calcul
Feuille d'une feuille de calcul.
Représentation JSON |
---|
{ "properties": { object ( |
Champs | |
---|---|
properties
|
Propriétés de la feuille. |
data[]
|
Données de la grille, s'il s'agit d'une feuille sous forme de grille
Le nombre d'objets GridData renvoyés dépend du nombre de plages demandées sur cette feuille. Par exemple, s'il s'agit de
Pour une
|
merges[]
|
Plages fusionnées. |
conditionalFormats[]
|
Règles de mise en forme conditionnelle de cette feuille. |
filterViews[]
|
Vues filtrées de cette feuille. |
protectedRanges[]
|
Plages protégées de cette feuille. |
basicFilter
|
Le filtre de cette feuille, le cas échéant. |
charts[]
|
Spécifications de chaque graphique de cette feuille. |
bandedRanges[]
|
Les plages de bandes (couleurs alternées) de cette feuille. |
developerMetadata[]
|
Métadonnées de développement associées à une feuille. |
rowGroups[]
|
Tous les groupes de lignes de cette feuille, classés en augmentant l'index de début de la plage, puis par profondeur. |
columnGroups[]
|
Tous les groupes de colonnes de cette feuille, classés en augmentant l'index de début de la plage, puis par profondeur. |
slicers[]
|
Les segments de cette feuille. |
SheetProperties
Propriétés d'une feuille.
Représentation JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Champs | |
---|---|
sheetId
|
ID de la feuille. Cette valeur ne doit pas être négative Une fois défini, ce champ ne peut plus être modifié. |
title
|
Nom de la feuille. |
index
|
Index de la feuille dans la feuille de calcul. Lors de l'ajout ou de la mise à jour des propriétés de la feuille, si ce champ est exclu, la feuille est ajoutée ou déplacée à la fin de la liste des feuilles. Lors de la mise à jour d'index de feuilles ou de l'insertion de feuilles, le déplacement est considéré comme "avant le déplacement". index. Par exemple, s'il y avait trois feuilles (S1, S2, S3) pour pouvoir déplacer S1 avant S2, l'index doit être défini sur 2. Une demande de mise à jour de l'index de la feuille est ignorée si l'index demandé est identique à l'index actuel des feuilles ou si le nouvel index demandé est égal à l'index de la feuille actuelle + 1. |
sheetType
|
Type de feuille. La valeur par défaut est
|
gridProperties
|
Propriétés supplémentaires de la feuille si celle-ci est une grille. (Si la feuille est une feuille d'objet et qu'elle contient un graphique ou une image, ce champ ne sera pas renseigné.) Lorsque vous écrivez, vous ne pouvez pas définir les propriétés de la grille sur des feuilles qui ne sont pas des feuilles.
Si cette feuille est un
|
tabColor
|
Couleur de l'onglet dans l'interface utilisateur. Obsolète: utilisez
|
tabColorStyle
|
Couleur de l'onglet dans l'interface utilisateur. Si
|
rightToLeft
|
Ce champ est défini sur "true" si la feuille est de droite à gauche et non de gauche à droite. |
dataSourceSheetProperties
|
Uniquement en sortie. S'il est présent, le champ contient
|
SheetType
Type de feuille.
Enums | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Valeur par défaut, ne pas utiliser. |
GRID
|
La feuille est une grille. |
OBJECT
|
La feuille n'a pas de grille, mais un objet tel qu'un graphique ou une image. |
DATA_SOURCE
|
La feuille est reliée à une
DataSource
et affiche l'aperçu des données.
|
GridProperties
Propriétés d'une grille.
Représentation JSON |
---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
Champs | |
---|---|
rowCount
|
Nombre de lignes dans la grille. |
columnCount
|
Nombre de colonnes dans la grille. |
frozenRowCount
|
Nombre de lignes figées dans la grille. |
frozenColumnCount
|
Nombre de colonnes figées dans la grille. |
hideGridlines
|
"True" si la grille n'affiche pas de quadrillage dans l'interface utilisateur. |
rowGroupControlAfter
|
"True" si le bouton d'activation/de désactivation de la commande de regroupement des lignes s'affiche après le groupe. |
columnGroupControlAfter
|
"True" si le bouton d'activation du regroupement de colonnes s'affiche après le groupe. |
DataSourceSheetProperties
Autres propriétés d'un
DATA_SOURCE
feuille.
Représentation JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Champs | |
---|---|
dataSourceId
|
Identifiant du
|
columns[]
|
Les colonnes affichées sur la feuille, correspondant aux valeurs dans
|
dataExecutionStatus
|
État d'exécution des données. |
GridData
Données de la grille, ainsi que métadonnées sur les dimensions.
Représentation JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Champs | |
---|---|
startRow
|
La première ligne à laquelle ce GridData fait référence, base zéro. |
startColumn
|
La première colonne à laquelle ce GridData fait référence, base zéro. |
rowData[]
|
Données de la grille, une entrée par ligne, en commençant par la ligne dans startRow. Les valeurs dans RowData correspondront aux colonnes commençant par
|
rowMetadata[]
|
Métadonnées sur les lignes demandées dans la grille, en commençant par la ligne dans
|
columnMetadata[]
|
Métadonnées sur les colonnes demandées dans la grille, en commençant par la colonne dans
|
RowData
Données concernant chaque cellule d'une ligne.
Représentation JSON |
---|
{
"values": [
{
object (
|
Champs | |
---|---|
values[]
|
Valeurs de la ligne, une par colonne. |
DimensionProperties
Propriétés associées à une dimension.
Représentation JSON |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Champs | |
---|---|
pixelSize
|
Hauteur (pour une ligne) ou largeur (pour une colonne) de la dimension en pixels. |
developerMetadata[]
|
Métadonnées de développement associées à une seule ligne ou colonne. |
dataSourceColumnReference
|
Uniquement en sortie. Si cette option est définie, il s'agit d'une colonne dans la feuille de la source de données. |
ConditionalFormatRule
Règle décrivant un format conditionnel.
Représentation JSON |
---|
{ "ranges": [ { object ( |
Champs | |
---|---|
ranges[]
|
Plages mises en forme si la condition est vraie. Toutes les plages doivent figurer sur la même grille. |
Champ d'union
rule La règle contrôlant ce format conditionnel doit être définie.
rule
ne peut être que l'un des éléments suivants:
|
|
booleanRule
|
La mise en forme est activée. ou "désactivé" conformément à la règle. |
gradientRule
|
La mise en forme varie en fonction des dégradés de la règle. |
BooleanRule
Règle pouvant correspondre ou non, en fonction de la condition.
Représentation JSON |
---|
{ "condition": { object ( |
Champs | |
---|---|
condition
|
Condition de la règle. Si la condition renvoie la valeur "true", le format est appliqué. |
format
|
Format à appliquer. La mise en forme conditionnelle ne peut appliquer qu'un sous-ensemble de la mise en forme:
|
GradientRule
Règle qui applique un format de dégradé de couleurs en fonction des points d'interpolation répertoriés. Le format d'une cellule varie en fonction de son contenu par rapport aux valeurs des points d'interpolation.
Représentation JSON |
---|
{ "minpoint": { object ( |
Champs | |
---|---|
minpoint
|
Point d'interpolation de départ. |
midpoint
|
Point d'interpolation médian facultatif. |
maxpoint
|
Point d'interpolation final. |
InterpolationPoint
Point d'interpolation unique dans un format conditionnel de gradient. Ils épinglent le dégradé de couleurs en fonction de la couleur, du type et de la valeur choisies.
Représentation JSON |
---|
{ "color": { object ( |
Champs | |
---|---|
color
|
Couleur que ce point d'interpolation doit utiliser. Obsolète: utilisez
|
colorStyle
|
Couleur que ce point d'interpolation doit utiliser. Si
|
type
|
Façon dont la valeur doit être interprétée. |
value
|
Valeur utilisée par ce point d'interpolation. Il peut s'agir d'une formule. Non utilisé si
|
InterpolationPointType
Type de point d'interpolation.
Enums | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Valeur par défaut. Ne l'utilisez pas. |
MIN
|
Le point d'interpolation utilise la valeur minimale des cellules sur la plage du format conditionnel. |
MAX
|
Le point d'interpolation utilise la valeur maximale des cellules sur la plage du format conditionnel. |
NUMBER
|
Le point d'interpolation utilise exactement la valeur
InterpolationPoint.value
|
PERCENT
|
Le point d'interpolation est le pourcentage donné sur toutes les cellules de la plage du format conditionnel. Cela équivaut à
|
PERCENTILE
|
Le point d'interpolation correspond au centile donné sur toutes les cellules de la plage du format conditionnel. Cela équivaut à
NUMBER
si la valeur était:
=PERCENTILE(FLATTEN(range), value / 100)
(où les erreurs dans la plage sont ignorées lors de l'aplatissement).
|
FilterView
Une vue filtrée
Représentation JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Champs | |
---|---|
filterViewId
|
ID de la vue filtrée. |
title
|
Nom de la vue filtrée. |
range
|
Plage couverte par cette vue filtrée.
Lors de l'écriture, un seul des
|
namedRangeId
|
Plage nommée sur laquelle repose cette vue filtrée, le cas échéant.
Lors de l'écriture, un seul des
|
sortSpecs[]
|
Ordre de tri par colonne. Les spécifications ultérieures sont utilisées lorsque les valeurs sont égales dans les spécifications précédentes. |
criteria
|
Critères d'affichage/de masquage des valeurs par colonne. La clé de la carte est l'index de colonne et la valeur est les critères de cette colonne.
Ce champ est obsolète et a été remplacé par
|
filterSpecs[]
|
Critères de filtre pour afficher/masquer les valeurs par colonne.
Les deux
|
ProtectedRange
Une plage protégée.
Représentation JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
Champs | |
---|---|
protectedRangeId
|
Identifiant de la plage protégée. Ce champ est en lecture seule. |
range
|
Plage protégée. La plage peut être totalement illimitée, auquel cas on considère qu'il s'agit d'une feuille protégée.
Lors de l'écriture, un seul des
|
namedRangeId
|
Plage nommée sur laquelle repose cette plage protégée, le cas échéant.
Lors de l'écriture, un seul des
|
description
|
Description de cette plage protégée. |
warningOnly
|
"True" si cette plage protégée affiche un avertissement lors de la modification. La protection basée sur les avertissements signifie que chaque utilisateur peut modifier les données de la plage protégée, à l'exception de toute modification qui entraîne l'affichage d'un avertissement demandant à l'utilisateur de confirmer sa modification.
Lors de l'écriture: si ce champ est vrai, alors
|
requestingUserCanEdit
|
"True" si l'utilisateur qui a demandé cette plage protégée peut modifier la zone protégée. Ce champ est en lecture seule. |
unprotectedRanges[]
|
Liste des plages non protégées d'une feuille protégée. Les plages non protégées ne sont compatibles qu'avec les feuilles protégées. |
editors
|
Utilisateurs et groupes autorisés à modifier la plage protégée. Ce champ n'est visible que par les utilisateurs autorisés à modifier la plage protégée et le document. Les éditeurs ne sont pas compatibles avec
|
Rédacteurs
Éditeurs d'une plage protégée.
Représentation JSON |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
Champs | |
---|---|
users[]
|
Adresses e-mail des utilisateurs autorisés à modifier la plage protégée. |
groups[]
|
Adresses e-mail des groupes autorisés à modifier la plage protégée. |
domainUsersCanEdit
|
"True" si un utilisateur du domaine du document est autorisé à modifier la plage protégée. La protection d'un domaine n'est prise en charge que pour les documents faisant partie d'un domaine. |
BasicFilter
Filtre par défaut associé à une feuille.
Représentation JSON |
---|
{ "range": { object ( |
Champs | |
---|---|
range
|
Plage couverte par le filtre. |
sortSpecs[]
|
Ordre de tri par colonne. Les spécifications ultérieures sont utilisées lorsque les valeurs sont égales dans les spécifications précédentes. |
criteria
|
Critères d'affichage/de masquage des valeurs par colonne. La clé de la carte est l'index de colonne et la valeur est les critères de cette colonne.
Ce champ est obsolète et a été remplacé par
|
filterSpecs[]
|
Critères de filtre par colonne.
Les deux
|
BandedRange
Gamme de bandes (couleurs alternées) dans une feuille.
Représentation JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Champs | |
---|---|
bandedRangeId
|
Identifiant de la plage en bandes. |
range
|
Plage dans laquelle ces propriétés sont appliquées. |
rowProperties
|
Propriétés des bandes de lignes. Ces propriétés sont appliquées ligne par ligne à toutes les lignes de la plage. Au moins l'une des valeurs suivantes :
|
columnProperties
|
Propriétés des bandes de colonnes. Ces propriétés sont appliquées colonne par colonne à toutes les colonnes de la plage. Au moins l'une des valeurs suivantes :
|
BandingProperties
Propriétés faisant référence à une seule dimension (ligne ou colonne). Si les
BandedRange.row_properties
et
BandedRange.column_properties
sont définies, les couleurs de remplissage sont appliquées aux cellules selon les règles suivantes:
-
headerColor
etfooterColor
ont priorité sur les couleurs des bracelets. -
firstBandColor
est prioritaire sursecondBandColor
-
rowProperties
est prioritaire surcolumnProperties
Par exemple, la couleur de la première ligne prévaut sur la couleur de la première colonne, mais celle de la première colonne prévaut sur celle de la deuxième ligne. De même, l'en-tête de ligne est prioritaire sur l'en-tête de colonne dans la cellule supérieure gauche, mais l'en-tête de colonne est prioritaire sur la couleur de la première ligne si l'en-tête de ligne n'est pas défini.
Représentation JSON |
---|
{ "headerColor": { object ( |
Champs | |
---|---|
headerColor
|
Couleur de la première ligne ou colonne. Si ce champ est défini, la première ligne ou colonne est remplie avec cette couleur et les couleurs alternent entre
|
headerColorStyle
|
Couleur de la première ligne ou colonne. Si ce champ est défini, la première ligne ou colonne est remplie avec cette couleur et les couleurs alternent entre
|
firstBandColor
|
Première couleur en alternance. (Obligatoire) Obsolète: utilisez
|
firstBandColorStyle
|
Première couleur en alternance. (Obligatoire) Si
|
secondBandColor
|
Deuxième couleur en alternance. (Obligatoire) Obsolète: utilisez
|
secondBandColorStyle
|
Deuxième couleur en alternance. (Obligatoire) Si
|
footerColor
|
Couleur de la dernière ligne ou colonne. Si ce champ n'est pas défini, la dernière ligne ou colonne est remplie avec
|
footerColorStyle
|
Couleur de la dernière ligne ou colonne. Si ce champ n'est pas défini, la dernière ligne ou colonne est remplie avec
|
DimensionGroup
Un groupe sur un intervalle de lignes ou de colonnes d'une feuille, qui peut contenir ou être contenu dans d'autres groupes. Un groupe peut être réduit ou développé en tant qu'unité sur la feuille.
Représentation JSON |
---|
{
"range": {
object (
|
Champs | |
---|---|
range
|
Plage dans laquelle ce groupe existe. |
depth
|
La profondeur du groupe, qui représente le nombre de groupes dont la plage contient entièrement celle de ce groupe. |
collapsed
|
Ce champ est "true" si ce groupe est réduit. Un groupe réduit reste réduit si un groupe qui se chevauche moins profondément est développé. La valeur "true" ne signifie pas que toutes les dimensions du groupe sont masquées, car la visibilité d'une dimension peut changer indépendamment de la propriété du groupe. Toutefois, lorsque cette propriété est mise à jour, toutes les dimensions qu'elle contient sont masquées si ce champ est défini sur "true" ou comme visibles si la valeur du champ est "false". |
Segment
Segment dans une feuille.
Représentation JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Champs | |
---|---|
slicerId
|
ID du segment. |
spec
|
Spécification du segment. |
position
|
Position du segment. Notez que le segment ne peut être positionné que sur une feuille existante. De plus, la largeur et la hauteur du segment peuvent être ajustées automatiquement pour respecter les limites autorisées. |
SlicerSpec
Spécifications d'un segment.
Représentation JSON |
---|
{ "dataRange": { object ( |
Champs | |
---|---|
dataRange
|
Plage de données du segment. |
filterCriteria
|
Critères de filtrage du segment. |
columnIndex
|
Index de colonne de base zéro dans la table de données à laquelle le filtre est appliqué. |
applyToPivotTables
|
"True" si le filtre doit s'appliquer aux tableaux croisés dynamiques. Si ce champ n'est pas défini, utiliser par défaut
|
title
|
Titre du segment. |
textFormat
|
Format de texte du titre dans le segment. Le champ "Lien" n'est pas accepté. |
backgroundColor
|
Couleur d'arrière-plan du segment. Obsolète: utilisez
|
backgroundColorStyle
|
Couleur d'arrière-plan du segment. Si
|
horizontalAlignment
|
Alignement horizontal du titre dans le segment. Si aucune valeur n'est spécifiée, la valeur par défaut est définie sur
|