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 sur l'aspect compact. Par exemple, les champs de cette représentation peuvent être fournis en toute simplicité au constructeur de java.awt.Color en Java, et facilement à la méthode +colorWithRed:green:blue:alpha d'UIColor dans iOS. Et avec un peu de travail, vous pouvez facilement les mettre en forme en une chaîne rgba() CSS dans JavaScript.

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

Lorsque l'égalité des couleurs doit être décidée, les implémentations, sauf indication contraire, traiteront deux couleurs comme égales si toutes leurs valeurs rouges, vertes, bleues 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 de couleur s'affiche sous la forme d'une couleur unie (comme si la valeur alpha avait été explicitement associée à la valeur 1).

Style de couleur

Une 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

Type de thème

Types de couleurs du thème.

SpreadsheetProperties contient un élément SpreadsheetTheme qui définit un mappage de ces types de couleurs de thème vers des 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 dans 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.

Format de texte

Format d'une exécution 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

Vraie si le texte est en gras.

italic

boolean

Défini sur "true" si le texte est en italique.

strikethrough

boolean

Défini sur "true" si le texte est barré.

underline

boolean

Défini sur "true" si le texte est souligné.

Colonne "SourceDeDonnées"

Colonne d'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.

Référence de colonne de la source de données

Identifiant unique qui 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.

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

É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 données les plus récentes issues d'un objet DataSource. Elle s'exécute généralement en arrière-plan. Vous pouvez consulter son state pour savoir si une exécution est terminée

Il existe plusieurs scénarios dans lesquels une 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 des données pour synchroniser les données de la source de données avec la feuille.
  • Updating a data source crée une exécution de données pour actualiser la feuille de source de données associée de la même manière.
  • 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 de l'exécution des données.

errorCode

enum (DataExecutionErrorCode)

Code d'erreur.

errorMessage

string

Message d'erreur, qui peut être vide.

lastRefreshTime

string (Timestamp format)

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

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

É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 commencé.
RUNNING L'exécution des données a commencé et est en cours.
SUCCEEDED L'exécution des données est terminée.
FAILED L'exécution des données s'est terminée avec des erreurs.

CodeDataErrorError

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

Enums
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
TIMED_OUT Le délai d'exécution des données a expiré.
TOO_MANY_ROWS L'exécution des données renvoie un nombre de lignes supérieur à la limite.
TOO_MANY_COLUMNS L'exécution des données renvoie plus de colonnes que la limite autorisée.
TOO_MANY_CELLS Le nombre de cellules renvoyé dépasse le nombre maximal de cellules autorisé.
ENGINE Le moteur d'exécution des données du backend (par exemple, BigQuery) reçoit une erreur. Pour en savoir plus, consultez errorMessage.
PARAMETER_INVALID Un ou plusieurs 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. Impossible de l'actualiser 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é 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 les colonnes sans alias.
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 d'objet de source de données n'est pas valide.

Valeur étendue

Types de valeurs possibles pour une cellule dans une feuille de calcul.

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 dans 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 dates et heures sont représentées par des doubles au format SERIAL_NUMBER.

stringValue

string

Représente une valeur de chaîne. Les guillemets simples ne sont pas inclus. Par exemple, si l'utilisateur a saisi '123 dans l'UI, cela sera représenté par 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.

Valeur de l'erreur

Erreur dans une cellule.

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

enum (ErrorType)

Type d'erreur.

message

string

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 N'utilisez pas ce type d'erreur par défaut.
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....

Condition booléenne

Une condition qui peut renvoyer la valeur "true" ou "false". Les conditions booléennes sont utilisées par 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 condition type. Certaines n'acceptent aucune valeur, d'autres une ou deux, et ConditionType.ONE_OF_LIST accepte un nombre arbitraire de valeurs.

Type de condition

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 à 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.
NUMBER_GREATER_THAN_EQ La valeur de la cellule doit être supé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 ConditionValue.
NUMBER_LESS La valeur de la cellule doit être inférieure à 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.
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 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 élément ConditionValue pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets provenant de sources de données, et au moins un élément ConditionValue pour les filtres sur les objets sources de données.
NUMBER_NOT_EQ La valeur de la cellule ne doit pas être é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 pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets provenant de sources de données, et au moins un élément ConditionValue pour les filtres sur les objets 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. Requiert exactement deux ConditionValues.
NUMBER_NOT_BETWEEN La valeur de la cellule ne doit pas être comprise entre les deux valeurs de condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Requiert exactement deux ConditionValues.
TEXT_CONTAINS La valeur de la cellule doit 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 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 ConditionValue.
TEXT_STARTS_WITH La valeur de la cellule doit commencer par la valeur de la condition. Compatible avec la mise en forme conditionnelle et les filtres Nécessite un seul ConditionValue.
TEXT_ENDS_WITH La valeur de la cellule doit se terminer par la valeur de la condition. Compatible avec la mise en forme conditionnelle et les filtres Nécessite un seul ConditionValue.
TEXT_EQ La valeur de la cellule doit correspondre 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 élément ConditionValue pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets provenant de sources de données, et au moins un élément ConditionValue pour les filtres sur les objets 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. Aucune ConditionValues requise.
TEXT_IS_URL La valeur de la cellule doit être une URL valide. Compatible avec la validation des données. Aucune ConditionValues requise.
DATE_EQ La valeur de la cellule doit être identique à 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 pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets provenant de sources de données, et au moins un élément ConditionValue pour les filtres sur les objets 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. Requiert une seule ConditionValue, qui peut être une 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. Requiert une seule ConditionValue, qui peut être une relative date.
DATE_ON_OR_BEFORE La valeur de la cellule doit être identique ou antérieure à celle de la valeur de la condition. Compatible avec la validation des données. Requiert une seule ConditionValue, qui peut être une relative date.
DATE_ON_OR_AFTER La valeur de la cellule doit être identique ou postérieure à celle de la valeur de la condition. Compatible avec la validation des données. Requiert une seule ConditionValue, qui peut être une 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. Requiert 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. Requiert exactement deux ConditionValues.
DATE_IS_VALID La valeur de la cellule doit être une date. Compatible avec la validation des données. Aucune ConditionValues requise.
ONE_OF_RANGE La valeur de la cellule doit apparaître dans la grille de la plage de valeurs de la condition. Compatible avec la validation des données. Nécessite un seul élément ConditionValue, et la valeur doit être une plage valide au format 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 un nombre illimité de condition values, un par élément de 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 Aucune ConditionValues requise.
NOT_BLANK La valeur de la cellule est obligatoire. Compatible avec la mise en forme conditionnelle et les filtres Aucune ConditionValues requise.
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 de source de données. Nécessite un seul ConditionValue.
BOOLEAN La valeur de la cellule doit être TRUE/FALSE ou dans la liste des valeurs de condition. Compatible avec la validation des données. Rendu sous forme de case à cocher de cellule. Accepte les zéros, les un ou deux ConditionValues. Aucune valeur n'indique que la cellule doit être définie sur TRUE ou FALSE, où TRUE est affiché comme coché et FALSE comme rendu non coché. Une valeur indique que la cellule s'affiche comme cochée lorsqu'elle contient cette valeur et qu'elle est décochée lorsqu'elle est vide. Deux valeurs indiquent que la cellule s'affiche comme vérifiée lorsqu'elle contient la première valeur et décochée lorsqu'elle contient la deuxième valeur. Par exemple, ["Oui","Non"] indique que la cellule affiche une case cochée si elle est associée à la valeur "Oui" et une case décochée lorsqu'elle a la valeur "Non".
TEXT_NOT_EQ La valeur de la cellule ne doit pas être celle de la condition. Pris en charge par les filtres sur les objets de source de données. Nécessite au moins un élément ConditionValue.
DATE_NOT_EQ La valeur de la cellule ne doit pas être celle de la condition. Pris en charge par les filtres sur les objets de source de données. Nécessite au moins un élément ConditionValue.
FILTER_EXPRESSION La valeur de la cellule doit respecter le format spécifié. Nécessite un seul ConditionValue.

Valeur de la condition

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, dont un seul doit être défini. value ne peut être que l'un des éléments suivants:
relativeDate

enum (RelativeDate)

Date relative (basée sur la date du jour). 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 acceptées pour la validation des données. Ils ne sont compatibles qu'avec la mise en forme conditionnelle 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. Les formules sont acceptées (et doivent commencer par = ou +).

Date relative

Contrôle la façon dont une condition de date est évaluée.

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

Plage de grille

Plage sur une feuille. Tous les index sont basés sur zéro. Les index sont à moitié ouverts, ce qui signifie 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 est illimitée de ce côté.

Par exemple, si "Sheet1" correspond à l'ID de 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épart doit toujours être inférieur ou égal à l'index de fin. Si l'index de départ est égal à l'index de fin, la plage est vide. Les plages vides ne sont généralement pas pertinentes 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

Ligne de départ (incluse) de la plage, ou non définie si elle n'est pas limitée.

endRowIndex

integer

Ligne de fin (exclue) de la plage, ou non définie si illimitée.

startColumnIndex

integer

Colonne de début (incluse) de la plage, ou non définie si elle n'est pas limitée.

endColumnIndex

integer

Colonne de fin (exclue) de la plage, ou non définie si elle n'est pas limitée.

SortOrder

Un 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.

Spécifications des filtres

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

L'index de colonne basé sur zéro.

dataSourceColumnReference

object (DataSourceColumnReference)

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

Critères de filtre

Critères permettant d'afficher ou de masquer des lignes dans une vue filtrée ou de filtre.

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

string

Valeurs à masquer.

condition

object (BooleanCondition)

Une condition qui doit être vraie pour que les valeurs soient affichées. (Cela n'ignore pas hiddenValues. Si une valeur est répertoriée ici, elle sera toujours masquée.)

visibleBackgroundColor
(deprecated)

object (Color)

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

visibleBackgroundColorStyle

object (ColorStyle)

Couleur de remplissage de l'arrière-plan à utiliser pour le filtrage. Seules les cellules contenant cette couleur 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 de cette couleur de premier plan sont affichées. Mutuellement exclusif avec visibleBackgroundColor. Obsolète: utilisez visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Couleur de premier plan à utiliser pour le filtrage. Seules les cellules de 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.

Trier les spécifications

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 de commande doivent être triées.

foregroundColor
(deprecated)

object (Color)

Couleur de premier plan à trier. Les cellules de cette couleur de premier plan sont triées vers le haut. Mutuellement exclusif avec backgroundColor. Obsolète: utilisez foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Couleur de premier plan à trier. Les cellules de cette couleur de premier plan sont triées vers le haut. Mutuellement exclusif 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 à trier. Les cellules avec cette couleur sont triées en haut. Mutuellement exclusif avec foregroundColor. Obsolète: utilisez backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Couleur de remplissage de l'arrière-plan à trier. Les cellules avec cette couleur sont triées en haut. Mutuellement exclusif 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é, comme 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. Une seule valeur doit être définie. location ne peut être que l'un des éléments suivants:
sheetId

integer

Feuille sur laquelle se trouve cette feuille. À 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é sur une grille.

newSheet

boolean

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

Position en superposition

Emplacement auquel un objet est superposé sur une grille.

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

object (GridCoordinate)

Cellule à laquelle l'objet est ancré

offsetXPixels

integer

Décalage horizontal, en pixels, par rapport à 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.

GrilleCoordinate

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 cette coordonnée est activée.

rowIndex

integer

Index de ligne de la coordonnée.

columnIndex

integer

Index de la colonne de coordonnées.