- Permintaan HTTP
- Parameter jalur
- 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 |
Cara data input harus ditafsirkan. |
data[] |
Nilai baru untuk diterapkan ke spreadsheet. Jika lebih dari satu rentang cocok 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. Ini diabaikan jika |
Isi respons
Respons ketika 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 yang menerapkan pembaruan tersebut. |
totalUpdatedRows |
Jumlah total baris yang memperbarui setidaknya satu sel di baris. |
totalUpdatedColumns |
Jumlah total kolom ketika setidaknya satu sel di kolom diperbarui. |
totalUpdatedCells |
Jumlah total sel yang diperbarui. |
totalUpdatedSheets |
Jumlah total sheet yang telah diperbarui setidaknya satu sel di sheet. |
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 mengetahui 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 di spreadsheet. |
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 ditulis, nilai yang ada dalam rentang yang cocok tetap tidak terpengaruh. |
UpdateValuesByDataFilterResponse
Respons ketika memperbarui rentang nilai dengan filter data di 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 yang memiliki setidaknya satu sel di baris yang diperbarui. |
updatedColumns |
Jumlah kolom yang memiliki setidaknya satu sel di kolom yang diperbarui. |
updatedCells |
Jumlah sel yang diperbarui. |
dataFilter |
Filter data yang memilih rentang yang telah diperbarui. |
updatedData |
Nilai sel dalam rentang yang cocok dengan dataFilter setelah semua pembaruan diterapkan. Ini hanya disertakan jika kolom |