Sheets

{
  "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)
    }
  ]
}

object (SheetProperties)

Properti sheet.

object (GridData)

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 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 D nol).

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

object (GridRange)

Rentang yang digabungkan.

object (ConditionalFormatRule)

Aturan format bersyarat di sheet ini.

object (FilterView)

Tampilan filter di sheet ini.

object (ProtectedRange)

Rentang yang dilindungi di sheet ini.

object (BasicFilter)

Filter pada sheet ini, jika ada.

object (EmbeddedChart)

Spesifikasi setiap diagram di sheet ini.

object (BandedRange)

Pita (warna alternatif) memiliki rentang pada sheet ini.

object (DeveloperMetadata)

Metadata developer yang terkait dengan sheet.

object (DimensionGroup)

Semua grup baris di sheet ini, diurutkan berdasarkan peningkatan indeks awal rentang, kemudian berdasarkan kedalaman grup.

object (DimensionGroup)

Semua grup kolom di sheet ini, diurutkan menurut peningkatan indeks awal rentang, kemudian berdasarkan kedalaman grup.

object (Slicer)

Pemotong pada sheet ini.

{
  "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)
  }
}

integer

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

string

Nama sheet.

integer

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.

enum (SheetType)

Jenis sheet. Default-nya adalah GRID. Kolom ini tidak dapat diubah setelah ditetapkan.

object (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 DATA_SOURCE, kolom ini hanyalah output, tetapi berisi properti yang mencerminkan cara sheet sumber data dirender di UI, misalnya, rowCount.

boolean

Benar jika sheet disembunyikan di UI, salah jika sheet terlihat.

object (Color)

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

object (ColorStyle)

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

boolean

True jika sheet adalah sheet RTL, bukan sheet LTR.

object (DataSourceSheetProperties)

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

{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}

integer

Jumlah baris dalam petak.

integer

Jumlah kolom dalam petak.

integer

Jumlah baris yang dibekukan di petak.

integer

Jumlah kolom yang dibekukan dalam petak.

boolean

Benar jika petak tidak menampilkan garis kisi di UI.

boolean

Benar jika tombol kontrol pengelompokan baris ditampilkan setelah grup.

boolean

Benar jika tombol kontrol pengelompokan kolom ditampilkan setelah grup.

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

string

ID sheet DataSource terhubung.

object (DataSourceColumn)

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

object (DataExecutionStatus)

Status eksekusi data.

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

integer

Baris pertama yang dirujuk GridData ini, berbasis nol.

integer

Kolom pertama yang dirujuk GridData ini, berbasis nol.

object (RowData)

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

object (DimensionProperties)

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

object (DimensionProperties)

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

{
  "values": [
    {
      object (CellData)
    }
  ]
}

object (CellData)

Nilai dalam baris, satu per kolom.

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

boolean

True jika dimensi ini difilter. Kolom ini bersifat hanya baca.

boolean

Benar jika dimensi ini disembunyikan secara eksplisit.

integer

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

object (DeveloperMetadata)

Metadata developer yang terkait dengan satu baris atau kolom.

object (DataSourceColumnReference)

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

{
  "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.
}

object (GridRange)

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

object (BooleanRule)

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

object (GradientRule)

Formatnya akan bervariasi berdasarkan gradien pada aturan.

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

object (BooleanCondition)

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

object (CellFormat)

Format yang akan diterapkan. Format bersyarat hanya dapat menerapkan sebagian format: bold, italic, strikethrough, foreground color dan, background color.

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

object (InterpolationPoint)

Titik interpolasi awal.

object (InterpolationPoint)

Titik interpolasi opsional di tengah jalan.

object (InterpolationPoint)

Titik interpolasi akhir.

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

object (Color)

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

object (ColorStyle)

Warna yang diperlukan untuk titik interpolasi ini. Jika color juga ditetapkan, kolom ini akan diprioritaskan.

enum (InterpolationPointType)

Cara menginterpretasikan nilai.

string

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

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

integer

ID tampilan filter.

string

Nama tampilan filter.

object (GridRange)

Rentang yang dicakup tampilan filter ini.

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

string

Rentang bernama yang didukung oleh tampilan filter ini, jika ada.

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

object (SortSpec)

Tata urutan per kolom. Spesifikasi berikutnya digunakan jika nilai sama dengan spesifikasi sebelumnya.

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.

object (FilterSpec)

Kriteria filter untuk menampilkan/menyembunyikan nilai per kolom.

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

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

integer

ID rentang dilindungi. Kolom ini bersifat hanya baca.

object (GridRange)

Rentang yang dilindungi. Rentang tersebut mungkin tidak terikat sepenuhnya, sehingga dianggap sebagai sheet yang dilindungi.

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

string

Rentang bernama yang dilindungi oleh rentang ini didukung, jika ada.

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

string

Deskripsi rentang yang dilindungi ini.

boolean

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 editors akan diabaikan. Selain itu, jika kolom ini diubah dari true ke false dan kolom editors tidak ditetapkan (atau tidak disertakan dalam mask kolom), editor akan ditetapkan ke semua editor dalam dokumen.

boolean

Berlaku jika pengguna yang meminta rentang yang dilindungi ini dapat mengedit area yang dilindungi. Kolom ini bersifat hanya baca.

object (GridRange)

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

object (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 warningOnly.

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

string

Alamat email pengguna yang memiliki akses edit ke rentang dilindungi.

string

Alamat email grup dengan akses edit ke rentang dilindungi.

boolean

Berlaku jika ada orang di domain dokumen yang memiliki akses edit ke rentang terlindungi. Perlindungan domain hanya didukung pada dokumen dalam domain.

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

object (GridRange)

Rentang yang dicakup filter.

object (SortSpec)

Tata urutan per kolom. Spesifikasi berikutnya digunakan jika nilai sama dengan spesifikasi sebelumnya.

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.

object (FilterSpec)

Kriteria filter per kolom.

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

{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}

integer

ID rentang band.

object (GridRange)

Rentang tempat properti ini diterapkan.

object (BandingProperties)

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

object (BandingProperties)

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

{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

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

object (Color)

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

object (ColorStyle)

Warna baris atau kolom terakhir. Jika kolom ini tidak ditetapkan, 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.

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

object (DimensionRange)

Rentang yang menjadi lokasi grup ini.

integer

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

boolean

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.

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

integer

ID pemotong.

object (SlicerSpec)

Spesifikasi pemotong.

object (EmbeddedObjectPosition)

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.

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

object (GridRange)

Rentang data pemotong.

object (FilterCriteria)

Kriteria pemfilteran pemotong.

integer

Indeks kolom berbasis nol pada tabel data tempat filter diterapkan.

boolean

True jika filter harus diterapkan pada tabel pivot. Jika tidak ditetapkan, setelan defaultnya adalah True.

string

Judul pemotong.

object (TextFormat)

Format teks judul di pemotong. Kolom link tidak didukung.

object (Color)

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

object (ColorStyle)

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

enum (HorizontalAlign)

Perataan horizontal judul di pemotong. Jika tidak ditentukan, setelan defaultnya adalah LEFT