- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- İstek
- UpdateSheetsPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateBoyutPropertiesRequest
- DataSourceSheetBoyut Aralığı
- UpdateNamedRangeRequest
- Yinelenen Hücre İsteği
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- Otomatik Doldur İsteği
- SourceAndDestination
- CutYapıştırRequest
- YapıştırTür
- CopyRequestRequest
- Yapıştırma Yönü
- MergeHücresRequest
- Birleştirme Türü
- UnmergeCellsRequest
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- AppendcellsRequest
- ClearTemelFiltre İsteği
- DeleteBoyut İsteği
- DeleteEmbeddedObjectRequest
- DeleteFilterViewRequest
- DuplicateFilterViewRequest
- DuplicateSheetRequest
- FindReplaceRequest
- InsertBoyutRequest
- InsertRangeRequest
- MoveBoyutİstek
- YerleşikNesneKonumKonumunu Güncelleme
- YapıştırDataRequest
- TextToColumnRequest
- SınırlayıcıTürü
- UpdateFilterViewRequest
- DeleteRangeRequest
- Ek Boyut İsteği
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- Sıralama Aralığı İsteği
- SetDataVerifyationRequest
- SetCoreFiltreRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoYeniden Boyutlandırma İsteği
- AddChartRequest
- UpdateChartSpecRequest
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDevelopermetadataRequest
- UpdateDevelopermetadataRequest
- DeleteDevelopermetadataRequest
- RandomizeRangeRequest
- AddBoyutGroupRequest
- DeleteBoyutGrupİsteği
- UpdateBoyutGroupRequest
- TrimWhitespaceRequest
- DeleteDuplicatesRequest
- EmbeddedObjectBorderRequest bilgilerini güncelleme
- AddSlicerRequest
- UpdateSlicerSpecRequest
- AddDataSourceRequest
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- Yanıt
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplicateFilterViewResponse
- YinelenenSayfaYanıt
- FindReplaceResponse
- YerleşikNesneKonumuYanıtını Güncelleme
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDevelopermetadataResponse
- UpdateDevelopermetadataResponse
- DeleteDevelopermetadataResponse
- AddBoyutGroupResponse
- DeleteBoyutGroupYanıt
- TrimWhitespaceResponse
- DeleteDuplicatesResponse
- AddSlicerResponse
- AddDataSourceResponse
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- 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 veren replies
bulunur. Yanıtlar istekleri yansıtacak. Örneğin, 4 güncelleme uyguladıysanız ve 3. yanıta yanıt verildiyse yanıtta 2 boş yanıt, gerçek yanıt ve bu sırada başka bir boş yanıt olur.
E-tabloların ortak çalışmaya dayalı olması nedeniyle, e-tablonun bu işlem tamamlandıktan sonra yaptığınız değişiklikleri tam olarak yansıtacağı garanti edilmez, ancak istekteki güncellemelerin atom olarak birlikte uygulanacağı garanti edilir. Yaptığınız değişiklikler, ortak çalışan tarafından yapılan değişikliklere bağlı olarak değiştirilebilir. Ortak çalışan yoksa değişikliklerinizi e-tabloda yansıtmanız gerekir.
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 veriler içerir:
JSON gösterimi |
---|
{
"requests": [
{
object ( |
Alanlar | |
---|---|
requests[] |
E-tabloya uygulanacak güncellemelerin listesi. İstekler, belirtildiği 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-tablosunda yer alan aralıkları sınırlar. Yalnızca |
responseIncludeGridData |
Tablo verileri döndürülmesi gerekiyorsa doğru değerini döndürür. Yalnızca |
Yanıt gövdesi
Bir e-tabloyu toplu güncellemenin 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üncellemeleri 1:1 olarak eşler ancak bazı isteklere yanıt verilmeyebilir. |
updatedSpreadsheet |
E-tablo, güncellemeler uygulandıktan sonra. Bu, 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ılavuzuna bakın.