- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- İstek gönder
- 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
- Yanıt
- 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
- Deneyin.
E-tabloya bir veya daha fazla güncelleme uygular.
Her request
uygulanmadan önce doğrulanır. Herhangi bir istek geçerli değilse isteğin tamamı başarısız olur ve hiçbir şey uygulanmaz.
Bazı isteklerde, nasıl uygulandıkları hakkında size bilgi vermesi için replies
izni bulunuyor. Yanıtlar, istekleri yansıtır. Örneğin, 4 güncelleme uyguladıysanız ve üçüncüsünde yanıt aldıysanız, bu sırayla ilgili yanıtta 2 boş yanıt gösterilir: asıl yanıt ve başka bir boş yanıt.
E-tabloların ortak çalışmaya dayalı yapısı nedeniyle, bu tamamlandıktan sonra e-tablonun değişikliklerinizi tam olarak yansıtacağı garanti edilmez, ancak istekteki güncellemelerin birlikte temel düzeyde uygulanacağı garanti edilir. Değişiklikleriniz, ortak çalışan değişikliklerine bağlı olarak değiştirilebilir. Ortak çalışan yoksa e-tablo, değişikliklerinizi yansıtmalıdır.
HTTP isteği
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
spreadsheetId |
Güncellemelerin uygulanacağı e-tablo. |
İstek içeriği
İstek gövdesi aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{
"requests": [
{
object ( |
Alanlar | |
---|---|
requests[] |
E-tabloya uygulanacak güncellemelerin listesi. İstekler belirtildikleri sırayla uygulanır. Geçerli olmayan isteklere hiçbir istek uygulanmaz. |
includeSpreadsheetInResponse |
Güncelleme yanıtının e-tablo kaynağını içerip içermediğini belirler. |
responseRanges[] |
Yanıt e-tablosuna dahil edilen aralıkları sınırlar. Yalnızca |
responseIncludeGridData |
Izgara verilerinin döndürülmesi gerekiyorsa doğru değerini döndürür. Yalnızca |
Yanıt gövdesi
Bir e-tablonun toplu güncellenmesine ilişkin yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Alanlar | |
---|---|
spreadsheetId |
Güncellemelerin uygulandığı e-tablo. |
replies[] |
Güncellemelerin yanıtı. Bu özet, güncellemelerle bire bir eşleşir ancak bazı isteklere verilen yanıtlar boş olabilir. |
updatedSpreadsheet |
Güncellemeler uygulandıktan sonraki e-tablo. Bu ayar yalnızca |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.