Other

Couleur

Représente une couleur dans l'espace colorimétrique RVBA. Cette représentation est conçue pour faciliter la conversion entre les représentations de couleurs dans différentes langues plutôt que d'être compacte. Par exemple, les champs de cette représentation peuvent être facilement fournis au constructeur de java.awt.Color en Java. Ils peuvent également être facilement fournis à la méthode +colorWithRed:green:blue:alpha de UIColor sur iOS. De plus, avec un peu de travail, ils peuvent être facilement mis en forme dans une 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 (sRVB, Adobe RVB, DCI-P3 et BT.2020, par exemple). Par défaut, les applications doivent supposer que l'espace colorimétrique sRVB est utilisé.

Lorsqu'il faut déterminer l'égalité des couleurs, les implémentations, sauf indication contraire dans la documentation, considèrent deux couleurs comme égales si toutes leurs valeurs de rouge, de vert, de bleu et d'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 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 est affiché en tant que couleur solide (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 du thème.

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

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

TextFormat

Format d'une séquence de texte dans une cellule. L'absence de valeur indique 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 la 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 de l'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 d'un DataSource. Elle est généralement programmée 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 et 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)

Récupère 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 d'exécution.
CANCELLING L'exécution des données est actuellement annulée.
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 des codes 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 autorisée.
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 du backend (par exemple, BigQuery). Pour en savoir plus, consultez errorMessage.
PARAMETER_INVALID Un ou plusieurs des paramètres de la 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 a renvoyé des noms ou des alias de colonnes 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é 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 la 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 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 dates/heures sont représentées sous forme de doubles au format SERIAL_NUMBER.

stringValue

string

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

Une 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 pouvant 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. Certains acceptent zéro valeur, 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. Pris en charge par 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 autres que des sources 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 à 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 source 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 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 celle de la condition. Pris en charge par la mise en forme conditionnelle et les filtres. Nécessite un seul 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 source de données.
TEXT_IS_EMAIL La valeur de la cellule doit être une adresse e-mail valide. Pris en charge par la validation des données. Aucune ConditionValues requise.
TEXT_IS_URL La valeur de la cellule doit être une URL valide. Pris en charge par 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 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 source de données.
DATE_BEFORE La valeur de la cellule doit être antérieure à la date de la valeur de la condition. Pris en charge par 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 égale ou antérieure à celle de la condition. Pris en charge 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 identique ou postérieure à la date de la valeur de la condition. Pris en charge 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. Pris en charge par la validation des données. Nécessite exactement deux ConditionValues.
DATE_NOT_BETWEEN La valeur de la cellule doit se situer en dehors des dates des deux valeurs de condition. Pris en charge par la validation des données. Nécessite exactement deux ConditionValues.
DATE_IS_VALID La valeur de la cellule doit être une date. Pris en charge par la validation des données. Aucun ConditionValues requis.
ONE_OF_RANGE La valeur de la cellule doit figurer dans la grille dans la plage de la valeur de la condition. Pris en charge par la validation des données. Nécessite un seul 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. Pris en charge par la validation des données. Accepte un nombre illimité 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. Aucune ConditionValues requise.
NOT_BLANK La valeur de la cellule ne doit pas être vide. 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. Les filtres de feuilles de source de données ne sont pas compatibles. Nécessite un seul ConditionValue.
BOOLEAN La valeur de la cellule doit être "TRUE/FALSE" ou figurer dans la liste des valeurs de condition. Pris en charge par la validation des données. S'affiche sous la forme d'une case à cocher de cellule. Compatible avec zéro, un ou deux ConditionValues. Aucune valeur indique que la cellule doit être VRAI ou FAUX, où VRAI s'affiche comme coché et FAUX comme non coché. Une valeur indique que la cellule sera cochée lorsqu'elle la contiendra et décochée lorsqu'elle sera vide. Deux valeurs indiquent que la cellule s'affichera comme cochée lorsqu'elle contient la première valeur et comme décochée lorsqu'elle contient la deuxième valeur. Par exemple, ["Oui","Non"] indique que la cellule affichera une case cochée lorsque la valeur est "Oui" et une case non cochée lorsque la 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. Valeur de la condition. Une seule d'entre elles 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 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 la condition est basée. La valeur est analysée comme si l'utilisateur avait saisi du texte dans une cellule. Les formules sont acceptées (et doivent commencer par = ou "+").

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 aujourd'hui.
PAST_MONTH La valeur correspond à un mois avant aujourd'hui.
PAST_WEEK La valeur correspond à une semaine avant aujourd'hui.
YESTERDAY La valeur est hier.
TODAY La valeur est "Aujourd'hui".
TOMORROW La valeur est "demain".

GridRange

Plage d'une feuille. Tous les indices sont basés sur zéro. Les indices 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 la 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 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ébut (inclusive) de la plage, ou non définie si la plage n'est pas limitée.

endRowIndex

integer

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

startColumnIndex

integer

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

endColumnIndex

integer

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

SortOrder

Un ordre de tri.

Enums
SORT_ORDER_UNSPECIFIED Ne l'utilisez pas par défaut.
ASCENDING Triez les résultats dans l'ordre croissant.
DESCENDING Triez dans l'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 qu'un des éléments suivants :
columnIndex

integer

Indice de colonne basé sur zéro.

dataSourceColumnReference

object (DataSourceColumnReference)

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

FilterCriteria

Critères d'affichage/de masquage 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 vraie pour que les valeurs soient affichées. (Cette valeur 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 à filtrer. 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 à filtrer. 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 prévaut.

visibleForegroundColor
(deprecated)

object (Color)

Couleur de premier plan à utiliser comme filtre. 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 de cette couleur 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 prévaut.

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 à utiliser pour le tri. Les cellules de cette couleur sont triées en haut. S'exclut mutuellement avec backgroundColor. Obsolète: utilisez foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Couleur de premier plan à utiliser pour le tri. Les cellules de cette couleur sont triées en haut. Exclusion mutuelle avec backgroundColor, et doit être 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 de 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 avec cette couleur de remplissage sont triées en haut. Valeurs mutuellement exclusives avec foregroundColor. 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 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 devez définir une seule valeur. location ne peut être qu'un des éléments suivants :
sheetId

integer

La feuille sur laquelle se trouve cette adresse. 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é dans une nouvelle feuille dont l'ID est choisi pour vous. Utilisé uniquement lors de l'écriture.

OverlayPosition

Position d'un objet 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, 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. Valeur par défaut : 600.

heightPixels

integer

Hauteur de l'objet, en pixels. Valeur par défaut : 371.

GridCoordinate

Coordonnée dans une feuille. Tous les indices 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 la colonne de la coordonnée.