Other

Couleur

Représente une couleur dans l'espace colorimétrique RVBA. Cette représentation est conçue pour faciliter la conversion vers et depuis des représentations de couleurs dans différentes langues, plutôt que pour être compacte. Par exemple, les champs de cette représentation peuvent être fournis de manière triviale au constructeur de java.awt.Color en Java, à la méthode +colorWithRed:green:blue:alpha de UIColor dans iOS, et peuvent être facilement mis en forme en chaîne rgba() CSS 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 partir du principe qu'il s'agit de l'espace colorimétrique sRVB.

Lorsqu'il faut décider de l'égalité des couleurs, les implémentations, sauf indication contraire, considèrent que deux couleurs sont égales si toutes leurs valeurs rouge, vert, bleu et alpha diffèrent chacune d'au plus 1e-5.

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 opaque, tandis qu'une valeur de 0,0 correspond à une couleur totalement transparente. Un message wrapper est utilisé à la place d'une simple valeur scalaire flottante pour permettre de faire la distinction entre une valeur par défaut et la valeur vide. En cas d'omission, cet objet de couleur est affiché en tant que couleur opaque (comme si la valeur alpha avait été explicitement fournie avec une valeur de 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 qu'un des éléments suivants :
rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

Couleur du thème.

ThemeColorType

Types de couleurs de thème.

SpreadsheetProperties contiennent un SpreadsheetTheme qui définit un mappage de ces types de couleurs de thème à des couleurs concrètes.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Couleur de thème non spécifiée
TEXT Représente la couleur du texte principal
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 pas utiliser.
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 absentes 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 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.

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 dans 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. Il est généralement planifié pour s'exécuter en arrière-plan. Vous pouvez vérifier son state pour savoir si une exécution est terminée.

Plusieurs scénarios peuvent déclencher l'exécution de données :

  • 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 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)

Obtient l'heure à laquelle les données ont été actualisées pour la dernière fois.

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 commencé.
RUNNING L'exécution des données a commencé et est en cours.
CANCELLING L'exécution des données est en cours d'annulation.
SUCCEEDED L'exécution des données a bien été effectuée.
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 Le délai d'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 Une 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 plusieurs 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 ou des alias de colonnes en double.
INTERRUPTED L'exécution des données est interrompue. Veuillez actualiser la page plus tard.
CONCURRENT_QUERY L'exécution des données est en cours. Vous ne pourrez pas les actualiser tant qu'elle ne sera 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 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 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 contenir.

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 qu'un des éléments suivants :
numberValue

number

Représente une valeur double. Remarque : Les dates, heures et date/heures sont représentées sous forme de valeurs doubles au format SERIAL_NUMBER.

stringValue

string

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

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

Condition qui peut renvoyer la valeur "true" ou "false". Les BooleanConditions 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. Certains acceptent des 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 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 à 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_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 ConditionValue pour la validation des données, la mise en forme conditionnelle et les filtres sur les objets de source de données, et au moins un ConditionValue pour les filtres sur les objets de source 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 de source de données, et au moins un ConditionValue pour les filtres sur les objets de source de données.
NUMBER_BETWEEN La valeur de la cellule doit être comprise entre les deux valeurs de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Exige exactement deux ConditionValues.
NUMBER_NOT_BETWEEN La valeur de la cellule ne doit pas être comprise entre les deux valeurs de la condition. Compatible avec la validation des données, la mise en forme conditionnelle et les filtres. Exige 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 être exactement 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 de source de données, et au moins un ConditionValue pour les filtres sur les objets de source de données.
TEXT_IS_EMAIL La valeur de la cellule doit être une adresse e-mail valide. Soutenue par la validation des données. Ne nécessite pas de ConditionValues.
TEXT_IS_URL La valeur de la cellule doit être une URL valide. Soutenue par la validation des données. Ne nécessite pas de ConditionValues.
DATE_EQ La valeur de la cellule doit être la même date que 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 de source de données, et au moins un ConditionValue pour les filtres sur les objets de source 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 qui peut ê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 qui peut être un relative date.
DATE_ON_OR_BEFORE La valeur de la cellule doit être identique ou antérieure à la valeur de la condition. Soutenue par la validation des données. Nécessite un seul ConditionValue qui peut être un relative date.
DATE_ON_OR_AFTER La valeur de la cellule doit être égale ou postérieure à la date de la valeur de la condition. Soutenue par la validation des données. Nécessite un seul ConditionValue qui peut être un relative date.
DATE_BETWEEN La valeur de la cellule doit être comprise entre les dates des deux valeurs de condition. Soutenue par la validation des données. Exige exactement deux ConditionValues.
DATE_NOT_BETWEEN La valeur de la cellule doit être en dehors des dates des deux valeurs de condition. Soutenue par la validation des données. Exige exactement deux ConditionValues.
DATE_IS_VALID La valeur de la cellule doit être une date. Soutenue par la validation des données. Ne nécessite pas de ConditionValues.
ONE_OF_RANGE La valeur de la cellule doit figurer dans la plage de valeurs de la condition dans la grille. Soutenue par la validation des données. Nécessite une seule 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. Soutenue par 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 acceptées dans les valeurs.
BLANK La valeur de la cellule doit être vide. Compatible avec la mise en forme conditionnelle et les filtres. Ne nécessite pas de ConditionValues.
NOT_BLANK La valeur de la cellule ne doit pas être vide. Compatible avec la mise en forme conditionnelle et les filtres. Ne nécessite pas de ConditionValues.
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 figurer dans la liste des valeurs de condition. Soutenue par la validation des données. Affiche une case à cocher dans une cellule. Accepte zéro, un ou deux ConditionValues. Si aucune valeur n'est indiquée, la cellule doit être définie sur TRUE (VRAI) ou FALSE (FAUX). TRUE est affiché sous forme de case à cocher et FALSE sous forme de case non cochée. Une valeur indique que la cellule sera cochée lorsqu'elle contient cette valeur et décochée lorsqu'elle est vide. Deux valeurs indiquent que la cellule sera coché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 affichera une case à cocher cochée si sa valeur est "Oui" et une case à cocher non cochée si sa valeur est "Non".
TEXT_NOT_EQ La valeur de la cellule doit être exactement différente de celle de la condition. Compatible avec les filtres sur les objets de source de données. Requiert au moins un ConditionValue.
DATE_NOT_EQ La valeur de la cellule doit être exactement différente de celle de la condition. Compatible avec les filtres sur les objets de source de données. Requiert au moins un ConditionValue.
FILTER_EXPRESSION La valeur de la cellule doit respecter le format spécifié. Nécessite un seul 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. La valeur de la condition. Une seule valeur doit être définie. value ne peut être qu'un des éléments suivants :
relativeDate

enum (RelativeDate)

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 acceptées dans la validation des données. Elles ne sont acceptées que dans la mise en forme conditionnelle et les filtres conditionnels.

userEnteredValue

string

Valeur sur laquelle repose la condition. La valeur est analysée comme si l'utilisateur l'avait saisie dans une cellule. Les formules sont acceptées (et doivent commencer par un = ou un signe +).

RelativeDate

Contrôle la manière dont une condition de date est évaluée.

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

GridRange

Plage dans une feuille. Tous les index sont basés sur zéro. Les index sont semi-ouverts, c'est-à-dire que l'index de début est inclusif et 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" correspond à l'ID de feuille 123456, alors :

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 n'ont généralement pas de sens et sont généralement affichées dans l'UI 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ébut (incluse) de la plage, ou non définie si elle n'est pas limitée.

endRowIndex

integer

Ligne de fin (exclusive) de la plage, ou non définie si elle n'est pas limité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 (exclusive) 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

FilterSpec

Critères de filtrage 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 qu'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 permettant d'afficher ou de masquer des lignes dans un filtre ou une vue 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 à masquer.

condition

object (BooleanCondition)

Condition qui doit être true pour que les valeurs s'affichent. (Cela ne remplace pas hiddenValues -- si une valeur y est listé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. S'exclut mutuellement 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 à filtrer. Seules les cellules avec cette couleur de premier plan sont affichées. S'exclut mutuellement avec visibleBackgroundColor. Obsolète : utilisez visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Couleur de premier plan à filtrer. 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 de commande doivent être triées.

foregroundColor
(deprecated)

object (Color)

Couleur de premier plan selon laquelle trier les cellules. Les cellules avec cette couleur de premier plan sont triées en haut. S'exclut mutuellement avec backgroundColor. Obsolète : utilisez foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Couleur de premier plan selon laquelle trier les cellules. Les cellules avec cette couleur de premier plan sont triées en haut. Exclusif avec backgroundColor et doit être 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 selon laquelle trier les cellules (celles avec cette couleur de remplissage sont triées en haut). S'exclut mutuellement avec foregroundColor. Obsolète : utilisez backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Couleur de remplissage de l'arrière-plan selon laquelle trier les cellules (celles avec cette couleur de remplissage sont triées en haut). Exclusif avec foregroundColor et doit être 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 qu'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. Une seule valeur doit être définie. location ne peut être qu'un des éléments suivants :
sheetId

integer

La feuille sur laquelle se trouve la cellule. Défini 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'ID est choisi pour vous. Utilisé uniquement lors de l'écriture.

OverlayPosition

Emplacement d'un objet superposé à 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, de l'objet par rapport à la cellule d'ancrage.

offsetYPixels

integer

Décalage vertical, en pixels, de l'objet par rapport à 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.