Accéder à la feuille de source de données existante et la modifier Pour créer une feuille de source de données, utilisez Spreadsheet.insertDataSourceSheet(spec)
.
N'utilisez cette classe qu'avec les données connectées à une base de données.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
addFilter(columnName, filterCriteria) | DataSourceSheet | Ajoute un filtre appliqué à la feuille de la source de données. |
asSheet() | Sheet | Renvoie la feuille de source de données en tant qu'objet sheet standard. |
autoResizeColumn(columnName) | DataSourceSheet | Redimensionne automatiquement la largeur de la colonne spécifiée. |
autoResizeColumns(columnNames) | DataSourceSheet | Redimensionne automatiquement la largeur des colonnes spécifiées. |
forceRefreshData() | DataSourceSheet | Actualise les données de cet objet, quel que soit l'état actuel. |
getColumnWidth(columnName) | Integer | Renvoie la largeur de la colonne spécifiée. |
getDataSource() | DataSource | Récupère la source de données à laquelle l'objet est associé. |
getFilters() | DataSourceSheetFilter[] | Affiche tous les filtres appliqués à la feuille de la source de données. |
getSheetValues(columnName) | Object[] | Renvoie toutes les valeurs de la feuille de la source de données pour le nom de colonne fourni. |
getSheetValues(columnName, startRow, numRows) | Object[] | Renvoie toutes les valeurs de la feuille de source de données pour le nom de colonne fourni à partir de la ligne de début fournie (based-1) et jusqu'à la valeur numRows fournie. |
getSortSpecs() | SortSpec[] | Récupère toutes les spécifications de tri de la feuille de la source de données. |
getStatus() | DataExecutionStatus | Récupère l'état d'exécution des données de l'objet. |
refreshData() | DataSourceSheet | Actualise les données de l'objet. |
removeFilters(columnName) | DataSourceSheet | Supprime tous les filtres appliqués à la colonne de la feuille de la source de données. |
removeSortSpec(columnName) | DataSourceSheet | Supprime la spécification de tri sur une colonne de la feuille de la source de données. |
setColumnWidth(columnName, width) | DataSourceSheet | Définit la largeur de la colonne spécifiée. |
setColumnWidths(columnNames, width) | DataSourceSheet | Définit la largeur des colonnes spécifiées. |
setSortSpec(columnName, ascending) | DataSourceSheet | Définit les spécifications de tri sur une colonne de la feuille de la source de données. |
setSortSpec(columnName, sortOrder) | DataSourceSheet | Définit les spécifications de tri sur une colonne de la feuille de la source de données. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Attend la fin de l'exécution en cours. Elle expire après le nombre de secondes indiqué. |
Documentation détaillée
addFilter(columnName, filterCriteria)
Ajoute un filtre appliqué à la feuille de la source de données.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne à laquelle appliquer ce filtre. |
filterCriteria | FilterCriteria | Critères de filtre à appliquer. |
Renvois
DataSourceSheet
: feuille de la source de données, pour le chaînage de méthodes.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asSheet()
Renvoie la feuille de source de données en tant qu'objet sheet standard.
Renvois
Sheet
: feuille standard.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnName)
Redimensionne automatiquement la largeur de la colonne spécifiée.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne. |
Renvois
DataSourceSheet
: feuille de source de données, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(columnNames)
Redimensionne automatiquement la largeur des colonnes spécifiées.
Paramètres
Nom | Type | Description |
---|---|---|
columnNames | String[] | Liste des noms de colonnes à mettre à jour. |
Renvois
DataSourceSheet
: feuille de source de données, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Actualise les données de cet objet, quel que soit l'état actuel. Pour en savoir plus, consultez refreshData()
.
Génère une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution()
afin d'activer l'exécution des données pour un type de source de données spécifique.
Renvois
DataSourceSheet
: objet de données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnName)
Renvoie la largeur de la colonne spécifiée.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne. |
Renvois
Integer
: largeur de la colonne ou null
si la colonne utilise la largeur par défaut.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Récupère la source de données à laquelle l'objet est associé.
Renvois
DataSource
: source de données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilters()
Affiche tous les filtres appliqués à la feuille de la source de données.
Renvois
DataSourceSheetFilter[]
: tableau de l'ensemble des filtres appliqués à la feuille de la source de données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(columnName)
Renvoie toutes les valeurs de la feuille de la source de données pour le nom de colonne fourni.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne de la source de données pour laquelle extraire les valeurs. |
Renvois
Object[]
: tableau de valeurs unidimensionnel.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(columnName, startRow, numRows)
Renvoie toutes les valeurs de la feuille de source de données pour le nom de colonne fourni à partir de la ligne de début fournie (based-1) et jusqu'à la valeur numRows
fournie.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne de la source de données pour laquelle extraire les valeurs. |
startRow | Integer | Position de la ligne à partir de laquelle commencer à récupérer les valeurs. |
numRows | Integer | Nombre de lignes à récupérer. |
Renvois
Object[]
: tableau de valeurs unidimensionnel.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSortSpecs()
Récupère toutes les spécifications de tri de la feuille de la source de données.
Renvois
SortSpec[]
: liste de spécifications de tri.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Récupère l'état d'exécution des données de l'objet.
Renvois
DataExecutionStatus
: état d'exécution des données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Actualise les données de l'objet.
Génère une exception s'il est actuellement à l'état error
. Utilisez DataSource#updateSpec()
pour mettre à jour la spécification. Il est préférable d'utiliser cette méthode plutôt que forceRefreshData()
pour éviter toute modification inattendue de la source de données.
Génère une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution()
afin d'activer l'exécution des données pour un type de source de données spécifique.
Renvois
DataSourceSheet
: objet de données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeFilters(columnName)
Supprime tous les filtres appliqués à la colonne de la feuille de la source de données.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne dont vous souhaitez supprimer les filtres. |
Renvois
DataSourceSheet
: feuille de la source de données, pour le chaînage de méthodes.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeSortSpec(columnName)
Supprime la spécification de tri sur une colonne de la feuille de la source de données.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne. |
Renvois
DataSourceSheet
: feuille de la source de données, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnName, width)
Définit la largeur de la colonne spécifiée.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne. |
width | Integer | Nouvelle largeur de la colonne. |
Renvois
DataSourceSheet
: feuille de source de données, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(columnNames, width)
Définit la largeur des colonnes spécifiées.
Paramètres
Nom | Type | Description |
---|---|---|
columnNames | String[] | Liste des noms de colonnes à mettre à jour. |
width | Integer | Nouvelle largeur des colonnes. |
Renvois
DataSourceSheet
: feuille de source de données, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSortSpec(columnName, ascending)
Définit les spécifications de tri sur une colonne de la feuille de la source de données.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne à trier. |
ascending | Boolean | Si la valeur est true , triez la colonne par ordre croissant. Si false , triez la colonne par ordre décroissant. |
Renvois
DataSourceSheet
: feuille de la source de données, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSortSpec(columnName, sortOrder)
Définit les spécifications de tri sur une colonne de la feuille de la source de données.
Paramètres
Nom | Type | Description |
---|---|---|
columnName | String | Nom de la colonne à trier. |
sortOrder | SortOrder | Ordre de tri. |
Renvois
DataSourceSheet
: feuille de la source de données, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Attend la fin de l'exécution en cours. Elle expire après le nombre de secondes indiqué. Elle génère une exception si l'exécution n'est pas terminée après expiration du délai, mais n'annule pas l'exécution des données.
Paramètres
Nom | Type | Description |
---|---|---|
timeoutInSeconds | Integer | Délai d'attente de l'exécution des données, en secondes. La valeur maximale est de 300 secondes. |
Renvois
DataExecutionStatus
: état d'exécution des données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets