Cells

CellData

Data tentang sel tertentu.

Representasi JSON 
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Kolom
userEnteredValue

object (ExtendedValue)

Nilai yang dimasukkan pengguna di sel. misalnya, 1234, 'Hello', atau =NOW() Catatan: Tanggal, Waktu, dan DateTime direpresentasikan sebagai bilangan ganda dalam format serial number.

effectiveValue

object (ExtendedValue)

Nilai efektif sel. Untuk sel dengan formula, ini adalah nilai yang dihitung. Untuk sel dengan literal, ini sama dengan userEnteredValue. Kolom ini bersifat hanya baca.

formattedValue

string

Nilai sel yang diformat. Ini adalah nilai yang ditampilkan kepada pengguna. Kolom ini bersifat hanya baca.

userEnteredFormat

object (CellFormat)

Format yang dimasukkan pengguna untuk sel.

Saat menulis, format baru akan digabungkan dengan format yang ada.

effectiveFormat

object (CellFormat)

Format efektif yang digunakan oleh sel. Ini mencakup hasil penerapan format bersyarat apa pun dan, jika sel berisi formula, format angka yang dihitung. Jika format efektif adalah format default, format efektif tidak akan ditulis. Kolom ini bersifat hanya baca.

note

string

Catatan apa pun pada sel.

textFormatRuns[]

object (TextFormatRun)

Menjalankan rich text yang diterapkan ke subbagian sel. Pengoperasian hanya valid pada string yang dimasukkan pengguna, bukan formula, boolean, atau angka. Properti operasi dimulai pada indeks tertentu dalam teks dan berlanjut hingga operasi berikutnya. Pengoperasian akan mewarisi properti sel kecuali jika diubah secara eksplisit.

Saat menulis, operasi baru akan menimpa operasi sebelumnya. Saat menulis userEnteredValue baru, operasi sebelumnya akan dihapus.

dataValidation

object (DataValidationRule)

Aturan validasi data pada sel, jika ada.

Saat penulisan, aturan validasi data yang baru akan menimpa aturan sebelumnya.

pivotTable

object (PivotTable)

Tabel pivot yang disematkan di sel ini. Ukuran tabel pivot itu sendiri dihitung secara dinamis berdasarkan data, pengelompokan, filter, nilai, dll. Hanya sel kiri atas tabel pivot yang berisi definisi tabel pivot. Sel lainnya akan berisi nilai yang dihitung dari hasil pivot di kolom effectiveValue mereka.

dataSourceTable

object (DataSourceTable)

Tabel sumber data yang disematkan di sel ini. Ukuran tabel sumber data itu sendiri dihitung secara dinamis berdasarkan konfigurasinya. Hanya sel pertama tabel sumber data yang berisi definisi tabel sumber data. Sel lainnya akan berisi nilai tampilan hasil tabel sumber data di kolom effectiveValue mereka.

dataSourceFormula

object (DataSourceFormula)

Hanya output. Informasi tentang formula sumber data di sel. Kolom ini ditetapkan jika userEnteredValue adalah formula yang mereferensikan beberapa sheet DATA_SOURCE, misalnya =SUM(DataSheet!Column).

CellFormat

Format sel.

Representasi JSON 
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Kolom
numberFormat

object (NumberFormat)

Format yang menjelaskan bagaimana nilai angka harus direpresentasikan kepada pengguna.

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

Batas sel.

padding

object (Padding)

Padding sel.

horizontalAlignment

enum (HorizontalAlign)

Penyelarasan horizontal nilai dalam sel.

verticalAlignment

enum (VerticalAlign)

Perataan vertikal nilai dalam sel.

wrapStrategy

enum (WrapStrategy)

Strategi penggabungan untuk nilai dalam sel.

textDirection

enum (TextDirection)

Arah teks dalam sel.

textFormat

object (TextFormat)

Format teks dalam sel (kecuali jika diganti oleh format yang dijalankan). Menetapkan link tingkat sel di sini akan menghapus link yang ada di sel. Menetapkan kolom link di TextFormatRun lebih diutamakan daripada link tingkat sel.

textRotation

object (TextRotation)

Rotasi yang diterapkan ke teks dalam sel.

NumberFormat

Format angka sel.

Representasi JSON 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Kolom
type

enum (NumberFormatType)

Jenis format angka. Saat menulis, kolom ini harus ditetapkan.

pattern

string

String pola yang digunakan untuk pemformatan. Jika tidak ditetapkan, pola default berdasarkan lokalitas pengguna akan digunakan jika diperlukan untuk jenis tertentu. Lihat panduan Format Tanggal dan Angka untuk mengetahui informasi selengkapnya tentang pola yang didukung.

NumberFormatType

Format angka sel. Dalam dokumentasi ini, lokalitas diasumsikan sebagai en_US, tetapi format sebenarnya bergantung pada lokalitas spreadsheet.

Enum
NUMBER_FORMAT_TYPE_UNSPECIFIED Format angka tidak ditentukan dan didasarkan pada konten sel. Jangan gunakan ini secara eksplisit.
TEXT Pemformatan teks, misalnya, 1000.12
NUMBER Pemformatan angka, misalnya, 1,000.12
PERCENT Pemformatan persen, misalnya 10.12%
CURRENCY Pemformatan mata uang, misalnya $1,000.12
DATE Pemformatan tanggal, misalnya 9/26/2008
TIME Pemformatan waktu, misalnya 3:59:00 PM
DATE_TIME Format Tanggal+Waktu, misalnya 9/26/08 15:59:00
SCIENTIFIC Pemformatan angka ilmiah, misalnya 1.01E+03

Batas

Batas sel.

Representasi JSON 
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Kolom
top

object (Border)

Batas atas sel.

bottom

object (Border)

Batas bawah sel.

left

object (Border)

Batas kiri sel.

right

object (Border)

Batas kanan sel.

Batas

Batas di sepanjang sel.

Representasi JSON 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Kolom
style

enum (Style)

Gaya batas.

width
(deprecated)

integer

Lebar batas, dalam piksel. Tidak digunakan lagi; lebar ditentukan oleh kolom "style".

color
(deprecated)

object (Color)

Warna batas. Tidak digunakan lagi: Gunakan colorStyle.

colorStyle

object (ColorStyle)

Warna batas. Jika color juga ditetapkan, kolom ini akan diprioritaskan.

Gaya

Gaya garis batas.

Enum
STYLE_UNSPECIFIED Gaya tidak ditentukan. Jangan gunakan ini.
DOTTED Batasnya berbentuk putus-putus.
DASHED Batas putus-putus.
SOLID Batasnya berupa garis tebal tipis.
SOLID_MEDIUM Batas adalah garis utuh sedang.
SOLID_THICK Batas adalah garis utuh tebal.
NONE Tidak ada batas. Hanya digunakan saat memperbarui batas untuk menghapusnya.
DOUBLE Batasnya berupa dua garis tebal.

Padding

Jumlah padding di sekitar sel, dalam piksel. Saat memperbarui padding, setiap kolom harus ditentukan.

Representasi JSON 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Kolom
top

integer

Padding atas sel.

right

integer

Padding kanan sel.

bottom

integer

Padding bawah sel.

left

integer

Padding kiri sel.

VerticalAlign

Perataan vertikal teks dalam sel.

Enum
VERTICAL_ALIGN_UNSPECIFIED Perataan vertikal tidak ditentukan. Jangan gunakan ini.
TOP Teks secara eksplisit diratakan dengan bagian atas sel.
MIDDLE Teks secara eksplisit disejajarkan ke tengah sel.
BOTTOM Teks secara eksplisit disejajarkan ke bagian bawah sel.

WrapStrategy

Cara mengemas teks dalam sel.

Enum
WRAP_STRATEGY_UNSPECIFIED Nilai default, jangan digunakan.
OVERFLOW_CELL

Baris yang lebih panjang dari lebar sel akan ditulis di sel berikutnya, selama sel tersebut kosong. Jika sel berikutnya tidak kosong, perilakunya sama seperti CLIP. Teks tidak akan pernah disambungkan ke baris berikutnya kecuali jika pengguna menyisipkan baris baru secara manual. Contoh: 

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

Strategi penggabungan ini mewakili strategi penggabungan Google Spreadsheet lama, yaitu kata yang lebih panjang dari satu baris akan dipangkas, bukan dipecah. Strategi ini tidak didukung di semua platform dan akan dihentikan secara bertahap. Contoh: 

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Baris yang lebih panjang dari lebar sel akan terpotong. Teks tidak akan pernah disambungkan ke baris berikutnya kecuali jika pengguna menyisipkan baris baru secara manual. Contoh: 

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Kata yang lebih panjang dari baris akan digabungkan pada tingkat karakter, tidak diklip. Contoh: 

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

Arah teks dalam sel.

Enum
TEXT_DIRECTION_UNSPECIFIED Arah teks tidak ditentukan. Jangan gunakan ini.
LEFT_TO_RIGHT Arah teks kiri-ke-kanan ditetapkan oleh pengguna.
RIGHT_TO_LEFT Arah teks kanan-ke-kiri ditetapkan oleh pengguna.

HyperlinkDisplayType

Apakah akan merender hyperlink secara eksplisit. Jika tidak ditentukan, hyperlink akan ditautkan.

Enum
LINKED Hyperlink harus dirender secara eksplisit.
PLAIN_TEXT Hyperlink tidak boleh dirender.

TextRotation

Rotasi yang diterapkan ke teks dalam sel.

Representasi JSON 
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Kolom
Kolom gabungan type. Jenis rotasi, vertikal atau miring. type hanya dapat berupa salah satu dari hal berikut:
angle

integer

Sudut antara orientasi standar dan orientasi yang diinginkan. Diukur dalam derajat. Nilai yang valid adalah antara -90 dan 90. Sudut positif miring ke atas, sudut negatif miring ke bawah.

Catatan: Untuk arah teks LTR, sudut positif dalam arah berlawanan arah jarum jam, sedangkan untuk RTL, sudut positif dalam arah searah jarum jam

vertical

boolean

Jika benar, teks dibaca dari atas ke bawah, tetapi orientasi setiap karakter tidak berubah. Contoh: 

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

Sekumpulan format teks. Format operasi ini berlanjut hingga indeks awal operasi berikutnya. Saat mengupdate, semua kolom harus ditetapkan.

Representasi JSON 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
Kolom
startIndex

integer

Indeks karakter berbasis nol tempat operasi ini dimulai, dalam unit kode UTF-16.

format

object (TextFormat)

Format operasi ini. Nilai yang tidak ada mewarisi format sel.

DataValidationRule

Aturan validasi data.

Representasi JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Kolom
condition

object (BooleanCondition)

Kondisi yang harus cocok dengan data dalam sel.

inputMessage

string

Pesan untuk ditampilkan kepada pengguna saat menambahkan data ke sel.

strict

boolean

Benar jika data yang tidak valid harus ditolak.

showCustomUi

boolean

Benar jika UI harus disesuaikan berdasarkan jenis kondisi. Jika true, kondisi "Daftar" akan menampilkan dropdown.

DataSourceTable

Tabel sumber data, yang memungkinkan pengguna mengimpor tabel data statis dari DataSource ke Spreadsheet. Tindakan ini juga dikenal sebagai "Ekstrak" di editor Spreadsheet.

Representasi JSON 
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Kolom
dataSourceId

string

ID sumber data yang dikaitkan dengan tabel sumber data.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Jenis untuk memilih kolom untuk tabel sumber data. Nilai defaultnya adalah SELECTED.

columns[]

object (DataSourceColumnReference)

Kolom yang dipilih untuk tabel sumber data. columnSelectionType harus SELECTED.

filterSpecs[]

object (FilterSpec)

Spesifikasi filter di tabel sumber data.

sortSpecs[]

object (SortSpec)

Mengurutkan spesifikasi di tabel sumber data. Hasil tabel sumber data diurutkan berdasarkan spesifikasi pengurutan secara berurutan.

rowLimit

integer

Batas baris yang akan ditampilkan. Jika tidak ditetapkan, batas default akan diterapkan. Lihat editor Spreadsheet untuk mengetahui batas default dan maksimum.

dataExecutionStatus

object (DataExecutionStatus)

Hanya output. Status eksekusi data.

DataSourceTableColumnSelectionType

Jenis pemilihan kolom tabel sumber data.

Enum
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Jenis pilihan kolom default, jangan gunakan.
SELECTED Pilih kolom yang ditentukan oleh kolom columns.
SYNC_ALL

Sinkronkan semua kolom yang ada dan kolom di masa mendatang di sumber data.

Jika ditetapkan, tabel sumber data akan mengambil semua kolom dalam sumber data pada saat pembaruan.

DataSourceFormula

Formula sumber data.

Representasi JSON 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Kolom
dataSourceId

string

ID sumber data yang terkait dengan formula.

dataExecutionStatus

object (DataExecutionStatus)

Hanya output. Status eksekusi data.