- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- İstek
- 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 (GüncellenenNesneBorderRequest)
- 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ığıyla ilgili bilgi veren replies
bulunur. Yanıtlar, istekleri yansıtır. Örneğin, 4 güncelleme uyguladıysanız ve 3. güncellemeye yanıt verdiyse, sırasıyla 2 boş yanıt, asıl yanıt ve boş bir başka yanıt olacaktır.
E-tabloların ortak çalışmaya dayalı yapısı nedeniyle, bu işlem tamamlandıktan sonra e-tablonun değişikliklerinizi tam olarak yansıtacağı garanti edilmez, ancak istekteki güncellemelerin birlikte atomik olarak uygulanacağı garanti edilir. Yaptığınız değişiklikler, ortak çalışan değişikliklerine bağlı olarak değişebilir. 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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{
"requests": [
{
object ( |
Alanlar | |
---|---|
requests[] |
E-tabloya uygulanacak güncellemelerin listesi. İstekler belirtildikleri sıraya göre uygulanır. Geçerli olmayan istekler uygulanmaz. |
includeSpreadsheetInResponse |
Güncelleme yanıtının e-tablo kaynağını içerip içermeyeceğ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 alır. Yalnızca |
Yanıt gövdesi
E-tablonun toplu güncelleme 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 işlem, güncellemelerle bire bir eşler 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ılavuzu'na bakın.