Sheets

Sheets

Feuille d'une feuille de calcul.

Représentation JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Champs
properties

object (SheetProperties)

Propriétés de la feuille.

data[]

object (GridData)

Les données de la grille, s'il s'agit d'une feuille de calcul en 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 Sheet1 et que la feuille de calcul a été demandée avec les plages Sheet1!A1:C10 et Sheet1!D15:E20, le premier GridData aura un startRow/startColumn de 0, tandis que le second aura startRow 14 (ligne 15 à partir de zéro) et startColumn 3 (colonne D à partir de zéro).

Pour une feuille DATA_SOURCE, vous ne pouvez pas demander une plage spécifique, car GridData contient toutes les valeurs.

merges[]

object (GridRange)

Les plages qui sont fusionnées.

conditionalFormats[]

object (ConditionalFormatRule)

Règles de mise en forme conditionnelle de cette feuille.

filterViews[]

object (FilterView)

Les vues filtrées de cette feuille.

protectedRanges[]

object (ProtectedRange)

Plages protégées de cette feuille.

basicFilter

object (BasicFilter)

Filtre appliqué à cette feuille, le cas échéant.

charts[]

object (EmbeddedChart)

Spécifications de chaque graphique de cette feuille.

bandedRanges[]

object (BandedRange)

Les plages à bandes (couleurs alternées) de cette feuille.

developerMetadata[]

object (DeveloperMetadata)

Métadonnées du développeur associées à une feuille.

rowGroups[]

object (DimensionGroup)

Tous les groupes de lignes de cette feuille, triés par ordre croissant de l'indice de début de la plage, puis par profondeur de groupe.

columnGroups[]

object (DimensionGroup)

Tous les groupes de colonnes de cette feuille, triés par ordre croissant de l'indice de début de la plage, puis par profondeur de groupe.

slicers[]

object (Slicer)

Les sélecteurs de cette feuille.

tables[]

object (Table)

Les tableaux de cette feuille.

SheetProperties

Propriétés d'une feuille.

Représentation JSON 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Champs
sheetId

integer

ID de la feuille. Cette valeur ne doit pas être négative Une fois défini, ce champ ne peut plus être modifié.

title

string

Nom de la feuille.

index

integer

Indice de la feuille dans la feuille de calcul. Lorsque vous ajoutez ou mettez à jour des propriétés de feuille, si ce champ est exclu, la feuille est ajoutée ou déplacée à la fin de la liste des feuilles. Lorsque vous mettez à jour les indices de feuille ou insérez des feuilles, le déplacement est pris en compte dans les indices "avant le déplacement". Par exemple, si vous disposez de trois feuilles (S1, S2 et S3), vous devez définir l'index sur 2 pour placer S1 avant S2. Une requête de mise à jour de l'index de la feuille est ignorée si l'index demandé est identique à l'index actuel de la feuille ou si le nouvel index demandé est égal à l'index actuel de la feuille + 1.

sheetType

enum (SheetType)

Type de feuille. La valeur par défaut est GRID. Une fois défini, ce champ ne peut plus être modifié.

gridProperties

object (GridProperties)

Propriétés supplémentaires de la feuille si celle-ci est une grille. (Si la feuille est une feuille d'objet, contenant un graphique ou une image, ce champ n'est pas présent.) Lors de l'écriture, il est impossible de définir des propriétés de grille sur des feuilles sans grille.

Si cette feuille est une feuille DATA_SOURCE, ce champ est uniquement de sortie, mais contient les propriétés qui reflètent la façon dont une feuille de source de données est affichée dans l'UI, par exemple rowCount.

hidden

boolean

"True" si la feuille est masquée dans l'interface utilisateur, "false" si elle est visible.

tabColor
(deprecated)

object (Color)

Couleur de l'onglet dans l'interface utilisateur. Obsolète: utilisez tabColorStyle.

tabColorStyle

object (ColorStyle)

Couleur de l'onglet dans l'interface utilisateur. Si tabColor est également défini, ce champ prévaut.

rightToLeft

boolean

"True" si la feuille est au format RTL au lieu d'être au format LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Uniquement en sortie. Si ce champ est présent, il contient des propriétés spécifiques à la feuille DATA_SOURCE.

SheetType

Type de feuille.

Enums
SHEET_TYPE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
GRID La feuille est une grille.
OBJECT La feuille ne comporte pas de grille, mais un objet tel qu'un graphique ou une image.
DATA_SOURCE La feuille se connecte à un DataSource externe et affiche un 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

integer

Nombre de lignes dans la grille.

columnCount

integer

Nombre de colonnes dans la grille.

frozenRowCount

integer

Nombre de lignes figées dans la grille.

frozenColumnCount

integer

Nombre de colonnes figées dans la grille.

hideGridlines

boolean

"True" si la grille n'affiche pas de lignes dans l'interface utilisateur.

rowGroupControlAfter

boolean

"True" si le bouton d'activation/de désactivation du regroupement des lignes s'affiche après le groupe.

columnGroupControlAfter

boolean

"True" si le bouton d'activation/de désactivation du regroupement des colonnes s'affiche après le groupe.

DataSourceSheetProperties

Propriétés supplémentaires d'une feuille DATA_SOURCE.

Représentation JSON 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Champs
dataSourceId

string

ID de l'DataSource auquel la feuille est associée.

columns[]

object (DataSourceColumn)

Colonnes affichées sur la feuille, correspondant aux valeurs de RowData.

dataExecutionStatus

object (DataExecutionStatus)

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

GridData

Les données de la grille, ainsi que les métadonnées sur les dimensions

Représentation JSON 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Champs
startRow

integer

Première ligne à laquelle cette GridData fait référence, sur la base de zéro.

startColumn

integer

Première colonne à laquelle cette GridData fait référence, sur la base de zéro.

rowData[]

object (RowData)

Données de la grille, une entrée par ligne, en commençant par la ligne de startRow. Les valeurs de RowData correspondent aux colonnes commençant à startColumn.

rowMetadata[]

object (DimensionProperties)

Métadonnées sur les lignes demandées dans la grille, en commençant par la ligne dans startRow.

columnMetadata[]

object (DimensionProperties)

Métadonnées sur les colonnes demandées dans la grille, en commençant par la colonne dans startColumn.

RowData

Données sur chaque cellule d'une ligne.

Représentation JSON 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Champs
values[]

object (CellData)

Valeurs de la ligne, une par colonne.

DimensionProperties

Propriétés d'une dimension.

Représentation JSON 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Champs
hiddenByFilter

boolean

"True" si cette dimension est filtrée. Ce champ est en lecture seule.

hiddenByUser

boolean

"True" si cette dimension est explicitement masquée.

pixelSize

integer

Hauteur (si la dimension est une ligne) ou largeur (si la dimension est une colonne) de la dimension en pixels.

developerMetadata[]

object (DeveloperMetadata)

Métadonnées de développement associées à une seule ligne ou colonne.

dataSourceColumnReference

object (DataSourceColumnReference)

Uniquement en sortie. Si cette valeur est définie, il s'agit d'une colonne dans une feuille de source de données.

ConditionalFormatRule

Règle décrivant un format conditionnel.

Représentation JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Champs
ranges[]

object (GridRange)

Intervalles mis en forme si la condition est vraie. Toutes les plages doivent se trouver sur la même grille.

Champ d'union rule. La règle qui contrôle ce format conditionnel doit être définie exactement une fois. rule ne peut être qu'un des éléments suivants:
booleanRule

object (BooleanRule)

Le formatage est activé ou désactivé en fonction de la règle.

gradientRule

object (GradientRule)

Le formatage varie en fonction des dégradés de la règle.

BooleanRule

Règle qui peut ou non correspondre, en fonction de la condition.

Représentation JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Champs
condition

object (BooleanCondition)

Condition de la règle. Si la condition renvoie la valeur "true", le format est appliqué.

format

object (CellFormat)

Format à appliquer. Le formatage conditionnel ne peut appliquer qu'un sous-ensemble de formats : bold, italic, strikethrough, foreground color et background color.

GradientRule

Règle qui applique un format d'échelle de couleurs en dégradé, en fonction des points d'interpolation listé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 (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Champs
minpoint

object (InterpolationPoint)

Point d'interpolation de départ.

midpoint

object (InterpolationPoint)

Point d'interpolation intermédiaire facultatif.

maxpoint

object (InterpolationPoint)

Point d'interpolation final.

InterpolationPoint

Un seul point d'interpolation sur un format conditionnel de dégradé. Ils épinglent l'échelle de couleurs du dégradé en fonction de la couleur, du type et de la valeur choisis.

Représentation JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Champs
color
(deprecated)

object (Color)

Couleur que ce point d'interpolation doit utiliser. Obsolète: utilisez colorStyle.

colorStyle

object (ColorStyle)

Couleur que ce point d'interpolation doit utiliser. Si color est également défini, ce champ prévaut.

type

enum (InterpolationPointType)

Indique comment la valeur doit être interprétée.

value

string

Valeur utilisée par ce point d'interpolation. Peut être une formule. Inutilisé si type est MIN ou MAX.

InterpolationPointType

Type de point d'interpolation.

Enums
INTERPOLATION_POINT_TYPE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
MIN Le point d'interpolation utilise la valeur minimale des cellules de 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 de InterpolationPoint.value.
PERCENT

Le point d'interpolation correspond au pourcentage donné pour toutes les cellules de la plage du format conditionnel. Cela équivaut à NUMBER si la valeur était =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (les erreurs de la plage sont ignorées lors de l'aplatissement).

PERCENTILE Le point d'interpolation correspond au centile donné pour toutes les cellules de la plage du format conditionnel. Cela équivaut à NUMBER si la valeur était =PERCENTILE(FLATTEN(range), value / 100) (les erreurs de la plage sont ignorées lors de l'aplatissement).

FilterView

Vue filtrée.

Représentation JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Champs
filterViewId

integer

ID de la vue de filtre.

title

string

Nom de la vue de filtre.

range

object (GridRange)

Plage couverte par cette vue filtrée.

Lors de l'écriture, vous ne pouvez définir qu'un seul des éléments range, namedRangeId ou tableId.

namedRangeId

string

Plage nommée sur laquelle repose cette vue filtrée, le cas échéant.

Lors de l'écriture, vous ne pouvez définir qu'un seul des éléments range, namedRangeId ou tableId.

tableId

string

Tableau sur lequel repose cette vue filtrée, le cas échéant.

Lors de l'écriture, vous ne pouvez définir qu'un seul des éléments range, namedRangeId ou tableId.

sortSpecs[]

object (SortSpec)

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
(deprecated)

map (key: integer, value: object ( FilterCriteria))

Critères d'affichage/de masquage des valeurs par colonne. La clé du mappage est l'indice de la colonne, et la valeur correspond aux critères de cette colonne.

Ce champ est obsolète et remplacé par filterSpecs.

filterSpecs[]

object (FilterSpec)

Critères de filtrage pour afficher/masquer les valeurs par colonne.

criteria et filterSpecs sont tous deux renseignés dans les réponses. Si les deux champs sont spécifiés dans une requête de mise à jour, ce champ est prioritaire.

ProtectedRange

Plage protégée.

Représentation JSON 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Champs
protectedRangeId

integer

ID de la plage protégée. Ce champ est en lecture seule.

range

object (GridRange)

Plage protégée. La plage peut être totalement illimitée, auquel cas elle est considérée comme une feuille protégée.

Lors de l'écriture, vous ne pouvez définir qu'un seul des éléments range, namedRangeId ou tableId.

namedRangeId

string

Plage nommée à laquelle cette plage protégée est associée, le cas échéant.

Lors de l'écriture, vous ne pouvez définir qu'un seul des éléments range, namedRangeId ou tableId.

tableId

string

Table sur laquelle repose cette plage protégée, le cas échéant.

Lors de l'écriture, vous ne pouvez définir qu'un seul des éléments range, namedRangeId ou tableId.

description

string

Description de cette plage protégée.

warningOnly

boolean

"True" si un avertissement s'affiche lorsque cette plage protégée est modifiée. La protection basée sur les avertissements signifie que tous les utilisateurs peuvent modifier les données de la plage protégée, mais qu'un avertissement s'affiche pour demander à l'utilisateur de confirmer la modification.

Lorsque vous écrivez: si ce champ est vrai, alors editors est ignoré. De plus, si la valeur de ce champ est modifiée de "true" à "false" et que le champ editors n'est pas défini (ni inclus dans le masque de champ), les éditeurs sont définis sur tous les éditeurs du document.

requestingUserCanEdit

boolean

"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[]

object (GridRange)

Liste des plages non protégées dans une feuille protégée. Les plages non protégées ne sont compatibles qu'avec les feuilles protégées.

editors

object (Editors)

Utilisateurs et groupes disposant d'un accès en modification à la plage protégée. Ce champ n'est visible que par les utilisateurs disposant d'un accès en modification à la plage protégée et au document. Les éditeurs ne sont pas compatibles avec la protection warningOnly.

Rédacteurs

Éditeurs d'une plage protégée.

Représentation JSON 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Champs
users[]

string

Adresses e-mail des utilisateurs disposant d'un accès en modification à la plage protégée.

groups[]

string

Adresses e-mail des groupes disposant d'un accès en modification à la plage protégée.

domainUsersCanEdit

boolean

"True" si un utilisateur du domaine du document dispose d'un accès en modification à la plage protégée. La protection de domaine n'est disponible que pour les documents d'un même domaine.

BasicFilter

Filtre par défaut associé à une feuille.

Représentation JSON 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Champs
range

object (GridRange)

Plage couverte par le filtre.

tableId

string

Table sur laquelle repose ce filtre, le cas échéant. Lors de l'écriture, vous ne pouvez définir qu'un seul élément range ou tableId.

sortSpecs[]

object (SortSpec)

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
(deprecated)

map (key: integer, value: object ( FilterCriteria))

Critères d'affichage/de masquage des valeurs par colonne. La clé du mappage est l'indice de la colonne, et la valeur correspond aux critères de cette colonne.

Ce champ est obsolète et remplacé par filterSpecs.

filterSpecs[]

object (FilterSpec)

Critères de filtrage par colonne.

criteria et filterSpecs sont tous deux renseignés dans les réponses. Si les deux champs sont spécifiés dans une requête de mise à jour, ce champ est prioritaire.

BandedRange

Plage à bandes (couleurs alternées) dans une feuille.

Représentation JSON 
{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Champs
bandedRangeId

integer

ID de la plage à bandes.

range

object (GridRange)

Plage sur laquelle ces propriétés sont appliquées.

rowProperties

object (BandingProperties)

Propriétés des bandes de lignes. Ces propriétés sont appliquées ligne par ligne dans toutes les lignes de la plage. Vous devez spécifier au moins l'un des éléments rowProperties ou columnProperties.

columnProperties

object (BandingProperties)

Propriétés des bandes de colonnes. Ces propriétés sont appliquées colonne par colonne dans toutes les colonnes de la plage. Vous devez spécifier au moins l'un des éléments rowProperties ou columnProperties.

BandingProperties

Propriétés faisant référence à une seule dimension (ligne ou colonne). Si BandedRange.row_properties et BandedRange.column_properties sont tous deux définis, les couleurs de remplissage sont appliquées aux cellules conformément aux règles suivantes:

Par exemple, la couleur de la première ligne est prioritaire sur celle de la première colonne, mais la couleur de la première colonne est prioritaire 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 en haut à 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 (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Champs
headerColor
(deprecated)

object (Color)

Couleur de la première ligne ou colonne. Si ce champ est défini, la première ligne ou colonne est remplie de cette couleur, et les couleurs alternent entre firstBandColor et secondBandColor à partir de la deuxième ligne ou colonne. Sinon, la première ligne ou colonne est remplie de firstBandColor et les couleurs alternent comme d'habitude. Obsolète: utilisez headerColorStyle.

headerColorStyle

object (ColorStyle)

Couleur de la première ligne ou colonne. Si ce champ est défini, la première ligne ou colonne est remplie de cette couleur, et les couleurs alternent entre firstBandColor et secondBandColor à partir de la deuxième ligne ou colonne. Sinon, la première ligne ou colonne est remplie de firstBandColor et les couleurs alternent comme d'habitude. Si headerColor est également défini, ce champ prévaut.

firstBandColor
(deprecated)

object (Color)

Première couleur alternée. (Obligatoire) Obsolète: utilisez firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Première couleur alternée. (Obligatoire) Si firstBandColor est également défini, ce champ est prioritaire.

secondBandColor
(deprecated)

object (Color)

Deuxième couleur utilisée en alternance. (Obligatoire) Obsolète: utilisez secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Deuxième couleur utilisée en alternance. (Obligatoire) Si secondBandColor est également défini, ce champ est prioritaire.

footerColor
(deprecated)

object (Color)

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 firstBandColor ou secondBandColor, en fonction de la couleur de la ligne ou de la colonne précédente. Obsolète: utilisez footerColorStyle.

footerColorStyle

object (ColorStyle)

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 firstBandColor ou secondBandColor, en fonction de la couleur de la ligne ou de la colonne précédente. Si footerColor est également défini, ce champ prévaut.

DimensionGroup

Groupe sur un intervalle de lignes ou de colonnes d'une feuille, qui peut contenir d'autres groupes ou être contenu dans d'autres groupes. Vous pouvez développer ou réduire un groupe en tant qu'unité sur la feuille.

Représentation JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Champs
range

object (DimensionRange)

Plage sur laquelle ce groupe existe.

depth

integer

Profondeur du groupe, qui indique le nombre de groupes dont la plage contient entièrement celle de ce groupe.

collapsed

boolean

Ce champ est défini sur "true" si ce groupe est réduit. Un groupe réduit reste réduit si un groupe qui se chevauche à une profondeur moindre est développé.

Une valeur "true" n'implique pas que toutes les dimensions du groupe sont masquées, car la visibilité d'une dimension peut changer indépendamment de cette propriété de groupe. Toutefois, lorsque cette propriété est mise à jour, toutes les dimensions qu'elle contient sont définies sur "masquées" si ce champ est défini sur "true", ou sur "visibles" si ce champ est défini sur "false".

Segment

Un sélecteur dans une feuille.

Représentation JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Champs
slicerId

integer

ID du sélecteur.

spec

object (SlicerSpec)

Spécification du sélecteur.

position

object (EmbeddedObjectPosition)

Position du sélecteur. Notez que le sélecteur ne peut être placé que sur une feuille existante. De plus, la largeur et la hauteur du sélecteur peuvent être automatiquement ajustées pour rester dans les limites autorisées.

SlicerSpec

Spécifications d'un outil de segmentation.

Représentation JSON 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Champs
dataRange

object (GridRange)

Plage de données du sélecteur.

filterCriteria

object (FilterCriteria)

Critères de filtrage du sélecteur.

columnIndex

integer

Index de colonne à partir de zéro dans le tableau de données auquel le filtre est appliqué.

applyToPivotTables

boolean

"True" si le filtre doit s'appliquer aux tableaux croisés dynamiques. Si ce champ n'est pas défini, la valeur par défaut est True.

title

string

Titre du sélecteur.

textFormat

object (TextFormat)

Format du titre dans le sélecteur. Le champ de lien n'est pas disponible.

backgroundColor
(deprecated)

object (Color)

Couleur d'arrière-plan du sélecteur. Obsolète: utilisez backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Couleur d'arrière-plan du sélecteur. Si backgroundColor est également défini, ce champ prévaut.

horizontalAlignment

enum (HorizontalAlign)

Alignement horizontal du titre dans le sélecteur. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de LEFT.

Tableau

Un tableau.

Représentation JSON 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Champs
tableId

string

ID de la table.

name

string

Nom de la table. Il est unique pour toutes les tables de la même feuille de calcul.

range

object (GridRange)

Plage du tableau.

rowsProperties

object (TableRowsProperties)

Propriétés des lignes du tableau.

columnProperties[]

object (TableColumnProperties)

Propriétés des colonnes du tableau.

TableRowsProperties

Propriétés de la ligne du tableau.

Représentation JSON 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Champs
headerColorStyle

object (ColorStyle)

Couleur de la ligne d'en-tête. Si ce champ est défini, la ligne d'en-tête est remplie de la couleur spécifiée. Sinon, la ligne d'en-tête est remplie d'une couleur par défaut.

firstBandColorStyle

object (ColorStyle)

Première couleur alternée. Si ce champ est défini, la première ligne de bandes est remplie avec la couleur spécifiée. Sinon, la première ligne en bandes est remplie d'une couleur par défaut.

secondBandColorStyle

object (ColorStyle)

Deuxième couleur utilisée en alternance. Si ce champ est défini, la deuxième ligne en bandes est remplie de la couleur spécifiée. Sinon, la deuxième ligne en bandes est remplie d'une couleur par défaut.

footerColorStyle

object (ColorStyle)

Couleur de la dernière ligne. Si ce champ n'est pas défini, aucun pied de page n'est ajouté. La dernière ligne est remplie avec firstBandColorStyle ou secondBandColorStyle, en fonction de la couleur de la ligne précédente. Si vous ajoutez un pied de page à une table existante qui n'en avait pas, la plage sera étendue d'une ligne. Si vous modifiez une table existante avec un pied de page et que vous en supprimez un, la plage sera réduite d'une ligne.

TableColumnProperties

Colonne du tableau.

Représentation JSON 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Champs
columnIndex

integer

Indice de colonne en base 0. Cet indice est relatif à sa position dans le tableau et n'est pas nécessairement identique à l'indice de colonne de la feuille.

columnName

string

Nom de la colonne.

columnType

enum (ColumnType)

Type de colonne.

dataValidationRule

object (TableColumnDataValidationRule)

Règle de validation des données de la colonne. Défini uniquement pour le type de colonne "menu déroulant".

ColumnType

Type de colonne pour une colonne donnée dans un tableau.

Enums
COLUMN_TYPE_UNSPECIFIED Type de colonne non spécifié.
DOUBLE Type de colonne numérique.
CURRENCY Type de colonne de devise.
PERCENT Type de colonne "pourcentage".
DATE Type de colonne de date.
TIME Type de colonne d'heure.
DATE_TIME Type de colonne "date et heure".
TEXT Type de colonne de texte.
BOOLEAN Type de colonne booléen.
DROPDOWN Type de colonne déroulante.
FILES_CHIP Type de colonne défini sur "chip de fichier"
PEOPLE_CHIP Type de colonne "chip de contact"
FINANCE_CHIP Type de colonne "chip Finance"
PLACE_CHIP Type de colonne pour le chip de lieu
RATINGS_CHIP Type de colonne "chip de note"

TableColumnDataValidationRule

Règle de validation des données pour une colonne d'un tableau

Représentation JSON 
{
  "condition": {
    object (BooleanCondition)
  }
}
Champs
condition

object (BooleanCondition)

Condition à laquelle les données de la cellule doivent répondre. N'est valide que si [BooleanCondition.type] est ONE_OF_LIST.