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 ke dalam sel. misalnya, 1234, 'Hello', atau =NOW() Catatan: Tanggal, Waktu, dan {i>DateTimes<i} diwakili sebagai jenis ganda serial number format font.

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 ditunjukkan 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 sedang 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 di sel.

textFormatRuns[]

object (TextFormatRun)

Rangkaian rich text yang diterapkan ke subbagian sel. Run hanya valid pada string yang dimasukkan pengguna, bukan formula, bool, atau angka. Properti lari dimulai pada indeks tertentu dalam teks dan berlanjut hingga proses berikutnya. Operasi akan mewarisi properti sel kecuali jika diubah secara eksplisit.

Saat penulisan, operasi baru akan menimpa operasi sebelumnya. Saat menulis userEnteredValue, sesi 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 ditambatkan pada 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 lain akan berisi nilai yang dihitung dari hasil pivot pada effectiveValue kolom.

dataSourceTable

object (DataSourceTable)

Tabel sumber data yang ditambatkan pada 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 lain akan berisi nilai tampilan dari hasil tabel sumber data dalam effectiveValue kolom.

dataSourceFormula

object (DataSourceFormula)

Hanya output. Informasi tentang formula sumber data pada sel. Kolom ini ditetapkan jika userEnteredValue formula yang merujuk ke DATA_SOURCE spreadsheet, mis. =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 berlaku lagi: Gunakan backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

Batas sel.

padding

object (Padding)

Padding sel.

horizontalAlignment

enum (HorizontalAlign)

Perataan 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 sel yang ada. Menyetel bidang link dalam TextFormatRun lebih diutamakan daripada link tingkat sel.

textRotation

object (TextRotation)

Rotasi yang diterapkan pada 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 disetel, 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, lokal diasumsikan sebagai en_US, tetapi format sebenarnya bergantung pada lokalitas spreadsheet.

Enum
NUMBER_FORMAT_TYPE_UNSPECIFIED Format angka tidak ditentukan dan berdasarkan isi sel. Jangan gunakan ini secara eksplisit.
TEXT Pemformatan teks, misalnya 1000.12
NUMBER Pemformatan angka, misalnya, 1,000.12
PERCENT Pemformatan persen, mis. 10.12%
CURRENCY Pemformatan mata uang, mis. $1,000.12
DATE Pemformatan tanggal, misalnya 9/26/2008
TIME Pemformatan waktu, misalnya 3:59:00 PM
DATE_TIME Pemformatan Tanggal+Waktu, mis. 9/26/08 15:59:00
SCIENTIFIC Pemformatan angka ilmiah, mis. 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 pembatas, dalam piksel. Tidak digunakan lagi; lebarnya ditentukan oleh "style" kolom tersebut.

color
(deprecated)

object (Color)

Warna batas. Tidak berlaku lagi: Gunakan colorStyle.

colorStyle

object (ColorStyle)

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

Gaya

Gaya garis batas.

Enum
STYLE_UNSPECIFIED Gaya belum ditetapkan. Jangan gunakan ini.
DOTTED Batasnya berbentuk putus-putus.
DASHED Batasnya putus-putus.
SOLID Batasnya berupa garis tebal tipis.
SOLID_MEDIUM Batasnya berupa garis tebal sedang.
SOLID_THICK Batasnya berupa garis tebal yang 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 mengupdate 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 diratakan ke bagian tengah sel.
BOTTOM Teks secara eksplisit diratakan dengan bagian bawah sel.

WrapStrategy

Cara mengemas teks dalam sel.

Enum
WRAP_STRATEGY_UNSPECIFIED Nilai default, jangan digunakan.
OVERFLOW_CELL

Garis yang lebih panjang dari lebar sel akan ditulis di sel berikutnya, selama sel tersebut kosong. Jika sel berikutnya tidak kosong, perilakunya sama dengan CLIP. Teks tidak akan pernah dibungkus ke baris berikutnya kecuali 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, dengan kata-kata yang lebih panjang dari sebuah baris terpotong, bukan rusak. Strategi ini tidak didukung di semua platform dan akan dihentikan. Contoh:

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

Garis yang lebih panjang dari lebar sel akan diklip. Teks tidak akan pernah dibungkus ke baris berikutnya kecuali 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 disetel oleh pengguna.
RIGHT_TO_LEFT Arah teks kanan-ke-kiri disetel oleh pengguna.

HyperlinkDisplayType

Apakah akan merender hyperlink secara eksplisit. Jika tidak ditentukan, berarti 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 union 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, 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 true (benar), teks akan 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 proses berikutnya. Saat mengupdate, semua kolom harus ditetapkan.

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

integer

Indeks karakter berbasis nol tempat proses 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 data yang ada dalam sel tersebut harus cocok.

inputMessage

string

Pesan yang akan ditampilkan kepada pengguna saat menambahkan data ke sel.

strict

boolean

True jika data yang tidak valid harus ditolak.

showCustomUi

boolean

True jika UI harus disesuaikan berdasarkan jenis kondisi. Jika benar, "Daftar" kondisi tertentu akan menampilkan {i>dropdown<i}.

DataSourceTable

Tabel sumber data, yang memungkinkan pengguna mengimpor tabel data statis dari DataSource ke dalam Spreadsheet. Metode ini juga dikenal sebagai "{i>Extract<i}" 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 tabel sumber data. Default-nya adalah SELECTED.

columns[]

object (DataSourceColumnReference)

Kolom yang dipilih untuk tabel sumber data. Tujuan 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 disetel, 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 pemilihan kolom default, jangan digunakan.
SELECTED Pilih kolom yang ditentukan oleh columns kolom tersebut.
SYNC_ALL

Sinkronkan semua kolom saat ini dan 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 dikaitkan dengan formula.

dataExecutionStatus

object (DataExecutionStatus)

Hanya output. Status eksekusi data.