E-tablonun bir veya daha fazla aralığındaki değerleri ayarlar. Arayanın e-tablo kimliğini, valueInputOption
özelliğini ve bir veya daha fazla ValueRanges
belirtmesi gerekir.
HTTP isteği
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
spreadsheetId |
Güncellenecek e-tablonun kimliği. |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "valueInputOption": enum ( |
Alanlar | |
---|---|
valueInputOption |
Giriş verilerinin nasıl yorumlanması gerektiği. |
data[] |
E-tabloya uygulanacak yeni değerler. |
includeValuesInResponse |
Güncelleme yanıtının, güncellenen hücrelerin değerlerini içerip içermeyeceğini belirler. Varsayılan olarak, yanıtlar güncellenmiş değerleri içermez. Her bir |
responseValueRenderOption |
Yanıttaki değerlerin nasıl oluşturulması gerektiğini belirler. Varsayılan oluşturma seçeneği |
responseDateTimeRenderOption |
Yanıttaki tarihlerin, saatlerin ve sürelerin nasıl oluşturulması gerektiğini belirler. |
Yanıt gövdesi
Bir e-tabloda bir değer aralığını güncellerken verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Alanlar | |
---|---|
spreadsheetId |
Güncellemelerin uygulandığı e-tablo. |
totalUpdatedRows |
Satırdaki en az bir hücrenin güncellendiği toplam satır sayısı. |
totalUpdatedColumns |
Sütunda en az bir hücrenin güncellendiği sütunların toplam sayısı. |
totalUpdatedCells |
Güncellenen toplam hücre sayısı. |
totalUpdatedSheets |
En az bir hücrenin güncellendiği sayfaların toplam sayısı. |
responses[] |
İstenen aralık başına, isteklerin göründüğü sırada bir UpdateValuesResponse. |
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.