Sheets

Sheet

Sheet dalam spreadsheet.

Representasi JSON
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Kolom
properties

object (SheetProperties)

Properti sheet.

data[]

object (GridData)

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 merepresentasikan Sheet1, dan spreadsheet diminta dengan rentang Sheet1!A1:C10 dan Sheet1!D15:E20, maka GridData pertama akan memiliki startRow / startColumn dari 0, sedangkan yang kedua akan memiliki startRow 14 (baris berbasis nol 15), dan startColumn 3 (kolom berbasis nol D).

Untuk DATA_SOURCE sheet, Anda tidak dapat meminta rentang tertentu, GridData berisi semua nilai.

merges[]

object (GridRange)

Rentang yang digabungkan.

conditionalFormats[]

object (ConditionalFormatRule)

Aturan format bersyarat dalam sheet ini.

filterViews[]

object (FilterView)

Tampilan filter dalam sheet ini.

protectedRanges[]

object (ProtectedRange)

Rentang yang dilindungi dalam sheet ini.

basicFilter

object (BasicFilter)

Filter pada sheet ini, jika ada.

charts[]

object (EmbeddedChart)

Spesifikasi setiap diagram di sheet ini.

bandedRanges[]

object (BandedRange)

Rentang berjalur (warna alternatif) pada sheet ini.

developerMetadata[]

object (DeveloperMetadata)

Metadata developer yang terkait dengan sheet.

rowGroups[]

object (DimensionGroup)

Semua grup baris di sheet ini, diurutkan berdasarkan indeks awal rentang yang meningkat, lalu berdasarkan kedalaman grup.

columnGroups[]

object (DimensionGroup)

Semua grup kolom di sheet ini, diurutkan berdasarkan indeks awal rentang yang meningkat, lalu berdasarkan kedalaman grup.

slicers[]

object (Slicer)

Pengiris di sheet ini.

tables[]

object (Table)

Tabel di sheet ini.

SheetProperties

Properti sheet.

Representasi JSON
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Kolom
sheetId

integer

ID sheet. Tidak boleh negatif. Kolom ini tidak dapat diubah setelah ditetapkan.

title

string

Nama sheet.

index

integer

Indeks sheet dalam spreadsheet. 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 sheet (S1, S2, S3) untuk memindahkan S1 ke depan S2, indeks harus ditetapkan 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

enum (SheetType)

Jenis sheet. Nilai defaultnya adalah GRID. Kolom ini tidak dapat diubah setelah ditetapkan.

gridProperties

object (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, akan terjadi error jika Anda menetapkan properti petak pada sheet non-petak.

Jika sheet ini adalah sheet DATA_SOURCE, kolom ini hanya berupa output, tetapi berisi properti yang mencerminkan cara sheet sumber data dirender di UI, misalnya rowCount.

hidden

boolean

Benar jika sheet disembunyikan di UI, salah jika terlihat.

tabColor
(deprecated)

object (Color)

Warna tab di UI. Tidak digunakan lagi: Gunakan tabColorStyle.

tabColorStyle

object (ColorStyle)

Warna tab di UI. Jika tabColor juga ditetapkan, kolom ini akan diprioritaskan.

rightToLeft

boolean

Benar jika sheet adalah sheet RTL, bukan sheet LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Hanya output. Jika ada, kolom ini berisi DATA_SOURCE properti khusus sheet.

SheetType

Jenis sheet.

Enum
SHEET_TYPE_UNSPECIFIED Nilai default, jangan gunakan.
GRID Sheet adalah petak.
OBJECT Sheet tidak memiliki petak dan memiliki objek seperti diagram atau gambar.
DATA_SOURCE Sheet terhubung dengan DataSource 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

integer

Jumlah baris dalam petak.

columnCount

integer

Jumlah kolom dalam petak.

frozenRowCount

integer

Jumlah baris yang dibekukan dalam petak.

frozenColumnCount

integer

Jumlah kolom yang dibekukan dalam petak.

hideGridlines

boolean

Benar jika petak tidak menampilkan garis petak di UI.

rowGroupControlAfter

boolean

Benar (True) jika tombol kontrol pengelompokan baris ditampilkan setelah grup.

columnGroupControlAfter

boolean

Benar (True) jika tombol kontrol pengelompokan kolom ditampilkan setelah grup.

DataSourceSheetProperties

Properti tambahan lembar DATA_SOURCE.

Representasi JSON
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Kolom
dataSourceId

string

ID DataSource tempat sheet terhubung.

columns[]

object (DataSourceColumn)

Kolom yang ditampilkan di sheet, sesuai dengan nilai di RowData.

dataExecutionStatus

object (DataExecutionStatus)

Status eksekusi data.

GridData

Data dalam petak, serta metadata tentang dimensi.

Representasi JSON
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Kolom
startRow

integer

Baris pertama yang dirujuk GridData ini, berbasis nol.

startColumn

integer

Kolom pertama yang dirujuk GridData ini, berbasis nol.

rowData[]

object (RowData)

Data dalam petak, satu entri per baris, dimulai dengan baris di startRow. Nilai dalam RowData akan sesuai dengan kolom yang dimulai dari startColumn.

rowMetadata[]

object (DimensionProperties)

Metadata tentang baris yang diminta dalam petak, dimulai dengan baris di startRow.

columnMetadata[]

object (DimensionProperties)

Metadata tentang kolom yang diminta dalam petak, dimulai dengan kolom di startColumn.

RowData

Data tentang setiap sel dalam baris.

Representasi JSON
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Kolom
values[]

object (CellData)

Nilai dalam baris, satu per kolom.

DimensionProperties

Properti tentang dimensi.

Representasi JSON
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Kolom
hiddenByFilter

boolean

Benar jika dimensi ini sedang difilter. Kolom ini bersifat hanya baca.

hiddenByUser

boolean

Benar jika dimensi ini disembunyikan secara eksplisit.

pixelSize

integer

Tinggi (jika baris) atau lebar (jika kolom) dimensi dalam piksel.

developerMetadata[]

object (DeveloperMetadata)

Metadata developer yang terkait dengan satu baris atau kolom.

dataSourceColumnReference

object (DataSourceColumnReference)

Hanya output. Jika disetel, ini adalah kolom di sheet sumber data.

ConditionalFormatRule

Aturan yang menjelaskan format bersyarat.

Representasi JSON
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Kolom
ranges[]

object (GridRange)

Rentang yang diformat jika kondisinya benar. Semua rentang harus berada di petak yang sama.

Kolom gabungan rule. Aturan yang mengontrol format bersyarat ini, tepatnya satu yang harus ditetapkan. rule hanya dapat berupa salah satu dari berikut:
booleanRule

object (BooleanRule)

Pemformatan "aktif" atau "nonaktif" sesuai dengan aturan.

gradientRule

object (GradientRule)

Pemformatan akan bervariasi berdasarkan gradien dalam aturan.

BooleanRule

Aturan yang mungkin cocok atau tidak, bergantung pada kondisinya.

Representasi JSON
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Kolom
condition

object (BooleanCondition)

Kondisi aturan. Jika kondisi bernilai benar, format akan diterapkan.

format

object (CellFormat)

Format yang akan diterapkan. Pemformatan bersyarat hanya dapat menerapkan subset pemformatan: bold, italic, strikethrough, foreground color dan, background color.

GradientRule

Aturan yang menerapkan format skala warna gradien, berdasarkan titik interpolasi yang tercantum. Format sel akan bervariasi berdasarkan isinya dibandingkan dengan nilai titik interpolasi.

Representasi JSON
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Kolom
minpoint

object (InterpolationPoint)

Titik interpolasi awal.

midpoint

object (InterpolationPoint)

Titik interpolasi di tengah opsional.

maxpoint

object (InterpolationPoint)

Titik interpolasi akhir.

InterpolationPoint

Satu titik interpolasi pada format bersyarat gradien. Pin ini menyematkan skala warna gradien sesuai dengan warna, jenis, dan nilai yang dipilih.

Representasi JSON
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Kolom
color
(deprecated)

object (Color)

Warna yang harus digunakan titik interpolasi ini. Tidak digunakan lagi: Gunakan colorStyle.

colorStyle

object (ColorStyle)

Warna yang harus digunakan titik interpolasi ini. Jika color juga ditetapkan, kolom ini akan diprioritaskan.

type

enum (InterpolationPointType)

Cara nilai harus ditafsirkan.

value

string

Nilai yang digunakan titik interpolasi ini. Dapat berupa formula. Tidak digunakan jika type adalah MIN atau MAX.

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 dalam sel di seluruh rentang format bersyarat.
NUMBER Titik interpolasi menggunakan nilai yang sama persis di InterpolationPoint.value.
PERCENT

Titik interpolasi adalah persentase yang diberikan di semua sel dalam rentang format bersyarat. Ini setara dengan NUMBER jika nilainya adalah: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (dengan error dalam rentang diabaikan saat meratakan).

PERCENTILE Titik interpolasi adalah persentil tertentu 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. Untuk mengetahui informasi selengkapnya, lihat Mengelola visibilitas data dengan filter.

Representasi JSON
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Kolom
filterViewId

integer

ID tampilan filter.

title

string

Nama tampilan filter.

range

object (GridRange)

Rentang yang dicakup oleh tampilan filter ini.

Saat menulis, hanya satu dari range, namedRangeId, atau tableId yang dapat ditetapkan.

namedRangeId

string

Rentang bernama yang mendukung tampilan filter ini, jika ada.

Saat menulis, hanya satu dari range, namedRangeId, atau tableId yang dapat ditetapkan.

tableId

string

Tabel yang mendukung tampilan filter ini, jika ada.

Saat menulis, hanya satu dari range, namedRangeId, atau tableId yang dapat ditetapkan.

sortSpecs[]

object (SortSpec)

Urutan pengurutan per kolom. Spesifikasi selanjutnya digunakan jika nilai sama dalam spesifikasi sebelumnya.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

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.

filterSpecs[]

object (FilterSpec)

Kriteria filter untuk menampilkan atau menyembunyikan nilai per kolom.

Baik criteria maupun filterSpecs diisi dalam respons. Jika kedua kolom ditentukan dalam permintaan update, kolom ini akan diprioritaskan.

ProtectedRange

Rentang dilindungi.

Representasi JSON
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Kolom
protectedRangeId

integer

ID rentang yang dilindungi. Kolom ini bersifat hanya baca.

range

object (GridRange)

Rentang yang dilindungi. Rentang dapat sepenuhnya tidak terikat, yang dalam hal ini dianggap sebagai sheet yang dilindungi.

Saat menulis, hanya salah satu dari range atau namedRangeId atau tableId yang dapat ditetapkan.

namedRangeId

string

Rentang bernama yang mendukung rentang terlindungi ini, jika ada.

Saat menulis, hanya salah satu dari range atau namedRangeId atau tableId yang dapat ditetapkan.

tableId

string

Tabel yang mendukung rentang yang dilindungi ini, jika ada.

Saat menulis, hanya salah satu dari range atau namedRangeId atau tableId yang dapat ditetapkan.

description

string

Deskripsi rentang yang dilindungi ini.

warningOnly

boolean

Benar (True) jika rentang yang dilindungi ini akan menampilkan peringatan saat diedit. 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 benar, maka editors akan diabaikan. Selain itu, jika kolom ini diubah dari benar (true) menjadi salah (false) dan kolom editors tidak disetel (atau tidak disertakan dalam mask kolom), maka editor akan disetel ke semua editor dalam dokumen.

requestingUserCanEdit

boolean

Benar (True) jika pengguna yang meminta rentang terlindungi ini dapat mengedit area terlindungi. Kolom ini bersifat hanya baca.

unprotectedRanges[]

object (GridRange)

Daftar rentang yang tidak dilindungi dalam sheet yang dilindungi. Rentang yang tidak dilindungi hanya didukung di sheet yang dilindungi.

editors

object (Editors)

Pengguna dan grup dengan akses edit ke rentang yang dilindungi. Kolom ini hanya dapat dilihat oleh pengguna dengan akses edit ke rentang yang dilindungi dan dokumen. Editor tidak didukung dengan perlindungan warningOnly.

Editor

Editor rentang dilindungi.

Representasi JSON
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Kolom
users[]

string

Alamat email pengguna dengan akses edit ke rentang yang dilindungi.

groups[]

string

Alamat email grup dengan akses edit ke rentang terlindungi.

domainUsersCanEdit

boolean

Benar jika siapa pun di domain dokumen memiliki akses edit ke rentang yang dilindungi. Perlindungan domain hanya didukung pada dokumen dalam domain.

BasicFilter

Filter default yang terkait dengan sheet. Untuk mengetahui informasi selengkapnya, lihat Mengelola visibilitas data dengan filter.

Representasi JSON
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Kolom
range

object (GridRange)

Rentang yang dicakup filter.

tableId

string

Tabel yang mendukung filter ini, jika ada. Saat menulis, hanya salah satu dari range atau tableId yang dapat ditetapkan.

sortSpecs[]

object (SortSpec)

Urutan pengurutan per kolom. Spesifikasi selanjutnya digunakan jika nilai sama dalam spesifikasi sebelumnya.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

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.

filterSpecs[]

object (FilterSpec)

Kriteria filter per kolom.

Baik criteria maupun filterSpecs diisi dalam respons. Jika kedua kolom ditentukan dalam permintaan update, kolom ini akan diprioritaskan.

BandedRange

Rentang berjalur (warna alternatif) dalam sheet.

Representasi JSON
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Kolom
bandedRangeId

integer

ID rentang berband. Jika tidak disetel, lihat bandedRangeReference.

bandedRangeReference

string

Hanya output. Referensi rentang berjalur, digunakan untuk mengidentifikasi ID yang tidak didukung oleh bandedRangeId.

range

object (GridRange)

Rentang tempat properti ini diterapkan.

rowProperties

object (BandingProperties)

Properti untuk rentang baris. Properti ini diterapkan baris demi baris di seluruh baris dalam rentang. Setidaknya salah satu dari rowProperties atau columnProperties harus ditentukan.

columnProperties

object (BandingProperties)

Properti untuk rentang kolom. Properti ini diterapkan berdasarkan kolom demi kolom di seluruh kolom dalam rentang. Setidaknya salah satu dari rowProperties atau columnProperties harus ditentukan.

BandingProperties

Properti yang merujuk satu dimensi (baris atau kolom). Jika BandedRange.row_properties dan BandedRange.column_properties ditetapkan, warna pengisi diterapkan ke sel sesuai dengan aturan berikut:

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 (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Kolom
headerColor
(deprecated)

object (Color)

Warna baris atau kolom pertama. Jika kolom ini ditetapkan, baris atau kolom pertama akan diisi dengan warna ini dan warna akan bergantian antara firstBandColor dan secondBandColor mulai dari baris atau kolom kedua. Jika tidak, baris atau kolom pertama akan diisi dengan firstBandColor dan warna akan bergantian seperti biasanya. Tidak digunakan lagi: Gunakan headerColorStyle.

headerColorStyle

object (ColorStyle)

Warna baris atau kolom pertama. Jika kolom ini ditetapkan, baris atau kolom pertama akan diisi dengan warna ini dan warna akan bergantian antara firstBandColor dan secondBandColor mulai dari baris atau kolom kedua. Jika tidak, baris atau kolom pertama akan diisi dengan firstBandColor dan warna akan bergantian seperti biasanya. Jika headerColor juga ditetapkan, kolom ini akan diprioritaskan.

firstBandColor
(deprecated)

object (Color)

Warna pertama yang bergantian. (Wajib) Tidak digunakan lagi: Gunakan firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Warna pertama yang bergantian. (Wajib) Jika firstBandColor juga ditetapkan, kolom ini akan diprioritaskan.

secondBandColor
(deprecated)

object (Color)

Warna kedua yang bergantian. (Wajib) Tidak digunakan lagi: Gunakan secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Warna kedua yang bergantian. (Wajib) Jika secondBandColor juga ditetapkan, kolom ini akan diprioritaskan.

footerColor
(deprecated)

object (Color)

Warna baris atau kolom terakhir. Jika kolom ini tidak disetel, baris atau kolom terakhir akan diisi dengan firstBandColor atau secondBandColor, bergantung pada warna baris atau kolom sebelumnya. Tidak digunakan lagi: Gunakan footerColorStyle.

footerColorStyle

object (ColorStyle)

Warna baris atau kolom terakhir. Jika kolom ini tidak disetel, baris atau kolom terakhir akan diisi dengan firstBandColor atau secondBandColor, bergantung pada warna baris atau kolom sebelumnya. Jika footerColor juga ditetapkan, kolom ini akan diprioritaskan.

DimensionGroup

Grup di atas interval baris atau kolom pada sheet, yang dapat berisi atau berada dalam grup lain. Grup dapat diciutkan atau diperluas sebagai satu unit di sheet.

Representasi JSON
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Kolom
range

object (DimensionRange)

Rentang waktu keberadaan grup ini.

depth

integer

Kedalaman grup, yang menunjukkan jumlah grup yang memiliki rentang yang sepenuhnya berisi rentang grup ini.

collapsed

boolean

Kolom ini bernilai benar (true) jika grup ini diciutkan. Grup yang diciutkan akan tetap diciutkan jika grup yang tumpang-tindih pada kedalaman yang lebih dangkal diluaskan.

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.

Pengiris

Pengiris dalam sheet.

Representasi JSON
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Kolom
slicerId

integer

ID pengiris.

spec

object (SlicerSpec)

Spesifikasi pengiris.

position

object (EmbeddedObjectPosition)

Posisi pengiris. Perhatikan bahwa pengiris hanya dapat ditempatkan di sheet yang ada. Selain itu, lebar dan tinggi pengiris dapat disesuaikan secara otomatis agar tetap berada dalam batas yang diizinkan.

SlicerSpec

Spesifikasi pengiris.

Representasi JSON
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Kolom
dataRange

object (GridRange)

Rentang data pemotong.

filterCriteria

object (FilterCriteria)

Kriteria pemfilteran pengiris.

columnIndex

integer

Indeks kolom berbasis nol dalam tabel data tempat filter diterapkan.

applyToPivotTables

boolean

Benar jika filter harus diterapkan ke tabel pivot. Jika tidak disetel, defaultnya adalah True.

title

string

Judul pengiris.

textFormat

object (TextFormat)

Format teks judul dalam pengiris. Kolom link tidak didukung.

backgroundColor
(deprecated)

object (Color)

Warna latar belakang pengirisan. Tidak digunakan lagi: Gunakan backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Warna latar belakang pengirisan. Jika backgroundColor juga ditetapkan, kolom ini akan diprioritaskan.

horizontalAlignment

enum (HorizontalAlign)

Perataan horizontal judul dalam pengiris. Jika tidak ditentukan, setelan defaultnya adalah LEFT

Tabel

Tabel.

Representasi JSON
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Kolom
tableId

string

ID tabel.

name

string

Nama tabel. ID ini unik untuk semua tabel dalam spreadsheet yang sama.

range

object (GridRange)

Rentang tabel.

rowsProperties

object (TableRowsProperties)

Properti baris tabel.

columnProperties[]

object (TableColumnProperties)

Properti kolom tabel.

TableRowsProperties

Properti baris tabel.

Representasi JSON
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Kolom
headerColorStyle

object (ColorStyle)

Warna baris header. Jika kolom ini ditetapkan, baris header akan diisi dengan warna yang ditentukan. Jika tidak, baris header akan diisi dengan warna default.

firstBandColorStyle

object (ColorStyle)

Warna pertama yang bergantian. Jika kolom ini ditetapkan, baris berjalur pertama akan diisi dengan warna yang ditentukan. Jika tidak, baris yang dikelompokkan pertama akan diisi dengan warna default.

secondBandColorStyle

object (ColorStyle)

Warna kedua yang bergantian. Jika kolom ini ditetapkan, baris berjalur kedua akan diisi dengan warna yang ditentukan. Jika tidak, baris kedua yang dikelompokkan akan diisi dengan warna default.

footerColorStyle

object (ColorStyle)

Warna baris terakhir. Jika kolom ini tidak ditetapkan, footer tidak akan ditambahkan, baris terakhir akan diisi dengan firstBandColorStyle atau secondBandColorStyle, bergantung pada warna baris sebelumnya. Jika memperbarui tabel yang ada tanpa footer agar memiliki footer, rentang akan diperluas sebanyak 1 baris. Jika memperbarui tabel yang ada dengan footer dan menghapus footer, rentang akan diperkecil sebanyak 1 baris.

TableColumnProperties

Kolom tabel.

Representasi JSON
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Kolom
columnIndex

integer

Indeks kolom berbasis 0. Indeks ini relatif terhadap posisinya dalam tabel dan tidak harus sama dengan indeks kolom dalam sheet.

columnName

string

Nama kolom.

columnType

enum (ColumnType)

Jenis kolom.

dataValidationRule

object (TableColumnDataValidationRule)

Aturan validasi data kolom. Hanya ditetapkan untuk jenis kolom dropdown.

ColumnType

Jenis kolom untuk kolom tertentu dalam tabel.

Enum
COLUMN_TYPE_UNSPECIFIED Jenis kolom tidak ditentukan.
DOUBLE Jenis kolom angka.
CURRENCY Jenis kolom mata uang.
PERCENT Jenis kolom persentase.
DATE Jenis kolom tanggal.
TIME Jenis kolom waktu.
DATE_TIME Jenis kolom tanggal dan waktu.
TEXT Jenis kolom teks.
BOOLEAN Jenis kolom boolean.
DROPDOWN Jenis kolom dropdown.
FILES_CHIP Jenis kolom chip file
PEOPLE_CHIP Jenis kolom chip orang
FINANCE_CHIP Jenis kolom chip keuangan
PLACE_CHIP Jenis kolom chip tempat
RATINGS_CHIP Jenis kolom chip rating

TableColumnDataValidationRule

Aturan validasi data untuk kolom dalam tabel.

Representasi JSON
{
  "condition": {
    object (BooleanCondition)
  }
}
Kolom
condition

object (BooleanCondition)

Kondisi yang harus dipenuhi oleh data dalam sel. Hanya valid jika [BooleanCondition.type] adalah ONE_OF_LIST.