Sheet
Sheet dalam spreadsheet.
Representasi JSON |
---|
{ "properties": { object ( |
Kolom | |
---|---|
properties
|
Properti sheet. |
data[]
|
Data dalam petak, jika ini adalah sheet petak.
Jumlah objek GridData yang ditampilkan bergantung pada jumlah rentang yang diminta pada sheet ini. Misalnya, jika ini merepresentasikan
Untuk sheet
|
merges[]
|
Rentang yang digabungkan. |
conditionalFormats[]
|
Aturan format bersyarat di sheet ini. |
filterViews[]
|
Tampilan filter di sheet ini. |
protectedRanges[]
|
Rentang yang dilindungi di sheet ini. |
basicFilter
|
Filter pada sheet ini, jika ada. |
charts[]
|
Spesifikasi setiap diagram di sheet ini. |
bandedRanges[]
|
Pita (warna alternatif) memiliki rentang pada sheet ini. |
developerMetadata[]
|
Metadata developer yang terkait dengan sheet. |
rowGroups[]
|
Semua grup baris di sheet ini, diurutkan berdasarkan peningkatan indeks awal rentang, kemudian berdasarkan kedalaman grup. |
columnGroups[]
|
Semua grup kolom di sheet ini, diurutkan menurut peningkatan indeks awal rentang, kemudian berdasarkan kedalaman grup. |
slicers[]
|
Pemotong pada sheet ini. |
SheetProperties
Properti sheet.
Representasi JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Kolom | |
---|---|
sheetId
|
ID sheet. Tidak boleh negatif. Kolom ini tidak dapat diubah setelah ditetapkan. |
title
|
Nama sheet. |
index
|
Indeks sheet dalam spreadsheet. Saat menambahkan atau memperbarui properti sheet, jika kolom ini dikecualikan, sheet tersebut akan ditambahkan atau dipindahkan ke akhir daftar sheet. Saat memperbarui indeks sheet atau memasukkan sheet, gerakan dianggap sebagai indeks "sebelum pemindahan". Misalnya, jika ada tiga sheet (S1, S2, S3) untuk memindahkan S1 ke depan S2, indeks harus ditetapkan ke 2. Permintaan pembaruan indeks sheet akan diabaikan jika indeks yang diminta sama dengan indeks sheet saat ini atau jika indeks baru yang diminta sama dengan indeks sheet saat ini + 1. |
sheetType
|
Jenis sheet. Default-nya adalah |
gridProperties
|
Properti tambahan sheet jika sheet ini berupa petak. (Jika sheetnya adalah sheet objek, yang berisi diagram atau gambar, kolom ini tidak akan ada.) Penetapan properti petak pada sheet non-grid adalah kesalahan.
Jika sheet ini adalah sheet
|
tabColor
|
Warna tab di UI. Tidak digunakan lagi: Gunakan
|
tabColorStyle
|
Warna tab di UI. Jika
|
rightToLeft
|
True jika sheet adalah sheet RTL, bukan sheet LTR. |
dataSourceSheetProperties
|
Hanya output. Jika ada, kolom ini berisi
|
Jenis Sheet
Jenis sheet.
Enumerasi | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Nilai default, jangan gunakan. |
GRID
|
Sheet berupa petak. |
OBJECT
|
Sheet tidak memiliki petak dan memiliki objek seperti diagram atau gambar. |
DATA_SOURCE
|
Sheet ini terhubung dengan
DataSource
eksternal dan menampilkan pratinjau data.
|
GridProperties
Properti petak.
Representasi JSON |
---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
Kolom | |
---|---|
rowCount
|
Jumlah baris dalam petak. |
columnCount
|
Jumlah kolom dalam petak. |
frozenRowCount
|
Jumlah baris yang dibekukan di petak. |
frozenColumnCount
|
Jumlah kolom yang dibekukan dalam petak. |
hideGridlines
|
Benar jika petak tidak menampilkan garis kisi di UI. |
rowGroupControlAfter
|
Benar jika tombol kontrol pengelompokan baris ditampilkan setelah grup. |
columnGroupControlAfter
|
Benar jika tombol kontrol pengelompokan kolom ditampilkan setelah grup. |
DataSourceSheetProperties
Properti tambahan sheet
DATA_SOURCE
.
Representasi JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Kolom | |
---|---|
dataSourceId
|
ID sheet
|
columns[]
|
Kolom yang ditampilkan di sheet, yang sesuai dengan nilai dalam
|
dataExecutionStatus
|
Status eksekusi data. |
DataPetak
Data dalam petak, serta metadata tentang dimensi.
Representasi JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Kolom | |
---|---|
startRow
|
Baris pertama yang dirujuk GridData ini, berbasis nol. |
startColumn
|
Kolom pertama yang dirujuk GridData ini, berbasis nol. |
rowData[]
|
Data dalam petak, satu entri per baris, dimulai dengan baris di startRow. Nilai di RowData akan sesuai dengan kolom yang dimulai dari
|
rowMetadata[]
|
Metadata tentang baris yang diminta di petak, dimulai dengan baris di
|
columnMetadata[]
|
Metadata tentang kolom yang diminta di petak, dimulai dengan kolom di |
DataBaris
Data tentang setiap sel dalam satu baris.
Representasi JSON |
---|
{
"values": [
{
object (
|
Kolom | |
---|---|
values[]
|
Nilai dalam baris, satu per kolom. |
DimensionProperties
Properti tentang dimensi.
Representasi JSON |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Kolom | |
---|---|
pixelSize
|
Tinggi (jika baris) atau lebar (jika kolom) dimensi dalam piksel. |
developerMetadata[]
|
Metadata developer yang terkait dengan satu baris atau kolom. |
dataSourceColumnReference
|
Hanya output. Jika ditetapkan, ini adalah kolom di sheet sumber data. |
Aturan Format
Aturan yang menjelaskan format bersyarat.
Representasi JSON |
---|
{ "ranges": [ { object ( |
Kolom | |
---|---|
ranges[]
|
Rentang yang diformat jika kondisinya benar. Semua rentang harus berada di petak yang sama. |
Kolom union rule . Aturan yang mengontrol format bersyarat ini, harus benar-benar ditetapkan.
rule
hanya dapat berupa salah satu dari berikut:
|
|
booleanRule
|
Formatnya "aktif" atau "nonaktif" sesuai dengan aturan. |
gradientRule
|
Formatnya akan bervariasi berdasarkan gradien pada aturan. |
Aturan Boolean
Aturan yang mungkin cocok atau tidak cocok, bergantung pada kondisi.
Representasi JSON |
---|
{ "condition": { object ( |
Kolom | |
---|---|
condition
|
Kondisi aturan. Jika kondisi bernilai true, format akan diterapkan. |
format
|
Format yang akan diterapkan. Format bersyarat hanya dapat menerapkan sebagian format:
|
GradientRule
Aturan yang menerapkan format skala warna gradien, berdasarkan titik interpolasi yang tercantum. Format sel akan bervariasi berdasarkan kontennya dibandingkan dengan nilai titik interpolasi.
Representasi JSON |
---|
{ "minpoint": { object ( |
Kolom | |
---|---|
minpoint
|
Titik interpolasi awal. |
midpoint
|
Titik interpolasi opsional di tengah jalan. |
maxpoint
|
Titik interpolasi akhir. |
Titik Interpolasi
Titik interpolasi tunggal pada format bersyarat gradien. Keduanya menyematkan skala warna gradien sesuai dengan warna, jenis, dan nilai yang dipilih.
Representasi JSON |
---|
{ "color": { object ( |
Kolom | |
---|---|
color
|
Warna yang diperlukan untuk titik interpolasi ini. Tidak digunakan lagi: Gunakan
|
colorStyle
|
Warna yang diperlukan untuk titik interpolasi ini. Jika
|
type
|
Cara menginterpretasikan nilai. |
value
|
Nilai yang digunakan titik interpolasi ini. Dapat berupa formula. Tidak digunakan jika
|
InterpolationPointType
Jenis titik interpolasi.
Enumerasi | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Nilai default, jangan gunakan. |
MIN
|
Titik interpolasi menggunakan nilai minimum dalam sel selama rentang format bersyarat. |
MAX
|
Titik interpolasi menggunakan nilai maksimum dalam sel selama rentang format bersyarat. |
NUMBER
|
Titik interpolasi menggunakan nilai yang tepat dalam
InterpolationPoint.value .
|
PERCENT
|
Titik interpolasi adalah persentase yang ditentukan terhadap semua sel dalam rentang format bersyarat. Ini setara dengan
|
PERCENTILE
|
Titik interpolasi adalah persentil yang ditentukan atas semua sel dalam rentang format bersyarat. Ini setara dengan
NUMBER
jika nilainya adalah:
=PERCENTILE(FLATTEN(range), value / 100)
(dengan error dalam rentang diabaikan saat perataan).
|
TampilanFilter
Tampilan filter.
Representasi JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Kolom | |
---|---|
filterViewId
|
ID tampilan filter. |
title
|
Nama tampilan filter. |
range
|
Rentang yang dicakup tampilan filter ini.
Saat menulis, hanya salah satu dari
|
namedRangeId
|
Rentang bernama yang didukung oleh tampilan filter ini, jika ada.
Saat menulis, hanya salah satu dari
|
sortSpecs[]
|
Tata urutan per kolom. Spesifikasi berikutnya digunakan jika nilai sama dengan spesifikasi sebelumnya. |
criteria
|
Kriteria untuk menampilkan/menyembunyikan nilai per kolom. Kunci peta adalah indeks kolom, dan nilainya adalah kriteria untuk kolom tersebut.
Kolom ini tidak digunakan lagi dan digantikan dengan
|
filterSpecs[]
|
Kriteria filter untuk menampilkan/menyembunyikan nilai per kolom.
Baik
|
Rentang Dilindungi
Rentang dilindungi.
Representasi JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
Kolom | |
---|---|
protectedRangeId
|
ID rentang dilindungi. Kolom ini bersifat hanya baca. |
range
|
Rentang yang dilindungi. Rentang tersebut mungkin tidak terikat sepenuhnya, sehingga dianggap sebagai sheet yang dilindungi.
Saat menulis, hanya salah satu dari
|
namedRangeId
|
Rentang bernama yang dilindungi oleh rentang ini didukung, jika ada.
Saat menulis, hanya salah satu dari
|
description
|
Deskripsi rentang yang dilindungi ini. |
warningOnly
|
Benar jika rentang yang dilindungi ini akan menampilkan peringatan saat mengedit. Perlindungan berbasis peringatan berarti bahwa setiap pengguna dapat mengedit data dalam rentang yang dilindungi, kecuali pengeditan akan menampilkan peringatan yang meminta pengguna untuk mengonfirmasi hasil edit tersebut.
Saat menulis: jika kolom ini benar, maka
|
requestingUserCanEdit
|
Berlaku jika pengguna yang meminta rentang yang dilindungi ini dapat mengedit area yang dilindungi. Kolom ini bersifat hanya baca. |
unprotectedRanges[]
|
Daftar rentang yang tidak dilindungi dalam sheet yang dilindungi. Rentang yang tidak dilindungi hanya didukung di sheet yang dilindungi. |
editors
|
Pengguna dan grup dengan akses edit ke rentang yang dilindungi. Kolom ini hanya dapat dilihat oleh pengguna yang memiliki akses edit ke rentang terlindungi dan dokumen. Editor tidak didukung dengan
perlindungan
|
Editor
Editor rentang yang dilindungi.
Representasi JSON |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
Kolom | |
---|---|
users[]
|
Alamat email pengguna yang memiliki akses edit ke rentang dilindungi. |
groups[]
|
Alamat email grup dengan akses edit ke rentang dilindungi. |
domainUsersCanEdit
|
Berlaku jika ada orang di domain dokumen yang memiliki akses edit ke rentang terlindungi. Perlindungan domain hanya didukung pada dokumen dalam domain. |
Filter Dasar
Filter default yang terkait dengan sheet.
Representasi JSON |
---|
{ "range": { object ( |
Kolom | |
---|---|
range
|
Rentang yang dicakup filter. |
sortSpecs[]
|
Tata urutan per kolom. Spesifikasi berikutnya digunakan jika nilai sama dengan spesifikasi sebelumnya. |
criteria
|
Kriteria untuk menampilkan/menyembunyikan nilai per kolom. Kunci peta adalah indeks kolom, dan nilainya adalah kriteria untuk kolom tersebut.
Kolom ini tidak digunakan lagi dan digantikan dengan
|
filterSpecs[]
|
Kriteria filter per kolom.
Baik
|
Rentang Band
Rentang band (warna alternatif) dalam sheet.
Representasi JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Kolom | |
---|---|
bandedRangeId
|
ID rentang band. |
range
|
Rentang tempat properti ini diterapkan. |
rowProperties
|
Properti untuk band baris. Properti ini diterapkan per baris di seluruh baris dalam rentang. Setidaknya salah satu dari
|
columnProperties
|
Properti untuk band kolom. Properti ini diterapkan berdasarkan kolom demi kolom di seluruh kolom dalam rentang. Setidaknya salah satu dari
|
BandingProperties
Properti yang merujuk ke dimensi tunggal (baik baris atau kolom). Jika
BandedRange.row_properties
dan
BandedRange.column_properties
ditetapkan, warna pengisi akan diterapkan ke sel sesuai dengan aturan berikut:
-
headerColor
danfooterColor
lebih diprioritaskan daripada warna pita. -
firstBandColor
lebih diprioritaskan daripadasecondBandColor
. -
rowProperties
lebih diprioritaskan daripadacolumnProperties
.
Misalnya, warna baris pertama lebih diprioritaskan daripada warna kolom pertama, tetapi warna kolom pertama lebih diprioritaskan daripada warna baris kedua. Demikian pula, header baris lebih diprioritaskan daripada header kolom di sel kiri atas, tetapi header kolom lebih diprioritaskan daripada warna baris pertama jika header baris tidak ditetapkan.
Representasi JSON |
---|
{ "headerColor": { object ( |
Kolom | |
---|---|
headerColor
|
Warna baris atau kolom pertama. Jika kolom ini ditetapkan, baris atau kolom pertama diisi dengan warna ini dan warna alternatif antara
|
headerColorStyle
|
Warna baris atau kolom pertama. Jika kolom ini ditetapkan, baris atau kolom pertama diisi dengan warna ini dan warna alternatif antara
|
firstBandColor
|
Warna pertama yang bergantian. (Wajib) Tidak digunakan lagi: Gunakan |
firstBandColorStyle
|
Warna pertama yang bergantian. (Wajib) Jika
|
secondBandColor
|
Warna kedua yang bergantian. (Wajib) Tidak digunakan lagi: Gunakan |
secondBandColorStyle
|
Warna kedua yang bergantian. (Wajib) Jika
|
footerColor
|
Warna baris atau kolom terakhir. Jika kolom ini tidak ditetapkan, baris atau kolom terakhir akan diisi dengan
|
footerColorStyle
|
Warna baris atau kolom terakhir. Jika kolom ini tidak ditetapkan, baris atau kolom terakhir akan diisi dengan
|
GrupDimensi
Grup pada interval baris atau kolom di sheet, yang dapat berisi atau dimuat dalam grup lain. Grup dapat diciutkan atau diperluas sebagai unit di sheet.
Representasi JSON |
---|
{
"range": {
object (
|
Kolom | |
---|---|
range
|
Rentang yang menjadi lokasi grup ini. |
depth
|
Kedalaman grup, yang mewakili jumlah grup yang memiliki rentang yang sepenuhnya berisi rentang grup ini. |
collapsed
|
Kolom ini bernilai true jika grup ini diciutkan. Grup yang diciutkan akan tetap diciutkan jika grup yang tumpang-tindih pada kedalaman yang lebih dangkal diperluas. Nilai benar tidak berarti bahwa semua dimensi dalam grup disembunyikan, karena visibilitas dimensi dapat berubah secara terpisah dari properti grup ini. Namun, ketika properti ini diperbarui, semua dimensi di dalamnya akan disetel ke tersembunyi jika kolom ini benar, atau disetel ke terlihat jika kolom ini salah. |
Pemotong
Pemotong dalam sheet.
Representasi JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Kolom | |
---|---|
slicerId
|
ID pemotong. |
spec
|
Spesifikasi pemotong. |
position
|
Posisi pemotong. Perhatikan bahwa pemotong hanya dapat diposisikan pada sheet yang ada. Selain itu, lebar dan tinggi pemotong dapat disesuaikan secara otomatis agar tidak melebihi batas yang diizinkan. |
SlicerSpec
Spesifikasi pemotong.
Representasi JSON |
---|
{ "dataRange": { object ( |
Kolom | |
---|---|
dataRange
|
Rentang data pemotong. |
filterCriteria
|
Kriteria pemfilteran pemotong. |
columnIndex
|
Indeks kolom berbasis nol pada tabel data tempat filter diterapkan. |
applyToPivotTables
|
True jika filter harus diterapkan pada tabel pivot. Jika tidak ditetapkan, setelan defaultnya adalah |
title
|
Judul pemotong. |
textFormat
|
Format teks judul di pemotong. Kolom link tidak didukung. |
backgroundColor
|
Warna latar belakang pemotong. Tidak digunakan lagi: Gunakan
|
backgroundColorStyle
|
Warna latar belakang pemotong. Jika
|
horizontalAlignment
|
Perataan horizontal judul di pemotong. Jika tidak ditentukan, setelan defaultnya adalah |