Sheets

Sheets

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)

Données de la grille, s'il s'agit d'une feuille de grille.

Le nombre d'objets GridData renvoyés dépend du nombre de plages demandées dans cette feuille. Par exemple, si cela représente 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, indexée à zéro) et startColumn 3 (colonne D, indexée à zéro).

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

merges[]

object (GridRange)

Plages fusionnées.

conditionalFormats[]

object (ConditionalFormatRule)

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

filterViews[]

object (FilterView)

Vues filtrées dans cette feuille.

protectedRanges[]

object (ProtectedRange)

Plages protégées dans 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)

Plages avec 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, classés par ordre croissant de l'index de début de plage, puis par profondeur de groupe.

columnGroups[]

object (DimensionGroup)

Tous les groupes de colonnes de cette feuille, classés par ordre croissant de l'index de début de 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 ce champ défini, il ne peut plus être modifié.

title

string

Nom de la feuille.

index

integer

Index de la feuille dans la feuille de calcul. Lorsque vous ajoutez ou mettez à jour les propriétés d'une 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 index de feuilles ou que vous insérez des feuilles, le déplacement est pris en compte dans les index "avant le déplacement". Par exemple, si vous avez trois feuilles (S1, S2, S3) et que vous souhaitez déplacer S1 avant S2, l'index doit être défini sur 2. Une demande de mise à jour de l'index de 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 ce champ défini, il ne peut plus être modifié.

gridProperties

object (GridProperties)

Propriétés supplémentaires de la feuille si elle est une grille. (Si la feuille est une feuille d'objet contenant un graphique ou une image, ce champ sera absent.) Lors de l'écriture, il est interdit de définir des propriétés de grille sur des feuilles non associées à une grille.

Si cette feuille est une feuille DATA_SOURCE, ce champ est en sortie uniquement, 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'UI, "false" si elle est visible.

tabColor
(deprecated)

object (Color)

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

tabColorStyle

object (ColorStyle)

Couleur de l'onglet dans l'UI. Si tabColor est également défini, ce champ est prioritaire.

rightToLeft

boolean

"True" si la feuille est une feuille RTL au lieu d'une feuille LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Uniquement en sortie. Si ce champ est présent, il contient les 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 à une source de données externe DataSource 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'UI.

rowGroupControlAfter

boolean

"True" si le bouton d'activation/de désactivation de la commande de regroupement de lignes est affiché après le groupe.

columnGroupControlAfter

boolean

"True" si le bouton d'activation/de désactivation du contrôle du regroupement de colonnes est affiché 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 la feuille DataSource à laquelle la feuille de calcul est associée.

columns[]

object (DataSourceColumn)

Les colonnes affichées dans la feuille, correspondant aux valeurs de RowData.

dataExecutionStatus

object (DataExecutionStatus)

État d'exécution des données.

GridData

Données de la grille et 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 zéro).

startColumn

integer

Première colonne à laquelle cette GridData fait référence (sur base zéro).

rowData[]

object (RowData)

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

rowMetadata[]

object (DimensionProperties)

Métadonnées sur les lignes demandées dans la grille, en commençant par la ligne à l'index 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 (s'il s'agit d'une ligne) ou largeur (s'il s'agit d'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 option 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)

Plages mises 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. Une seule règle doit être définie. rule ne peut être qu'un des éléments suivants :
booleanRule

object (BooleanRule)

La mise en forme est "activée" ou "désactivée" selon la règle.

gradientRule

object (GradientRule)

La mise en forme varie en fonction des dégradés de la règle.

BooleanRule

Règle qui peut correspondre ou non, selon 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. La mise en forme conditionnelle ne peut appliquer qu'un sous-ensemble de la mise en forme : bold, italic, strikethrough, foreground color et, background color.

GradientRule

Règle qui applique un format de dégradé de couleurs 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 de départ de l'interpolation.

midpoint

object (InterpolationPoint)

Point d'interpolation intermédiaire facultatif.

maxpoint

object (InterpolationPoint)

Point d'interpolation final.

InterpolationPoint

Point d'interpolation unique dans une mise en forme conditionnelle avec dégradé. Ces options permettent d'épingler le dégradé de couleurs 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 est prioritaire.

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. Non utilisé 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 dans la plage du format conditionnel.
MAX Le point d'interpolation utilise la valeur maximale des cellules dans 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é sur 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))) (où les erreurs dans 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) (où les erreurs dans la plage sont ignorées lors de l'aplatissement).

FilterView

Une vue filtrée. Pour en savoir plus, consultez Gérer la visibilité des données avec des filtres.

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 filtrée.

title

string

Nom de la vue filtrée.

range

object (GridRange)

Plage couverte par cette vue filtrée.

Lors de l'écriture, une seule des options range, namedRangeId ou tableId peut être définie.

namedRangeId

string

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

Lors de l'écriture, une seule des options range, namedRangeId ou tableId peut être définie.

tableId

string

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

Lors de l'écriture, une seule des options range, namedRangeId ou tableId peut être définie.

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 permettant d'afficher/masquer les valeurs par colonne. La clé de la carte est l'index de la colonne, et la valeur correspond au critère de cette colonne.

Ce champ a été abandonné et remplacé par filterSpecs.

filterSpecs[]

object (FilterSpec)

Critères de filtrage permettant d'afficher ou de masquer des valeurs par colonne.

Les deux valeurs criteria et filterSpecs sont renseignées 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éger. La plage peut être entièrement illimitée, auquel cas elle est considérée comme une feuille protégée.

Lors de l'écriture, un seul des éléments suivants peut être défini : range, namedRangeId ou tableId.

namedRangeId

string

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

Lors de l'écriture, un seul des éléments suivants peut être défini : range, namedRangeId ou tableId.

tableId

string

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

Lors de l'écriture, un seul des éléments suivants peut être défini : range, namedRangeId ou tableId.

description

string

Description de cette plage protégée.

warningOnly

boolean

"True" si un avertissement s'affiche lors de la modification de cette plage protégée. La protection basée sur des avertissements signifie que chaque utilisateur peut modifier les données dans la plage protégée, mais qu'un avertissement lui demandera de confirmer la modification.

Lors de l'écriture : si ce champ est défini sur "true", alors editors sont ignorés. De plus, si ce champ passe de "true" à "false" et que le champ editors n'est pas défini (ni inclus dans le masque de champ), les éditeurs seront 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 acceptées que sur les feuilles protégées.

editors

object (Editors)

Les utilisateurs et les 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.

Éditeurs

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

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

string

Adresses e-mail des utilisateurs ayant accès en modification à la plage protégée.

groups[]

string

Adresses e-mail des groupes ayant accès en modification à la plage protégée.

domainUsersCanEdit

boolean

True si une personne du domaine du document a accès à la modification de la plage protégée. La protection de domaine n'est disponible que pour les documents d'un domaine.

BasicFilter

Filtre par défaut associé à une feuille. Pour en savoir plus, consultez Gérer la visibilité des données avec des filtres.

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 ce filtre est basé, le cas échéant. Lors de l'écriture, vous ne pouvez définir qu'un seul des éléments suivants : 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 permettant d'afficher/masquer les valeurs par colonne. La clé de la carte est l'index de la colonne, et la valeur correspond au critère de cette colonne.

Ce champ a été abandonné et remplacé par filterSpecs.

filterSpecs[]

object (FilterSpec)

Critères de filtrage par colonne.

Les deux valeurs criteria et filterSpecs sont renseignées 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,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Champs
bandedRangeId

integer

ID de la plage avec bande. Si cette valeur n'est pas définie, consultez bandedRangeReference.

bandedRangeReference

string

Uniquement en sortie. Référence de la plage avec bandes, utilisée pour identifier l'ID non compatible avec bandedRangeId.

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 à toutes les lignes de la plage. Vous devez spécifier au moins l'une des valeurs suivantes : rowProperties ou columnProperties.

columnProperties

object (BandingProperties)

Propriétés des bandes de colonnes. Ces propriétés sont appliquées colonne par colonne à toutes les colonnes de la plage. Vous devez spécifier au moins l'une des valeurs suivantes : 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 définis, les couleurs de remplissage sont appliquées aux cellules selon les 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 avec 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 avec firstBandColor et les couleurs alternent normalement. 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 avec 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 avec firstBandColor et les couleurs alternent normalement. Si headerColor est également défini, ce champ est prioritaire.

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

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. Un groupe peut être réduit ou développé en tant qu'unité dans 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, représentant le nombre de groupes dont la plage contient entièrement la plage de ce groupe.

collapsed

boolean

La valeur de ce champ est "true" si ce groupe est réduit. Un groupe réduit le reste si un groupe chevauchant à une profondeur inférieure 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 positionné que sur une feuille existante. De plus, la largeur et la hauteur du sélecteur peuvent être ajustées automatiquement pour respecter les limites autorisées.

SlicerSpec

Spécifications d'un sélecteur.

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 (base 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 de texte du titre dans le sélecteur. Le champ "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 est prioritaire.

horizontalAlignment

enum (HorizontalAlign)

Alignement horizontal du titre dans le sélecteur. Si aucune valeur n'est spécifiée, la valeur définie par défaut est LEFT.

Tableau

Table.

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. Cette valeur est unique pour toutes les tables d'une 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 de la colonne 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 avec 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 à bandes est remplie avec la couleur spécifiée. Sinon, la première ligne à 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 à bandes est remplie avec la couleur spécifiée. Sinon, la deuxième ligne à 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, selon la couleur de la ligne précédente. Si vous mettez à jour une table existante sans pied de page pour en ajouter un, la plage sera étendue d'une ligne. Si vous mettez à jour une table existante avec un pied de page et que vous le supprimez, 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

Index de colonne basé sur zéro. Cet index est relatif à sa position dans le tableau et n'est pas nécessairement le même que l'index de colonne dans 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 "Devise".
PERCENT Type de colonne "pourcentage".
DATE Type de colonne de date.
TIME Type de colonne de date/heure.
DATE_TIME Type de colonne "Date et heure".
TEXT Type de colonne "Texte".
BOOLEAN Type de colonne booléen.
DROPDOWN Type de colonne "menu déroulant".
FILES_CHIP Type de colonne "chip de fichier"
PEOPLE_CHIP Type de colonne "chip de contact"
FINANCE_CHIP Type de colonne "chip Finance"
PLACE_CHIP Type de colonne "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 correspondre. Valide uniquement si [BooleanCondition.type] est défini sur ONE_OF_LIST.