- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Cobalah!
Menetapkan nilai dalam satu atau beberapa rentang spreadsheet. Pemanggil harus menentukan ID spreadsheet, valueInputOption
, dan satu atau beberapa DataFilterValueRanges
.
Permintaan HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
spreadsheetId |
ID spreadsheet yang akan diperbarui. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "valueInputOption": enum ( |
Kolom | |
---|---|
valueInputOption |
Bagaimana data input harus ditafsirkan. |
data[] |
Nilai baru yang akan diterapkan ke spreadsheet. Jika lebih dari satu rentang dicocokkan dengan |
includeValuesInResponse |
Menentukan apakah respons update harus menyertakan nilai sel yang diupdate. Secara default, respons tidak menyertakan nilai yang diperbarui. Kolom |
responseValueRenderOption |
Menentukan bagaimana nilai dalam respons harus dirender. Opsi render default adalah |
responseDateTimeRenderOption |
Menentukan bagaimana tanggal, waktu, dan durasi dalam respons harus dirender. Nilai ini akan diabaikan jika |
Isi respons
Respons saat memperbarui rentang nilai dalam spreadsheet.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Kolom | |
---|---|
spreadsheetId |
Spreadsheet tempat pembaruan diterapkan. |
totalUpdatedRows |
Jumlah total baris dengan minimal satu sel dalam baris yang diperbarui. |
totalUpdatedColumns |
Jumlah total kolom dengan minimal satu sel dalam kolom yang telah diperbarui. |
totalUpdatedCells |
Jumlah total sel yang diperbarui. |
totalUpdatedSheets |
Jumlah total sheet dengan setidaknya satu sel dalam sheet yang diperbarui. |
responses[] |
Respons untuk setiap rentang diperbarui. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Untuk informasi selengkapnya, lihat Panduan otorisasi.
DataFilterValueRange
Rentang nilai yang lokasinya ditentukan oleh DataFilter
.
Representasi JSON |
---|
{ "dataFilter": { object ( |
Kolom | |
---|---|
dataFilter |
Filter data yang menjelaskan lokasi nilai dalam {i>spreadsheet<i}. |
majorDimension |
Dimensi utama nilai. |
values[] |
Data yang akan ditulis. Jika nilai yang diberikan melebihi salah satu rentang yang cocok dengan filter data, permintaan akan gagal. Jika nilai yang diberikan kurang dari rentang yang cocok, hanya nilai yang ditentukan yang akan ditulis, nilai yang ada dalam rentang yang cocok tetap tidak terpengaruh. |
UpdateValuesByDataFilterResponse
Respons saat memperbarui rentang nilai dengan filter data dalam spreadsheet.
Representasi JSON |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Kolom | |
---|---|
updatedRange |
Rentang (dalam notasi A1) tempat update diterapkan. |
updatedRows |
Jumlah baris dengan setidaknya satu sel dalam baris yang diperbarui. |
updatedColumns |
Jumlah kolom dengan setidaknya satu sel dalam kolom yang telah diperbarui. |
updatedCells |
Jumlah sel yang diperbarui. |
dataFilter |
Filter data yang memilih rentang yang diperbarui. |
updatedData |
Nilai sel dalam rentang yang cocok dengan dataFilter setelah semua pembaruan diterapkan. Nilai ini hanya disertakan jika kolom |