- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Requête
- UpdateSpreadsheetPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutoFillRequest
- SourceAndDestination
- CutPasteRequest
- PasteType
- CopyPasteRequest
- PasteOrientation
- MergeCellsRequest
- MergeType
- UnmergeCellsRequest
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- AppendCellsRequest
- ClearBasicFilterRequest
- DeleteDimensionRequest
- DeleteEmbeddedObjectRequest
- DeleteFilterViewRequest
- DuplicateFilterViewRequest
- DuplicateSheetRequest
- FindReplaceRequest
- InsertDimensionRequest
- InsertRangeRequest
- MoveDimensionRequest
- UpdateEmbeddedObjectPositionRequest
- PasteDataRequest
- TextToColumnsRequest
- DelimiterType
- UpdateFilterViewRequest
- DeleteRangeRequest
- AppendDimensionRequest
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- SortRangeRequest
- SetDataValidationRequest
- SetBasicFilterRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoResizeDimensionsRequest
- AddChartRequest
- UpdateChartSpecRequest
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest
- DeleteDeveloperMetadataRequest
- RandomizeRangeRequest
- AddDimensionGroupRequest
- DeleteDimensionGroupRequest
- UpdateDimensionGroupRequest
- TrimWhitespaceRequest
- DeleteDuplicatesRequest
- UpdateEmbeddedObjectBorderRequest
- AddSlicerRequest
- UpdateSlicerSpecRequest
- AddDataSourceRequest
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- CancelDataSourceRefreshRequest
- Réponse
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplicateFilterViewResponse
- DuplicateSheetResponse
- FindReplaceResponse
- UpdateEmbeddedObjectPositionResponse
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse
- DeleteDeveloperMetadataResponse
- AddDimensionGroupResponse
- DeleteDimensionGroupResponse
- TrimWhitespaceResponse
- DeleteDuplicatesResponse
- AddSlicerResponse
- AddDataSourceResponse
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- CancelDataSourceRefreshResponse
- CancelDataSourceRefreshStatus
- RefreshCancellationStatus
- RefreshCancellationState
- RefreshCancellationErrorCode
- Essayer
Applique une ou plusieurs mises à jour à la feuille de calcul.
Chaque request
est validé avant d'être appliqué. Si une requête n'est pas valide, l'intégralité de la requête échoue et rien n'est appliqué.
Certaines requêtes comportent l'autorisation replies
pour vous fournir des informations sur leur application. Les réponses refléteront les requêtes. Par exemple, si vous avez appliqué quatre mises à jour et que la troisième a reçu une réponse, celle-ci contiendra deux réponses vides, la réponse réelle et une autre réponse vide, dans cet ordre.
En raison de la nature collaborative des feuilles de calcul, il n'est pas garanti que celles-ci reflèteront exactement vos modifications une fois l'opération terminée. Toutefois, il est garanti que les mises à jour de la demande seront appliquées ensemble de manière atomique. Les changements effectués par vos collaborateurs sont susceptibles d'être modifiés. En l'absence de collaborateurs, la feuille de calcul doit refléter vos modifications.
Requête HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
spreadsheetId |
Feuille de calcul à laquelle appliquer les mises à jour. |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"requests": [
{
object ( |
Champs | |
---|---|
requests[] |
Liste des mises à jour à appliquer à la feuille de calcul. Les requêtes sont appliquées dans l'ordre dans lequel elles sont spécifiées. Si une requête n'est pas valide, aucune requête n'est appliquée. |
includeSpreadsheetInResponse |
Détermine si la réponse de mise à jour doit inclure la ressource de feuille de calcul. |
responseRanges[] |
Limite les plages incluses dans la feuille de calcul de réponse. N'est pertinent que si la valeur de |
responseIncludeGridData |
"True" si les données de la grille doivent être renvoyées. N'est pertinent que si la valeur de |
Corps de la réponse
Réponse concernant la mise à jour groupée d'une feuille de calcul.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Champs | |
---|---|
spreadsheetId |
Feuille de calcul à laquelle les mises à jour ont été appliquées. |
replies[] |
Réponse des mises à jour. Ce mappage affiche les mises à jour de manière individuelle, bien que les réponses à certaines requêtes puissent être vides. |
updatedSpreadsheet |
Feuille de calcul après l'application des mises à jour. Il n'est défini que si |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Pour en savoir plus, consultez le guide relatif aux autorisations.