- 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 untuk diterapkan ke spreadsheet. Jika lebih dari satu rentang dicocokkan dengan |
includeValuesInResponse |
Menentukan apakah respons update harus menyertakan nilai sel yang diperbarui. 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 respons seharusnya dirender. Pesan ini 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 setidaknya satu sel di baris telah diperbarui. |
totalUpdatedColumns |
Jumlah total kolom dengan setidaknya satu sel di kolom telah diperbarui. |
totalUpdatedCells |
Jumlah total sel yang diperbarui. |
totalUpdatedSheets |
Jumlah total sheet dengan setidaknya satu sel dalam sheet telah 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 spreadsheet. |
majorDimension |
Dimensi utama dari 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 lebih kecil dari rentang yang cocok, hanya nilai yang ditentukan yang 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 pembaruan diterapkan. |
updatedRows |
Jumlah baris dengan setidaknya satu sel di baris telah diperbarui. |
updatedColumns |
Jumlah kolom dengan setidaknya satu sel di kolom 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. Kolom ini hanya disertakan jika kolom |