Other

Couleur

Représente une couleur dans l'espace colorimétrique RVBA. Cette représentation est conçue pour simplifier la conversion vers et depuis des représentations de couleurs dans différentes langues, par rapport à un format compact. Par exemple, les champs de cette représentation peuvent être facilement fournis au constructeur de java.awt.Color en Java. Ils peuvent également être fournis facilement à la méthode +colorWithRed:green:blue:alpha d'UIColor sous iOS. Et, avec un petit effort, il peut être facilement formaté en une chaîne CSS rgba() en JavaScript.

Cette page de référence ne contient pas d'informations sur l'espace colorimétrique absolu à utiliser pour interpréter la valeur RVB (par exemple, sRVB, Adobe RVB, DCI-P3 et BT.2020). Par défaut, les applications doivent utiliser l'espace colorimétrique sRVB.

Lorsque l'égalité des couleurs doit être décidée, les implémentations, sauf indication contraire, traitent deux couleurs comme égales si toutes leurs valeurs de rouge, vert, bleu et alpha diffèrent chacune de 1e-5 au maximum.

Exemple (Java) :

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Exemple (iOS/Obj-C) :

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Exemple (JavaScript) :

// ...

var protoToCssColor = function(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgbColor)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgbColor.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
Représentation JSON
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Champs
red

number

Quantité de rouge dans la couleur en tant que valeur dans l'intervalle [0, 1].

green

number

Quantité de vert dans la couleur en tant que valeur dans l'intervalle [0, 1].

blue

number

Quantité de bleu dans la couleur en tant que valeur dans l'intervalle [0, 1].

alpha

number

Fraction de cette couleur à appliquer au pixel. En d'autres termes, la couleur finale du pixel est définie par l'équation :

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Cela signifie qu'une valeur de 1,0 correspond à une couleur solide, tandis qu'une valeur de 0,0 correspond à une couleur complètement transparente. Un message wrapper est utilisé à la place d'une simple valeur scalaire flottante afin qu'il soit possible de distinguer une valeur par défaut de la valeur non définie. En cas d'omission, cet objet couleur est rendu sous forme de couleur unie (comme si la valeur alpha avait été explicitement définie sur 1,0).

ColorStyle

Valeur de couleur.

Représentation JSON
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
Champs
Champ d'union kind. Type de valeur de couleur. kind ne peut être que l'un des éléments suivants:
rgbColor

object (Color)

Couleur RVB. La valeur alpha de l'objet Color n'est généralement pas acceptée.

themeColor

enum (ThemeColorType)

Couleur du thème.

ThemeColorType

Types de couleurs du thème.

SpreadsheetProperties contient un SpreadsheetTheme qui définit une mise en correspondance de ces types de couleurs de thème avec les couleurs concrètes.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Couleur du thème non spécifiée
TEXT Représente la couleur principale du texte.
BACKGROUND Représente la couleur d'arrière-plan principale
ACCENT1 Représente la première couleur d'accentuation
ACCENT2 Représente la deuxième couleur d'accentuation
ACCENT3 Représente la troisième couleur d'accentuation
ACCENT4 Représente la quatrième couleur d'accentuation
ACCENT5 Représente la cinquième couleur d'accentuation
ACCENT6 Représente la sixième couleur d'accentuation

HorizontalAlign

Alignement horizontal du texte d'une cellule.

Enums
HORIZONTAL_ALIGN_UNSPECIFIED L'alignement horizontal n'est pas spécifié. Ne l'utilisez pas.
LEFT Le texte est explicitement aligné à gauche de la cellule.
CENTER Le texte est explicitement aligné au centre de la cellule.
RIGHT Le texte est explicitement aligné à droite de la cellule.

TextFormat

Format d'une séquence de texte dans une cellule. Les valeurs manquantes indiquent que le champ n'est pas spécifié.

Représentation JSON
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
Champs
foregroundColor
(deprecated)

object (Color)

Couleur de premier plan du texte. Obsolète: utilisez foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Couleur de premier plan du texte. Si foregroundColor est également défini, ce champ est prioritaire.

fontFamily

string

Famille de polices.

fontSize

integer

Taille de la police.

bold

boolean

"True" si le texte est en gras.

italic

boolean

"True" si le texte est en italique.

strikethrough

boolean

"True" si le texte est barré.

underline

boolean

"True" si le texte est souligné.

DataSourceColumn

Colonne dans une source de données.

Représentation JSON
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
Champs
reference

object (DataSourceColumnReference)

Référence de la colonne.

formula

string

Formule de la colonne de calcul.

DataSourceColumnReference

Identifiant unique qui fait référence à une colonne de source de données.

Représentation JSON
{
  "name": string
}
Champs
name

string

Nom à afficher pour la colonne. Il doit être unique au sein d'une source de données.

DataExecutionStatus

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

Une exécution de données est créée pour synchroniser un objet de source de données avec les dernières données d'un DataSource. Elle est généralement planifiée pour s'exécuter en arrière-plan. Vous pouvez vérifier son state pour savoir si une exécution est terminée.

Il existe plusieurs scénarios dans lesquels l'exécution de données est déclenchée:

  • Adding a data source crée une feuille de source de données associée ainsi qu'une exécution de données pour synchroniser les données de la source avec la feuille.
  • Updating a data source crée une exécution de données pour actualiser de la même manière la feuille de la source de données associée.
  • Vous pouvez envoyer refresh request pour actualiser explicitement un ou plusieurs objets de source de données.
Représentation JSON
{
  "state": enum (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
Champs
state

enum (DataExecutionState)

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

errorCode

enum (DataExecutionErrorCode)

Code d'erreur.

errorMessage

string

Le message d'erreur, qui peut être vide.

lastRefreshTime

string (Timestamp format)

Récupère l'heure de la dernière actualisation des données.

DataExecutionState

Énumération des états d'exécution des données.

Enums
DATA_EXECUTION_STATE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
NOT_STARTED L'exécution des données n'a pas démarré.
RUNNING L'exécution des données a commencé et est en cours d'exécution.
CANCELLING L'exécution des données est en cours d'annulation.
SUCCEEDED L'exécution des données s'est terminée avec succès.
FAILED L'exécution des données s'est terminée avec des erreurs.

DataExecutionErrorCode

Énumération du code d'erreur d'exécution des données.

Enums
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
TIMED_OUT L'exécution des données a expiré.
TOO_MANY_ROWS L'exécution des données renvoie plus de lignes que la limite.
TOO_MANY_COLUMNS L'exécution des données renvoie plus de colonnes que la limite.
TOO_MANY_CELLS L'exécution des données renvoie plus de cellules que la limite.
ENGINE L'erreur est reçue du moteur d'exécution des données backend (par exemple, BigQuery). Pour en savoir plus, consultez errorMessage.
PARAMETER_INVALID Un ou certains des paramètres de source de données fournis ne sont pas valides.
UNSUPPORTED_DATA_TYPE L'exécution des données renvoie un type de données non compatible.
DUPLICATE_COLUMN_NAMES L'exécution des données renvoie des noms de colonne ou des alias en double.
INTERRUPTED L'exécution des données est interrompue. Veuillez actualiser la page ultérieurement.
CONCURRENT_QUERY L'exécution des données est en cours et ne peut pas être actualisée tant qu'elle n'est pas terminée.
OTHER Autres erreurs
TOO_MANY_CHARS_PER_CELL L'exécution des données renvoie des valeurs qui dépassent le nombre maximal de caractères autorisés dans une seule cellule.
DATA_NOT_FOUND La base de données référencée par la source de données est introuvable. */
PERMISSION_DENIED L'utilisateur n'a pas accès à la base de données référencée par la source de données.
MISSING_COLUMN_ALIAS L'exécution des données renvoie des colonnes avec des alias manquants.
OBJECT_NOT_FOUND L'objet de source de données n'existe pas.
OBJECT_IN_ERROR_STATE L'objet de source de données est actuellement en état d'erreur. Pour forcer l'actualisation, définissez force dans RefreshDataSourceRequest.
OBJECT_SPEC_INVALID La spécification de l'objet de source de données n'est pas valide.
DATA_EXECUTION_CANCELLED L'exécution des données a été annulée.

ExtendedValue

Types de valeurs qu'une cellule d'une feuille de calcul peut avoir.

Représentation JSON
{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. Type de valeur d'une cellule. Si aucun champ n'est défini, la cellule ne contient aucune donnée. value ne peut être que l'un des éléments suivants:
numberValue

number

Représente une valeur double. Remarque: Les dates, les heures et les heures sont représentées par des doubles au format SERIAL_NUMBER.

stringValue

string

Représente une valeur de chaîne. Les guillemets simples de début ne sont pas inclus. Par exemple, si l'utilisateur saisit '123 dans l'UI, cela est représenté par un stringValue de "123".

boolValue

boolean

Représente une valeur booléenne.

formulaValue

string

Représente une formule.

errorValue

object (ErrorValue)

Représente une erreur. Ce champ est en lecture seule.

ErrorValue

Erreur dans une cellule.

Représentation JSON
{
  "type": enum (ErrorType),
  "message": string
}
Champs
type

enum (ErrorType)

Type d'erreur.

message

string

Un message contenant plus d'informations sur l'erreur (dans les paramètres régionaux de la feuille de calcul)

ErrorType

Type d'erreur.

Enums
ERROR_TYPE_UNSPECIFIED Type d'erreur par défaut, ne l'utilisez pas.
ERROR Correspond à l'erreur #ERROR!.
NULL_VALUE Correspond à l'erreur #NULL!.
DIVIDE_BY_ZERO Correspond à l'erreur #DIV/0.
VALUE Correspond à l'erreur #VALUE!.
REF Correspond à l'erreur #REF!.
NAME Correspond à l'erreur #NAME?.
NUM Correspond à l'erreur #NUM!.
N_A Correspond à l'erreur #N/A.
LOADING Correspond à l'état Loading....

BooleanCondition

Une condition qui peut être vraie ou fausse. Les BooleanConditions sont utilisées pour la mise en forme conditionnelle, la validation des données et les critères des filtres.

Représentation JSON
{
  "type": enum (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
Champs
type

enum (ConditionType)

Type de condition.

values[]

object (ConditionValue)

Valeurs de la condition. Le nombre de valeurs acceptées dépend de la valeur condition type. Certains acceptent les valeurs nulles, d'autres une ou deux valeurs, et ConditionType.ONE_OF_LIST accepte un nombre arbitraire de valeurs.

ConditionType

Type de condition.

Enums
CONDITION_TYPE_UNSPECIFIED Valeur par défaut (ne pas utiliser).
NUMBER_GREATER La valeur de la cellule doit être supérieure à celle de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
NUMBER_GREATER_THAN_EQ La valeur de la cellule doit être supérieure ou égale à la valeur de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
NUMBER_LESS La valeur de la cellule doit être inférieure à celle de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
NUMBER_LESS_THAN_EQ La valeur de la cellule doit être inférieure ou égale à celle de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
NUMBER_EQ La valeur de la cellule doit être égale à celle de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul ConditionValue pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets autres que des sources de données, et au moins un ConditionValue pour les filtres sur les objets de sources de données.
NUMBER_NOT_EQ La valeur de la cellule ne doit pas être égale à celle de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul ConditionValue pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets autres que des sources de données, et au moins un ConditionValue pour les filtres sur les objets de sources de données.
NUMBER_BETWEEN La valeur de la cellule doit être comprise entre les deux valeurs de condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite exactement deux ConditionValues.
NUMBER_NOT_BETWEEN La valeur de la cellule ne doit pas se trouver entre les deux valeurs de condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite exactement deux ConditionValues.
TEXT_CONTAINS La valeur de la cellule doit contenir celle de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
TEXT_NOT_CONTAINS La valeur de la cellule ne doit pas contenir la valeur de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
TEXT_STARTS_WITH La valeur de la cellule doit commencer par celle de la condition. Compatible avec la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
TEXT_ENDS_WITH La valeur de la cellule doit se terminer par celle de la condition. Compatible avec la mise en forme conditionnelle et les filtres. Nécessite un seul élément ConditionValue.
TEXT_EQ La valeur de la cellule doit être exactement la valeur de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul ConditionValue pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets autres que des sources de données, et au moins un ConditionValue pour les filtres sur les objets de sources de données.
TEXT_IS_EMAIL La valeur de la cellule doit être une adresse e-mail valide. Compatible avec la validation des données. Aucun ConditionValues requis.
TEXT_IS_URL La valeur de la cellule doit être une URL valide. Compatible avec la validation des données. Aucun ConditionValues requis.
DATE_EQ La valeur de la cellule doit correspondre à la date de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul ConditionValue pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets autres que des sources de données, et au moins un ConditionValue pour les filtres sur les objets de sources de données.
DATE_BEFORE La valeur de la cellule doit être antérieure à la date de la valeur de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul ConditionValue pouvant être un relative date.
DATE_AFTER La valeur de la cellule doit être postérieure à la date de la valeur de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Nécessite un seul ConditionValue pouvant être un relative date.
DATE_ON_OR_BEFORE La valeur de la cellule doit être identique ou antérieure à la date de la valeur de la condition. Compatible avec la validation des données. Nécessite un seul ConditionValue pouvant être un relative date.
DATE_ON_OR_AFTER La valeur de la cellule doit être identique ou postérieure à la date de la valeur de la condition. Compatible avec la validation des données. Nécessite un seul ConditionValue pouvant être un relative date.
DATE_BETWEEN La valeur de la cellule doit être comprise entre les dates des deux valeurs de condition. Compatible avec la validation des données. Nécessite exactement deux ConditionValues.
DATE_NOT_BETWEEN La valeur de la cellule doit être en dehors des dates des deux valeurs de condition. Compatible avec la validation des données. Nécessite exactement deux ConditionValues.
DATE_IS_VALID La valeur de la cellule doit être une date. Compatible avec la validation des données. Aucun ConditionValues requis.
ONE_OF_RANGE La valeur de la cellule doit être indiquée dans la grille dans la plage de valeurs de la condition. Compatible avec la validation des données. Nécessite une seule valeur ConditionValue, et la valeur doit correspondre à une plage valide en notation A1.
ONE_OF_LIST La valeur de la cellule doit figurer dans la liste des valeurs de condition. Compatible avec la validation des données. Accepte n'importe quel nombre de condition values, un par élément de la liste. Les formules ne sont pas compatibles avec les valeurs.
BLANK La valeur de la cellule doit être vide. Compatible avec la mise en forme conditionnelle et les filtres. Aucun ConditionValues requis.
NOT_BLANK La valeur de la cellule ne doit pas être vide. Compatible avec la mise en forme conditionnelle et les filtres. Aucun ConditionValues requis.
CUSTOM_FORMULA La formule de la condition doit renvoyer la valeur "true". Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Non compatible avec les filtres de feuille des sources de données. Nécessite un seul élément ConditionValue.
BOOLEAN La valeur de la cellule doit être TRUE/FALSE ou figurer dans la liste des valeurs de condition. Compatible avec la validation des données. S'affiche sous la forme d'une case à cocher de cellule. Accepte zéro, un ou deux ConditionValues. Aucune valeur indique que la cellule doit être TRUE ou FALSE, où TRUE s'affiche comme étant cochée et FALSE s'affiche comme étant décochée. Une valeur indique que la cellule s'affiche comme cochée lorsqu'elle contient cette valeur et non cochée lorsqu'elle est vide. Deux valeurs indiquent que la cellule s'affiche comme cochée lorsqu'elle contient la première valeur et non cochée lorsqu'elle contient la seconde. Par exemple, ["Yes","No"] indique que la cellule affiche une case cochée lorsque la valeur "Yes" est définie et une case décochée lorsque la valeur associée est "No".
TEXT_NOT_EQ La valeur de la cellule ne doit pas être exactement celle de la condition. Compatible avec les filtres appliqués aux objets de source de données. Nécessite au moins un ConditionValue.
DATE_NOT_EQ La valeur de la cellule ne doit pas être exactement celle de la condition. Compatible avec les filtres appliqués aux objets de source de données. Nécessite au moins un ConditionValue.
FILTER_EXPRESSION La valeur de la cellule doit respecter le modèle spécifié. Nécessite un seul élément ConditionValue.

ConditionValue

Valeur de la condition.

Représentation JSON
{

  // Union field value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. Valeur de la condition. Une seule doit être définie. value ne peut être que l'un des éléments suivants:
relativeDate

enum (RelativeDate)

Une date relative (basée sur la date actuelle). Valide uniquement si type est défini sur DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE ou DATE_ON_OR_AFTER.

Les dates relatives ne sont pas compatibles avec la validation des données. Ils ne sont compatibles qu'avec la mise en forme et les filtres conditionnels.

userEnteredValue

string

Valeur sur laquelle la condition est basée. La valeur est analysée comme si l'utilisateur avait saisi une cellule dans une cellule. Les formules sont compatibles (et doivent commencer par = ou "+").

RelativeDate

Contrôle le mode d'évaluation d'une condition de date.

Enums
RELATIVE_DATE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
PAST_YEAR La valeur est antérieure d'un an à la date du jour.
PAST_MONTH La valeur est fixée à un mois avant aujourd'hui.
PAST_WEEK La valeur est fixée à une semaine avant aujourd'hui.
YESTERDAY La valeur correspond à "hier".
TODAY La valeur est aujourd'hui.
TOMORROW La valeur est demain.

GridRange

Une plage sur une feuille Tous les index sont basés sur zéro. Les index sont semi-ouverts, c'est-à-dire que l'index de départ est inclusif et que l'index de fin est exclusif ([startIndex, endIndex). Les index manquants indiquent que la plage n'est pas limitée de ce côté.

Par exemple, si "Sheet1" est l'ID de la feuille 123456:

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

L'index de début doit toujours être inférieur ou égal à l'index de fin. Si l'index de début est égal à l'index de fin, la plage est vide. Les plages vides ne sont généralement pas significatives et sont généralement affichées dans l'interface utilisateur sous la forme #REF!.

Représentation JSON
{
  "sheetId": integer,
  "startRowIndex": integer,
  "endRowIndex": integer,
  "startColumnIndex": integer,
  "endColumnIndex": integer
}
Champs
sheetId

integer

Feuille sur laquelle se trouve cette plage.

startRowIndex

integer

Première ligne (incluse) de la plage, ou non définie si elle est illimitée.

endRowIndex

integer

Dernière ligne (exclusive) de la plage, ou non définie si elle est illimitée.

startColumnIndex

integer

Colonne de début (incluse) de la plage, ou non définie si elle est illimitée.

endColumnIndex

integer

Colonne de fin (exclusive) de la plage, ou non définie si elle est illimitée.

SortOrder

Ordre de tri.

Enums
SORT_ORDER_UNSPECIFIED Valeur par défaut, ne pas utiliser.
ASCENDING Trier par ordre croissant.
DESCENDING Trier par ordre décroissant.

FilterSpec

Critères de filtre associés à une colonne spécifique.

Représentation JSON
{
  "filterCriteria": {
    object (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
Champs
filterCriteria

object (FilterCriteria)

Critères de la colonne.

Champ d'union reference. Référence à la colonne filtrée. reference ne peut être que l'un des éléments suivants:
columnIndex

integer

Index de colonne basé sur zéro.

dataSourceColumnReference

object (DataSourceColumnReference)

Référence à une colonne de source de données.

FilterCriteria

Critères d'affichage ou de masquage des lignes dans une vue filtrée ou filtrée

Représentation JSON
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
Champs
hiddenValues[]

string

Valeurs qui doivent être masquées.

condition

object (BooleanCondition)

Condition qui doit être vraie pour que les valeurs s'affichent. (Cela ne remplace pas hiddenValues : si une valeur y est répertoriée, elle sera toujours masquée.)

visibleBackgroundColor
(deprecated)

object (Color)

Couleur de remplissage de l’arrière-plan à utiliser pour le filtrage. Seules les cellules avec cette couleur de remplissage sont affichées. Exclusion mutuelle avec visibleForegroundColor. Obsolète: utilisez visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

Couleur de remplissage de l’arrière-plan à utiliser pour le filtrage. Seules les cellules avec cette couleur de remplissage sont affichées. Ce champ s'exclut mutuellement avec visibleForegroundColor et doit être défini sur une couleur de type RVB. Si visibleBackgroundColor est également défini, ce champ est prioritaire.

visibleForegroundColor
(deprecated)

object (Color)

Couleur de premier plan à utiliser pour le filtrage ; seules les cellules avec cette couleur de premier plan sont affichées. Exclusion mutuelle avec visibleBackgroundColor. Obsolète: utilisez visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Couleur de premier plan à utiliser pour le filtrage ; seules les cellules avec cette couleur de premier plan sont affichées. Ce champ s'exclut mutuellement avec visibleBackgroundColor et doit être défini sur une couleur de type RVB. Si visibleForegroundColor est également défini, ce champ est prioritaire.

SortSpec

Ordre de tri associé à une colonne ou à une ligne spécifique.

Représentation JSON
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
Champs
sortOrder

enum (SortOrder)

Les données d'ordre doivent être triées.

foregroundColor
(deprecated)

object (Color)

Couleur de premier plan à utiliser pour le tri ; les cellules avec cette couleur de premier plan sont triées en haut. Exclusion mutuelle avec backgroundColor. Obsolète: utilisez foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Couleur de premier plan à utiliser pour le tri ; les cellules avec cette couleur de premier plan sont triées en haut. Exclusion mutuelle avec backgroundColor. Il doit s'agir d'une couleur de type RVB. Si foregroundColor est également défini, ce champ est prioritaire.

backgroundColor
(deprecated)

object (Color)

Couleur de remplissage de l’arrière-plan à utiliser pour le tri ; les cellules avec cette couleur de remplissage sont triées en haut. Exclusion mutuelle avec foregroundColor. Obsolète: utilisez backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Couleur de remplissage de l’arrière-plan à utiliser pour le tri ; les cellules avec cette couleur de remplissage sont triées en haut. Exclusion mutuelle avec foregroundColor. Il doit s'agir d'une couleur de type RVB. Si backgroundColor est également défini, ce champ est prioritaire.

Champ d'union reference. Référence à la dimension triée. reference ne peut être que l'un des éléments suivants:
dimensionIndex

integer

Dimension à laquelle le tri doit être appliqué.

dataSourceColumnReference

object (DataSourceColumnReference)

Référence à une colonne de source de données.

EmbeddedObjectPosition

Position d'un objet intégré tel qu'un graphique.

Représentation JSON
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
Champs
Champ d'union location. Emplacement de l'objet. Vous ne devez définir qu'une seule valeur. location ne peut être que l'un des éléments suivants:
sheetId

integer

Feuille sur laquelle il se trouve. À définir uniquement si l'objet intégré se trouve sur sa propre feuille. Cette valeur ne doit pas être négative

overlayPosition

object (OverlayPosition)

Position à laquelle l'objet est superposé à une grille.

newSheet

boolean

Si la valeur est "true", l'objet intégré est placé sur une nouvelle feuille dont l'identifiant est choisi pour vous. Utilisé uniquement lors de l'écriture.

OverlayPosition

L'emplacement où un objet est superposé à une grille.

Représentation JSON
{
  "anchorCell": {
    object (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
Champs
anchorCell

object (GridCoordinate)

Cellule sur laquelle l'objet est ancré.

offsetXPixels

integer

Décalage horizontal, en pixels, entre l'objet et la cellule d'ancrage.

offsetYPixels

integer

Décalage vertical, en pixels, entre l'objet et la cellule d'ancrage.

widthPixels

integer

Largeur de l'objet, en pixels. La valeur par défaut est 600.

heightPixels

integer

Hauteur de l'objet, en pixels. La valeur par défaut est 371.

GridCoordinate

Coordonnée dans une feuille. Tous les index sont basés sur zéro.

Représentation JSON
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
Champs
sheetId

integer

Feuille sur laquelle se trouve cette coordonnée.

rowIndex

integer

Index de ligne de la coordonnée.

columnIndex

integer

Index de colonne de la coordonnée.