- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Richiedi
- 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
- Risposta
- 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
- Prova!
Applica uno o più aggiornamenti al foglio di lavoro.
Ogni request
viene convalidato prima dell'applicazione. Se una qualsiasi richiesta non è valida, l'intera richiesta avrà esito negativo e non verrà applicato nulla.
Alcune richieste hanno replies
per fornirti alcune informazioni su come vengono applicate. Le risposte rispecchieranno le richieste. Ad esempio, se hai applicato quattro aggiornamenti e il terzo ha ricevuto una risposta, la risposta avrà 2 risposte vuote, la risposta effettiva e un'altra risposta vuota, in questo ordine.
A causa della natura collaborativa dei fogli di lavoro, non è garantito che il foglio di lavoro rispecchi esattamente le modifiche una volta completata l'operazione, ma è garantito che gli aggiornamenti nella richiesta vengano applicati congiuntamente in modo atomico. Le tue modifiche potrebbero essere alterate rispetto a quelle dei collaboratori. Se non ci sono collaboratori, le modifiche dovrebbero essere presenti nel foglio di lavoro.
Richiesta HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
spreadsheetId |
Il foglio di lavoro a cui applicare gli aggiornamenti. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"requests": [
{
object ( |
Campi | |
---|---|
requests[] |
Un elenco di aggiornamenti da applicare al foglio di lavoro. Le richieste verranno applicate nell'ordine in cui sono specificate. Se una qualsiasi richiesta non è valida, non verrà applicata alcuna richiesta. |
includeSpreadsheetInResponse |
Determina se la risposta all'aggiornamento deve includere la risorsa del foglio di lavoro. |
responseRanges[] |
Limita gli intervalli inclusi nel foglio di lavoro delle risposte. Significato solo se |
responseIncludeGridData |
True se devono essere restituiti i dati della griglia. Significato solo se |
Corpo della risposta
La risposta per l'aggiornamento collettivo di un foglio di lavoro.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Campi | |
---|---|
spreadsheetId |
Il foglio di lavoro a cui sono stati applicati gli aggiornamenti. |
replies[] |
La risposta degli aggiornamenti. Questa mappa mappa 1:1 con gli aggiornamenti, anche se le risposte ad alcune richieste potrebbero essere vuote. |
updatedSpreadsheet |
Il foglio di lavoro dopo l'applicazione degli aggiornamenti. Viene impostato solo se |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Per ulteriori informazioni, consulta la Guida all'autorizzazione.