REST Resource: spreadsheets

Ressource : Feuille de calcul

Ressource représentant une feuille de calcul.

Représentation JSON
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
Champs
spreadsheetId

string

ID de la feuille de calcul. Ce champ est en lecture seule.

properties

object (SpreadsheetProperties)

Propriétés générales d'une feuille de calcul.

sheets[]

object (Sheet)

Feuilles d'une feuille de calcul.

namedRanges[]

object (NamedRange)

Plages nommées définies dans une feuille de calcul.

spreadsheetUrl

string

URL de la feuille de calcul. Ce champ est en lecture seule.

developerMetadata[]

object (DeveloperMetadata)

Métadonnées du développeur associées à une feuille de calcul.

dataSources[]

object (DataSource)

Une liste des sources de données externes connectées à la feuille de calcul.

dataSourceSchedules[]

object (DataSourceRefreshSchedule)

Uniquement en sortie. Liste des calendriers d'actualisation des sources de données.

SpreadsheetProperties

Propriétés d'une feuille de calcul.

Représentation JSON
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
Champs
title

string

Titre de la feuille de calcul.

locale

string

Le paramètre régional de la feuille de calcul dans l'un des formats suivants :

  • un code de langue ISO 639-1, tel que en

  • un code de langue ISO 639-2 tel que fil, si aucun code ISO 639-1 n'existe

  • une combinaison du code de langue ISO et du code pays, par exemple en_US

Remarque: Lors de la mise à jour de ce champ, toutes les langues/paramètres régionaux ne sont pas pris en charge.

autoRecalc

enum (RecalculationInterval)

Délai d'attente avant le recalcul des fonctions volatiles.

timeZone

string

Fuseau horaire de la feuille de calcul, au format CLDR tel que America/New_York. Si le fuseau horaire n'est pas reconnu, il peut s'agir d'un fuseau horaire personnalisé tel que GMT-07:00.

defaultFormat

object (CellFormat)

Format par défaut de toutes les cellules de la feuille de calcul. CellData.effectiveFormat ne sera pas défini si le format de la cellule est égal à ce format par défaut. Ce champ est en lecture seule.

iterativeCalculationSettings

object (IterativeCalculationSettings)

Détermine si et comment les références circulaires sont résolues par un calcul itératif. L'absence de ce champ signifie que les références circulaires entraînent des erreurs de calcul.

spreadsheetTheme

object (SpreadsheetTheme)

Thème appliqué à la feuille de calcul.

importFunctionsExternalUrlAccessAllowed

boolean

Permet d'autoriser ou non l'accès par une URL externe pour les fonctions d'image et d'importation. Lire uniquement si vrai. Si la valeur est "false", vous pouvez la définir sur "true". Cette valeur est ignorée et renvoie toujours la valeur "true" si l'administrateur a activé la fonctionnalité d'ajout à la liste d'autorisation.

RecalculationInterval

Énumération des options d'intervalle de recalcul possibles.

Enums
RECALCULATION_INTERVAL_UNSPECIFIED Valeur par défaut. Cette valeur ne doit pas être utilisée.
ON_CHANGE Les fonctions volatiles sont mises à jour à chaque modification.
MINUTE Les fonctions volatiles sont mises à jour à chaque modification et chaque minute.
HOUR Les fonctions volatiles sont mises à jour toutes les heures et à chaque modification.

IterativeCalculationSettings

Paramètres permettant de contrôler la résolution des dépendances circulaires avec un calcul itératif.

Représentation JSON
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Champs
maxIterations

integer

Lorsque les calculs itératifs sont activés, le nombre maximal d'arrondis de calcul est atteint.

convergenceThreshold

number

Lorsque le calcul itératif est activé et que les résultats successifs diffèrent de moins de cette valeur seuil, les itérations de calcul s'arrêtent.

SpreadsheetTheme

Représente le thème de la feuille de calcul

Représentation JSON
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Champs
primaryFontFamily

string

Nom de la famille de polices principale.

themeColors[]

object (ThemeColorPair)

Paires de couleurs du thème de la feuille de calcul. Pour effectuer la mise à jour, vous devez fournir toutes les paires de couleurs du thème.

ThemeColorPair

Paire mappant le type de couleur d'un thème de feuille de calcul à la couleur concrète qu'il représente.

Représentation JSON
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Champs
colorType

enum (ThemeColorType)

Type de couleur du thème de la feuille de calcul.

color

object (ColorStyle)

Couleur concrète correspondant au type de couleur du thème.

NamedRange

Une plage nommée.

Représentation JSON
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Champs
namedRangeId

string

ID de la plage nommée.

name

string

Nom de la plage nommée.

range

object (GridRange)

Plage représentée.

DataSource

Informations sur une source de données externe dans la feuille de calcul.

Représentation JSON
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Champs
dataSourceId

string

Identifiant unique de portée feuille de calcul qui identifie la source de données. Exemple : 1080547365.

spec

object (DataSourceSpec)

DataSourceSpec de la source de données associée à cette feuille de calcul.

calculatedColumns[]

object (DataSourceColumn)

Toutes les colonnes calculées de la source de données.

sheetId

integer

ID de l'élément Sheet associé à la source de données. Une fois défini, ce champ ne peut plus être modifié.

Lorsque vous créez une source de données, une feuille DATA_SOURCE associée est également créée. Si le champ n'est pas spécifié, l'ID de la feuille créée est généré de manière aléatoire.

DataSourceSpec

Ce champ spécifie les détails de la source de données. Par exemple, pour BigQuery, cela spécifie des informations sur la source BigQuery.

Représentation JSON
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
Champs
parameters[]

object (DataSourceParameter)

Paramètres de la source de données, utilisés lors de l'interrogation de la source de données.

Champ d'union spec. Spécification réelle par type de source de données. spec ne peut être qu'un des éléments suivants :
bigQuery

object (BigQueryDataSourceSpec)

Un BigQueryDataSourceSpec.

looker

object (LookerDataSourceSpec)

Une spécification [LookerDatasourceSpec][].

BigQueryDataSourceSpec

Spécification d'une source de données BigQuery connectée à une feuille.

Représentation JSON
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
Champs
projectId

string

ID d'un projet Google Cloud avec BigQuery activé et un compte de facturation associé. Le projet est facturé pour toutes les requêtes exécutées sur la source de données.

Champ d'union spec. Spécification réelle. spec ne peut être qu'un des éléments suivants :
querySpec

object (BigQueryQuerySpec)

Un BigQueryQuerySpec.

tableSpec

object (BigQueryTableSpec)

Un BigQueryTableSpec.

BigQueryQuerySpec

Spécifie une requête BigQuery personnalisée.

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

string

Chaîne de requête brute.

BigQueryTableSpec

Spécifie une définition de table BigQuery. Seules les tables natives sont autorisées.

Représentation JSON
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
Champs
tableProjectId

string

ID d'un projet BigQuery auquel la table appartient. Si aucune valeur n'est spécifiée, projectId est utilisé.

tableId

string

ID de la table BigQuery.

datasetId

string

ID de l'ensemble de données BigQuery.

LookerDataSourceSpec

Spécification d'une source de données Looker.

Représentation JSON
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
Champs
instanceUri

string

URL d'une instance Looker.

model

string

Nom d'un modèle Looker.

explore

string

Nom d'une exploration de modèle Looker.

DataSourceParameter

Paramètre dans la requête d'une source de données. Ce paramètre permet à l'utilisateur de transmettre des valeurs de la feuille de calcul dans une requête.

Représentation JSON
{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
Champs
Champ d'union identifier. Identifiant du paramètre. identifier ne peut être qu'un des éléments suivants :
name

string

Paramètre nommé. Doit être un identifiant légitime pour le DataSource qui le prend en charge. (par exemple, identifiant BigQuery)

Champ d'union value. Valeur du paramètre. value ne peut être qu'un des éléments suivants :
namedRangeId

string

ID d'un NamedRange. Sa taille doit être de 1 x 1.

range

object (GridRange)

Plage contenant la valeur du paramètre. Sa taille doit être de 1 x 1.

DataSourceRefreshSchedule

Planifiez l'actualisation de la source de données.

Les sources de données de la feuille de calcul sont actualisées à un intervalle donné. Vous pouvez spécifier l'heure de début en cliquant sur le bouton Actualisation programmée dans l'éditeur Sheets, mais l'intervalle est fixé à 4 heures. Par exemple, si vous spécifiez une heure de début à 8h, l'actualisation aura lieu entre 8h et 12h tous les jours.

Représentation JSON
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
Champs
enabled

boolean

"True" si la programmation d'actualisation est activée, ou "false" dans le cas contraire.

refreshScope

enum (DataSourceRefreshScope)

Champ d'application de l'actualisation. doit être ALL_DATA_SOURCES

nextRun

object (Interval)

Uniquement en sortie. Intervalle de temps de la prochaine exécution.

Champ d'union schedule_config. Les configurations de planification schedule_config ne peuvent être que l'un des éléments suivants:
dailySchedule

object (DataSourceRefreshDailySchedule)

Programmation d'actualisation quotidienne.

weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Programmation d'actualisation hebdomadaire.

monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Calendrier d'actualisation mensuel.

DataSourceRefreshScope

Champs d'application de l'actualisation de la source de données.

Enums
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
ALL_DATA_SOURCES Actualise toutes les sources de données et les objets de source de données associés dans la feuille de calcul.

DataSourceRefreshDailySchedule

Calendrier d'actualisation des données chaque jour à un intervalle donné.

Représentation JSON
{
  "startTime": {
    object (TimeOfDay)
  }
}
Champs
startTime

object (TimeOfDay)

Heure de début d'un intervalle de temps au cours duquel une actualisation de la source de données est planifiée. Seule la partie hours est utilisée. La taille de l'intervalle de temps est définie par défaut dans l'éditeur Sheets.

TimeOfDay

Représente une heure de la journée. La date et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. Une API peut choisir d'autoriser des secondes intercalaires. Les types associés sont google.type.Date et google.protobuf.Timestamp.

Représentation JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Champs
hours

integer

Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.

minutes

integer

Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59.

seconds

integer

Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.

nanos

integer

Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999.

DataSourceRefreshWeeklySchedule

Fréquence d'actualisation hebdomadaire des données certains jours dans un intervalle de temps donné.

Représentation JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Champs
startTime

object (TimeOfDay)

Heure de début d'un intervalle de temps pendant lequel l'actualisation d'une source de données est planifiée. Seule la partie hours est utilisée. La taille de l'intervalle de temps est définie par défaut dans l'éditeur Sheets.

daysOfWeek[]

enum (DayOfWeek)

Jours de la semaine à actualiser. Vous devez spécifier au moins un jour.

DayOfWeek

Représente un jour de la semaine.

Enums
DAY_OF_WEEK_UNSPECIFIED Le jour de la semaine n'est pas spécifié.
MONDAY Lundi
TUESDAY Mardi
WEDNESDAY Mercredi
THURSDAY Jeudi
FRIDAY Vendredi
SATURDAY Samedi
SUNDAY Dimanche

DataSourceRefreshMonthlySchedule

Calendrier mensuel d'actualisation des données à des jours spécifiques du mois, dans un intervalle de temps donné.

Représentation JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Champs
startTime

object (TimeOfDay)

Heure de début d'un intervalle de temps pendant lequel l'actualisation d'une source de données est planifiée. Seule la partie hours est utilisée. La taille de l'intervalle de temps est définie par défaut dans l'éditeur Sheets.

daysOfMonth[]

integer

Jours du mois à actualiser. Seules les valeurs 1 à 28 sont acceptées, avec une correspondance entre le 1er et le 28. Vous devez spécifier au moins un jour.

Intervalle

Représente un intervalle de temps, encodé sous la forme d'un code temporel de début (inclus) et d'un code temporel de fin (exclu).

La date de début doit être inférieure ou égale à la date de fin. Lorsque le début est égal à la fin, l'intervalle est vide (il ne correspond à aucune heure). Lorsque le début et la fin ne sont pas spécifiés, l'intervalle correspond à n'importe quel moment.

Représentation JSON
{
  "startTime": string,
  "endTime": string
}
Champs
startTime

string (Timestamp format)

Facultatif. Début de l'intervalle inclusif.

S'il est spécifié, le code temporel correspondant à cet intervalle doit être identique ou postérieure au début.

endTime

string (Timestamp format)

Facultatif. Fin exclusive de l'intervalle.

Si elle est spécifiée, un code temporel correspondant à cet intervalle doit être antérieur à la fin.

Méthodes

batchUpdate

Applique une ou plusieurs mises à jour à la feuille de calcul.

create

Crée une feuille de calcul et renvoie la feuille de calcul qui vient d'être créée.

get

Renvoie la feuille de calcul associée à l'ID donné.

getByDataFilter

Renvoie la feuille de calcul associée à l'ID donné.