Sheet
Sheet dalam {i>spreadsheet<i}.
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 di sheet ini. Misalnya, jika ini mewakili
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 di sheet ini, jika ada. |
charts[]
|
Spesifikasi setiap diagram di sheet ini. |
bandedRanges[]
|
Rentang bergaris (warna bergantian) pada sheet ini. |
developerMetadata[]
|
Metadata developer yang terkait dengan sheet. |
rowGroups[]
|
Semua grup baris di sheet ini, diurutkan dengan menaikkan indeks awal rentang, lalu menurut kedalaman grup. |
columnGroups[]
|
Semua grup kolom pada sheet ini, diurutkan dengan meningkatkan indeks awal rentang, lalu berdasarkan kedalaman grup. |
slicers[]
|
Pemisah di sheet ini. |
SheetProperties
Properti sheet.
Representasi JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Kolom | |
---|---|
sheetId
|
ID sheet. Harus non-negatif. Kolom ini tidak dapat diubah setelah ditetapkan. |
title
|
Nama sheet. |
index
|
Indeks {i>sheet<i} dalam {i>spreadsheet<i}. Saat menambahkan atau memperbarui properti sheet, jika kolom ini dikecualikan, sheet akan ditambahkan atau dipindahkan ke akhir daftar sheet. Saat memperbarui indeks sheet atau menyisipkan sheet, pergerakan dipertimbangkan dalam indeks "sebelum pemindahan". Misalnya, jika ada tiga lembar (S1, S2, S3) untuk memindahkan S1 mendahului S2, indeks harus diatur ke 2. Permintaan pembaruan indeks sheet diabaikan jika indeks yang diminta identik 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 adalah petak. (Jika sheet adalah sheet objek, yang berisi diagram atau gambar, kolom ini tidak akan ada.) Saat menulis, menetapkan properti petak pada sheet non-petak akan menyebabkan error.
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 properti khusus sheet |
SheetType
Jenis sheet.
Enum | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Nilai default, jangan gunakan. |
GRID
|
Sheet adalah petak. |
OBJECT
|
Sheet tidak memiliki petak, tetapi memiliki objek seperti diagram atau gambar. |
DATA_SOURCE
|
Sheet terhubung dengan DataSource eksternal dan menampilkan pratinjau data.
|
GridProperties
Properti {i>grid<i}.
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 di petak. |
frozenRowCount
|
Jumlah baris yang dibekukan dalam petak. |
frozenColumnCount
|
Jumlah kolom yang dibekukan dalam petak. |
hideGridlines
|
Benar jika petak tidak menampilkan garis petak 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 |
columns[]
|
Kolom yang ditampilkan di sheet, sesuai dengan nilai di
|
dataExecutionStatus
|
Status eksekusi data. |
GridData
Data dalam petak, serta metadata tentang dimensi.
Representasi JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Kolom | |
---|---|
startRow
|
Baris pertama yang dirujuk oleh GridData ini, berbasis nol. |
startColumn
|
Kolom pertama yang dirujuk oleh GridData ini, berbasis nol. |
rowData[]
|
Data dalam petak, satu entri per baris, dimulai dengan baris di startRow. Nilai dalam RowData akan sesuai dengan kolom yang dimulai dari
|
rowMetadata[]
|
Metadata tentang baris yang diminta dalam petak, dimulai dengan baris di
|
columnMetadata[]
|
Metadata tentang kolom yang diminta di petak, dimulai dengan kolom di
|
RowData
Data tentang setiap sel dalam 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 berupa baris) atau lebar (jika kolom) dari 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. |
ConditionalFormatRule
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, hanya satu yang harus ditetapkan.
rule
hanya dapat berupa salah satu dari hal berikut:
|
|
booleanRule
|
Pemformatan "aktif" atau "nonaktif" sesuai dengan aturan. |
gradientRule
|
Formatnya akan bervariasi berdasarkan gradien dalam aturan. |
BooleanRule
Aturan yang mungkin cocok atau tidak, bergantung pada kondisinya.
Representasi JSON |
---|
{ "condition": { object ( |
Kolom | |
---|---|
condition
|
Kondisi aturan. Jika kondisi bernilai benar, format akan diterapkan. |
format
|
Format yang akan diterapkan. Format bersyarat hanya dapat menerapkan subset 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 tengah opsional. |
maxpoint
|
Titik interpolasi terakhir. |
InterpolationPoint
Satu titik interpolasi pada format bersyarat gradien. Ini menyematkan skala warna gradien sesuai dengan warna, jenis, dan nilai yang dipilih.
Representasi JSON |
---|
{ "color": { object ( |
Kolom | |
---|---|
color
|
Warna yang harus digunakan titik interpolasi ini. Tidak digunakan lagi: Gunakan
|
colorStyle
|
Warna yang harus digunakan titik interpolasi ini. Jika
|
type
|
Cara nilai harus ditafsirkan. |
value
|
Nilai yang digunakan titik interpolasi ini. Dapat berupa formula. Tidak digunakan jika
|
InterpolationPointType
Jenis titik interpolasi.
Enum | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Nilai default, jangan gunakan. |
MIN
|
Titik interpolasi menggunakan nilai minimum dalam sel di seluruh rentang format bersyarat. |
MAX
|
Titik interpolasi menggunakan nilai maksimum di sel selama rentang format bersyarat. |
NUMBER
|
Titik interpolasi menggunakan nilai yang sama persis dengan nilai di
InterpolationPoint.value .
|
PERCENT
|
Titik interpolasi adalah persentase yang diberikan di semua sel dalam rentang format bersyarat. Ini setara dengan
|
PERCENTILE
|
Titik interpolasi adalah persentil yang diberikan di semua sel dalam rentang format bersyarat. Ini setara dengan
NUMBER
jika nilainya adalah:
=PERCENTILE(FLATTEN(range), value / 100)
(dengan error dalam rentang diabaikan saat meratakan).
|
FilterView
Tampilan filter.
Representasi JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Kolom | |
---|---|
filterViewId
|
ID tampilan filter. |
title
|
Nama tampilan filter. |
range
|
Rentang yang dicakup oleh tampilan filter ini.
Saat menulis, hanya salah satu dari
|
namedRangeId
|
Rentang bernama yang mendukung tampilan filter ini, jika ada.
Saat menulis, hanya salah satu dari
|
sortSpecs[]
|
Urutan pengurutan per kolom. Spesifikasi berikutnya digunakan jika nilainya sama dalam 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 diganti dengan
|
filterSpecs[]
|
Kriteria filter untuk menampilkan/menyembunyikan nilai per kolom.
|
ProtectedRange
Rentang yang dilindungi.
Representasi JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
Kolom | |
---|---|
protectedRangeId
|
ID rentang dilindungi. Kolom ini bersifat hanya baca. |
range
|
Rentang yang dilindungi. Rentang mungkin tidak dibatasi sepenuhnya, dalam hal ini dianggap sebagai sheet yang dilindungi.
Saat menulis, hanya salah satu dari
|
namedRangeId
|
Rentang bernama yang mendukung rentang yang dilindungi ini, 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 setiap pengguna dapat mengedit data dalam rentang yang dilindungi, kecuali pengeditan akan memunculkan peringatan yang meminta pengguna untuk mengonfirmasi pengeditan.
Saat menulis: jika kolom ini bernilai benar, maka
|
requestingUserCanEdit
|
True jika pengguna yang meminta rentang dilindungi ini dapat mengedit kawasan lindung. 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 yang memiliki akses edit ke rentang dilindungi. Kolom ini hanya dapat dilihat oleh pengguna yang memiliki akses edit ke dokumen dan rentang yang dilindungi. Editor tidak didukung dengan perlindungan |
Editor
Editor rentang 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 yang memiliki akses edit ke rentang dilindungi. |
domainUsersCanEdit
|
True jika siapa pun dalam domain dokumen memiliki akses edit ke rentang dilindungi. Perlindungan domain hanya didukung pada dokumen dalam domain. |
BasicFilter
Filter default yang terkait dengan sheet.
Representasi JSON |
---|
{ "range": { object ( |
Kolom | |
---|---|
range
|
Rentang yang dicakup filter. |
sortSpecs[]
|
Urutan pengurutan per kolom. Spesifikasi berikutnya digunakan jika nilainya sama dalam 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 diganti dengan
|
filterSpecs[]
|
Kriteria filter per kolom.
Baik
|
BandedRange
Rentang bergaris (warna bergantian) dalam sheet.
Representasi JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Kolom | |
---|---|
bandedRangeId
|
ID rentang berband. |
range
|
Rentang tempat properti ini diterapkan. |
rowProperties
|
Properti untuk band baris. Properti ini diterapkan baris demi baris pada semua baris dalam rentang tersebut. Setidaknya salah satu dari
|
columnProperties
|
Properti untuk band kolom. Properti ini diterapkan berdasarkan kolom di seluruh kolom dalam rentang. Setidaknya salah satu dari
|
BandingProperties
Properti yang merujuk ke satu dimensi (baris atau kolom). Jika
BandedRange.row_properties
dan
BandedRange.column_properties
ditetapkan, warna isian akan diterapkan ke sel sesuai dengan aturan berikut:
-
headerColor
danfooterColor
lebih diprioritaskan daripada warna band. -
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 akan diisi dengan warna ini dan warna akan berganti antara
|
headerColorStyle
|
Warna baris atau kolom pertama. Jika kolom ini ditetapkan, baris atau kolom pertama diisi dengan warna ini dan warna-warna tersebut akan bergantian antara
|
firstBandColor
|
Warna pertama yang berganti-ganti. (Wajib) Tidak digunakan lagi: Gunakan
|
firstBandColorStyle
|
Warna pertama yang berganti-ganti. (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
|
DimensionGroup
Grup di atas interval baris atau kolom pada sheet, yang dapat berisi atau berada dalam grup lain. Grup dapat diciutkan atau diluaskan sebagai satu unit di sheet.
Representasi JSON |
---|
{
"range": {
object ( |
Kolom | |
---|---|
range
|
Rentang tempat grup ini berada. |
depth
|
Kedalaman grup, yang menunjukkan jumlah grup yang memiliki rentang yang sepenuhnya berisi rentang grup ini. |
collapsed
|
Kolom ini bernilai benar jika grup ini diciutkan. Grup yang diciutkan tetap diciutkan jika kelompok yang tumpang-tindih pada kedalaman yang lebih dangkal diperluas. Nilai benar tidak menyiratkan bahwa semua dimensi dalam grup disembunyikan, karena visibilitas dimensi dapat berubah secara independen dari properti grup ini. Namun, saat 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 pemisah. |
spec
|
Spesifikasi slicer. |
position
|
Posisi pemisah. Perhatikan bahwa pemisah hanya dapat diposisikan di sheet yang ada. Selain itu, lebar dan tinggi pemisah dapat disesuaikan secara otomatis agar tetap dalam batas yang diizinkan. |
SlicerSpec
Spesifikasi slicer.
Representasi JSON |
---|
{ "dataRange": { object ( |
Kolom | |
---|---|
dataRange
|
Rentang data pemotong. |
filterCriteria
|
Kriteria pemfilteran pemisah. |
columnIndex
|
Indeks kolom berbasis nol dalam tabel data tempat filter diterapkan. |
applyToPivotTables
|
Benar jika filter harus diterapkan ke tabel pivot. Jika tidak disetel, defaultnya adalah
|
title
|
Judul pemisah. |
textFormat
|
Format teks judul di pemisah. Kolom link tidak didukung. |
backgroundColor
|
Warna latar belakang pemisah. Tidak digunakan lagi: Gunakan
|
backgroundColorStyle
|
Warna latar belakang pemisah. Jika |
horizontalAlignment
|
Perataan horizontal judul di pemisah. Jika tidak ditentukan, setelan defaultnya adalah
|