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 {i>sheet<i}.

object (GridData)

Data dalam petak, jika berupa sheet petak.

Jumlah objek GridData yang ditampilkan bergantung pada jumlah rentang yang diminta pada sheet ini. Misalnya, jika ini merepresentasikan Sheet1, dan spreadsheet ini diminta dengan rentang Sheet1!A1:C10 dan Sheet1!D15:E20, maka GridData pertama akan memiliki startRow / startColumn pengguna 0, sedangkan yang kedua memiliki startRow 14 (baris berbasis nol ke 15), dan startColumn 3 (kolom D berbasis nol).

Untuk DATA_SOURCE {i>sheet<i}, Anda tidak dapat meminta rentang tertentu, GridData berisi semua nilai.

object (GridRange)

Rentang sel yang digabungkan.

object (ConditionalFormatRule)

Aturan format bersyarat dalam sheet ini.

object (FilterView)

Tampilan filter di sheet ini.

object (ProtectedRange)

Rentang dilindungi di sheet ini.

object (BasicFilter)

Filter di sheet ini, jika ada.

object (EmbeddedChart)

Spesifikasi setiap diagram pada sheet ini.

object (BandedRange)

Rentang band (warna alternatif) pada sheet ini.

object (DeveloperMetadata)

Metadata developer yang terkait dengan sheet.

object (DimensionGroup)

Semua grup baris pada sheet ini, diurutkan dengan meningkatkan indeks awal rentang, lalu menurut kedalaman grup.

object (DimensionGroup)

Semua grup kolom pada sheet ini, diurutkan dengan meningkatkan indeks awal rentang, lalu berdasarkan kedalaman grup.

object (Slicer)

Pemotong di 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 disetel.

string

Nama sheet.

integer

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, gerakan dianggap dalam "sebelum perpindahan" indeks. 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.

enum (SheetType)

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

object (GridProperties)

Properti tambahan sheet jika sheet ini berupa petak. (Jika sheet tersebut adalah sheet objek, yang berisi diagram atau gambar, kolom ini tidak akan ada.) Saat menulis, adalah kesalahan untuk menetapkan properti grid pada sheet non-kisi.

Jika {i>sheet<i} ini adalah DATA_SOURCE , kolom ini hanya output tetapi berisi properti yang mencerminkan bagaimana sheet sumber data dirender di UI, misalnya rowCount.

boolean

True jika sheet disembunyikan di UI, false jika terlihat.

object (Color)

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

object (ColorStyle)

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

boolean

True jika sheet adalah sheet RTL, bukan sheet LTR.

object (DataSourceSheetProperties)

Hanya output. Jika ada, kolomnya berisi DATA_SOURCE properti spesifik pada {i>sheet<i}.

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

integer

Jumlah baris dalam petak.

integer

Jumlah kolom di petak.

integer

Jumlah baris yang dibekukan dalam petak.

integer

Jumlah kolom yang dibekukan dalam petak.

boolean

Benar jika petak tidak menampilkan garis petak 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 DataSource terhubung dengan {i>sheet<i}.

object (DataSourceColumn)

Kolom yang ditampilkan di {i>sheet<i}, sesuai dengan nilai di RowData.

object (DataExecutionStatus)

Status eksekusi data.

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

integer

Baris pertama yang dirujuk oleh GridData ini, berbasis nol.

integer

Kolom pertama yang dirujuk oleh GridData ini, berbasis nol.

object (RowData)

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

object (DimensionProperties)

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

object (DimensionProperties)

Metadata tentang kolom yang diminta dalam kisi/{i>grid<i}, dimulai dengan kolom di startColumn.

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

object (CellData)

Nilai dalam baris, satu nilai 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 berupa baris) atau lebar (jika kolom) dari dimensi dalam piksel.

object (DeveloperMetadata)

Metadata developer yang terkait dengan satu baris atau kolom.

object (DataSourceColumnReference)

Hanya output. Jika ditetapkan, ini adalah kolom dalam 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 pada petak yang sama.

object (BooleanRule)

Formatnya adalah "on" atau "nonaktif" sesuai dengan aturan.

object (GradientRule)

Formatnya akan bervariasi berdasarkan gradien dalam aturan.

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

object (BooleanCondition)

Kondisi aturan. Jika kondisi bernilai benar (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 tengah jalan opsional.

object (InterpolationPoint)

Titik interpolasi terakhir.

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

object (Color)

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

object (ColorStyle)

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

enum (InterpolationPointType)

Cara nilai harus ditafsirkan.

string

Nilai yang digunakan oleh titik interpolasi ini. Mungkin berupa formula. Tidak digunakan jika type sesuai dengan 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 oleh tampilan filter ini.

Saat menulis, hanya satu dari range atau namedRangeId mungkin disetel.

string

Rentang bernama yang didukung tampilan filter ini, jika ada.

Saat menulis, hanya satu dari range atau namedRangeId mungkin disetel.

object (SortSpec)

Tata urutan per kolom. Spesifikasi selanjutnya digunakan ketika nilai sama dalam 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 oleh filterSpecs.

object (FilterSpec)

Kriteria filter untuk menampilkan/menyembunyikan nilai per kolom.

Keduanya criteria dan filterSpecs akan diisikan dalam jawaban. Jika kedua kolom ditentukan dalam permintaan update, 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 dapat sepenuhnya tidak terbatas, dalam hal ini rentang dianggap sebagai sheet terlindungi.

Saat menulis, hanya satu dari range atau namedRangeId mungkin disetel.

string

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

Saat menulis, hanya satu dari range atau namedRangeId mungkin disetel.

string

Deskripsi rentang dilindungi ini.

boolean

True jika rentang dilindungi ini akan menampilkan peringatan saat mengedit. Perlindungan berbasis peringatan berarti setiap pengguna dapat mengedit data dalam rentang yang dilindungi, kecuali jika pengeditan akan menampilkan peringatan yang meminta pengguna untuk mengonfirmasi pengeditan.

Saat menulis: jika kolom ini benar, maka editors akan diabaikan. Selain itu, jika {i>field<i} ini diubah dari {i>true<i} menjadi {i>false<i} dan editors kolom ini tidak ditetapkan (atau disertakan dalam mask kolom), maka editor akan ditetapkan ke semua editor dalam dokumen.

boolean

True jika pengguna yang meminta rentang dilindungi ini dapat mengedit kawasan lindung. Kolom ini bersifat hanya baca.

object (GridRange)

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

object (Editors)

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

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

string

Alamat email pengguna yang memiliki akses edit ke rentang dilindungi.

string

Alamat email grup yang memiliki akses edit ke rentang dilindungi.

boolean

True jika siapa pun dalam domain dokumen memiliki akses edit ke rentang dilindungi. 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 selanjutnya digunakan ketika nilai sama dalam 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 oleh filterSpecs.

object (FilterSpec)

Kriteria filter per kolom.

Keduanya criteria dan filterSpecs akan diisikan dalam jawaban. Jika kedua kolom ditentukan dalam permintaan update, 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 rentang baris. Properti ini diterapkan baris demi baris pada semua baris dalam rentang tersebut. Setidaknya salah satu rowProperties atau columnProperties harus ditentukan.

object (BandingProperties)

Properti untuk rentang kolom. Properti ini diterapkan pada basis kolom demi kolom di seluruh kolom dalam rentang tersebut. Setidaknya salah satu 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 {i>field<i} ini telah diatur, baris atau kolom pertama diisi dengan warna ini dan warnanya berganti-ganti firstBandColor dan secondBandColor mulai dari baris atau kolom kedua. Jika tidak, baris atau kolom pertama akan diisi dengan firstBandColor dan warnanya terus bergantian seperti biasanya. Tidak berlaku lagi: Gunakan headerColorStyle.

object (ColorStyle)

Warna baris atau kolom pertama. Jika {i>field<i} ini telah diatur, baris atau kolom pertama diisi dengan warna ini dan warnanya berganti-ganti firstBandColor dan secondBandColor mulai dari baris atau kolom kedua. Jika tidak, baris atau kolom pertama akan diisi dengan firstBandColor dan warnanya terus bergantian seperti biasanya. Jika headerColor 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 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 ditetapkan, kolom ini akan diprioritaskan.

object (Color)

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

object (ColorStyle)

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

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

object (DimensionRange)

Rentang yang mencakup grup ini.

integer

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

boolean

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 sebenarnya tidak berarti bahwa semua dimensi dalam grup disembunyikan, karena visibilitas dimensi dapat berubah secara terpisah dari properti grup ini. Namun, jika properti ini diperbarui, semua dimensi di dalamnya akan disetel ke tersembunyi jika kolom ini benar (true), atau disetel ke terlihat jika kolom ini disetel ke salah (false).

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

integer

ID pemotong.

object (SlicerSpec)

Spesifikasi pemotong.

object (EmbeddedObjectPosition)

Posisi pemotong. Perhatikan bahwa pemotong dapat diposisikan hanya pada sheet yang sudah ada. Selain itu, lebar dan tinggi pemotong dapat disesuaikan secara otomatis untuk menjaganya tetap dalam 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 ke tabel pivot. Jika tidak disetel, secara default disetel ke True.

string

Judul pemotong.

object (TextFormat)

Format teks judul dalam pemotong. Kolom link tidak didukung.

object (Color)

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

object (ColorStyle)

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

enum (HorizontalAlign)

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