- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Solicitar
- UpdateSheetPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutoFillRequest
- SourceAndDestination
- CutPasteRequest
- Pegartipo
- CopyPasteRequest
- PegarOrientación
- MergeCellsRequest
- MergeType.
- UnmergeCellsRequest
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- AttachCellsRequest
- ClearBasicFilterRequest
- DeleteDimensionRequest
- DeleteEmbedObjectRequest
- DeleteFilterViewRequest
- DuplicateFilterViewRequest
- DuplicateSheetRequest
- FindReplaceRequest
- InsertDimensionRequest
- InsertRangeRequest
- MoveDimensionRequest
- UpdateEmbedObjectPositionRequest
- PasteDataRequest
- TextToColumnsRequest
- Tipo de límite
- UpdateFilterViewRequest
- DeleteRangeRequest
- AttachDimensionRequest
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- SortRangeRequest
- SetDataValidationRequest
- SetBasicFilterRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoResizeDimensionsRequest
- AddChartRequest
- UpdateChartSpecRequest
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest
- DeleteDeveloperMetadataRequest
- RandomizeRangeRequest
- AddDimensionGroupRequest
- DeleteDimensionGroupRequest
- UpdateDimensionGroupRequest
- TrimWhitespaceRequest
- DeleteDuplicatesRequest
- UpdateEmbedObjectBorderRequest
- AddSlicerRequest:
- UpdateSlicerSpecRequest
- AddDataSourceRequest
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- Respuesta
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplicateFilterViewResponse
- DuplicateSheetResponse
- FindReplaceResponse
- UpdateEmbedObjectPositionResponse
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse
- DeleteDeveloperMetadataResponse
- AddDimensionGroupResponse
- DeleteDimensionGroupResponse
- TrimWhitespaceResponse
- DeleteDuplicatesResponse
- AddSlicerResponse
- AddDataSourceResponse
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- Pruébala
Aplica una o más actualizaciones a la hoja de cálculo.
Cada request
se valida antes de aplicarse. Si alguna solicitud no es válida, fallará toda la solicitud y no se aplicará nada.
Algunas solicitudes tienen replies
para brindarte información sobre cómo se aplican. Las respuestas reflejarán las solicitudes. Por ejemplo, si aplicaste 4 actualizaciones y la tercera tiene una respuesta, la respuesta tendrá 2 respuestas vacías, la respuesta real y otra vacía, en ese orden.
Debido a la naturaleza colaborativa de las hojas de cálculo, no se garantiza que la hoja de cálculo reflejará exactamente los cambios una vez que se complete, pero sí se garantiza que las actualizaciones de la solicitud se aplicarán juntas de forma atómica. Es posible que se modifiquen tus cambios con respecto a los cambios de los colaboradores. Si no hay colaboradores, la hoja de cálculo debería reflejar los cambios.
Solicitud HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
spreadsheetId |
La hoja de cálculo a la que se aplicarán las actualizaciones |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"requests": [
{
object ( |
Campos | |
---|---|
requests[] |
Es una lista de actualizaciones que se pueden aplicar a la hoja de cálculo. Las solicitudes se aplicarán en el orden en que se especifican. Si alguna solicitud no es válida, no se aplicará ninguna. |
includeSpreadsheetInResponse |
Determina si la respuesta de actualización debe incluir el recurso de la hoja de cálculo. |
responseRanges[] |
Limita los rangos incluidos en la hoja de cálculo de respuestas. Es significativo solo si |
responseIncludeGridData |
Verdadero si se deben mostrar datos de la cuadrícula. Es significativo solo si |
Cuerpo de la respuesta
La respuesta de la actualización por lotes de una hoja de cálculo.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Campos | |
---|---|
spreadsheetId |
La hoja de cálculo a la que se aplicaron las actualizaciones |
replies[] |
Es la respuesta de las actualizaciones. Esto se asigna de forma individual con las actualizaciones, aunque las respuestas a algunas solicitudes pueden estar vacías. |
updatedSpreadsheet |
La hoja de cálculo después de aplicar las actualizaciones. Esto solo se establece si |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Para obtener más información, consulta la Guía de autorización.