Cells

Data Seluler

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 duplikat dalam format serial number.

effectiveValue

object (ExtendedValue)

Nilai efektif dari sel. Untuk sel yang berisi formula, ini adalah nilai yang dihitung. Untuk sel yang memiliki 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 dan, jika sel berisi formula, format angka yang dihitung. Jika format yang efektif adalah format default, format yang efektif tidak akan ditulis. Kolom ini bersifat hanya baca.

note

string

Catatan apa pun di sel.

textFormatRuns[]

object (TextFormatRun)

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

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

dataValidation

object (DataValidationRule)

Aturan validasi data pada sel, jika ada.

Saat menulis, aturan validasi data baru akan menimpa aturan sebelumnya.

pivotTable

object (PivotTable)

Tabel pivot ditambatkan pada sel ini. Ukuran tabel pivot 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 dalam kolom effectiveValue-nya.

dataSourceTable

object (DataSourceTable)

Tabel sumber data yang ditambatkan pada sel ini. Ukuran tabel sumber data dihitung secara dinamis berdasarkan konfigurasinya. Hanya sel pertama dari tabel sumber data yang berisi definisi tabel sumber data. Sel lain akan berisi nilai tampilan di tabel sumber data yang dihasilkan dalam kolom effectiveValue-nya.

dataSourceFormula

object (DataSourceFormula)

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

Format Sel

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 cara nilai angka ditampilkan 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)

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 dengan format yang berjalan). Menetapkan link tingkat sel di sini akan menghapus link yang ada di sel. Menetapkan kolom link di TextFormatRun akan lebih diprioritaskan daripada link tingkat sel.

textRotation

object (TextRotation)

Rotasi yang diterapkan pada teks dalam sel.

AngkaFormat

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 informasi selengkapnya tentang pola yang didukung.

JenisFormatAngka

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

Enumerasi
NUMBER_FORMAT_TYPE_UNSPECIFIED Format angka tidak ditentukan dan didasarkan pada isi sel. Jangan gunakan atribut 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, misalnya $1,000.12
DATE Format 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.

Border

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 batas.

Enumerasi
STYLE_UNSPECIFIED Gaya tidak ditentukan. Jangan gunakan ini.
DOTTED Batasnya putus-putus.
DASHED Batasnya putus-putus.
SOLID Batasnya adalah garis tebal tipis.
SOLID_MEDIUM Batasnya adalah garis tebal sedang.
SOLID_THICK Batasnya adalah garis tebal dan tebal.
NONE Tidak ada batas. Hanya digunakan saat memperbarui batas untuk menghapusnya.
DOUBLE Batasnya adalah 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.

Perataan Vertikal

Perataan vertikal teks dalam sel.

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

Strategi Wrap

Cara menggabungkan teks dalam sel.

Enumerasi
WRAP_STRATEGY_UNSPECIFIED Nilai default, jangan gunakan.
OVERFLOW_CELL

Baris yang lebih panjang dari lebar sel akan ditulis dalam sel berikutnya, asalkan sel tersebut kosong. Jika sel berikutnya tidak kosong, perilaku ini sama dengan CLIP. Teks tidak akan pernah digabungkan 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 pengemasan Google Spreadsheet lama dengan kata-kata yang lebih panjang daripada garis yang diklip daripada dipotong. Strategi ini tidak didukung di semua platform dan sedang dihentikan. Contoh:

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

Garis yang lebih panjang dari lebar sel akan terpotong. Teks tidak akan pernah digabungkan 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, bukan terpotong. Contoh:

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

Arah Teks

Arah teks dalam sel.

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

HyperlinkDisplayType

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

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

Rotasi Teks

Rotasi yang diterapkan pada 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 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 negatif miring ke bawah.

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

vertical

boolean

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

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

FormatTeksJalankan

Menjalankan format teks. Format operasi ini berlanjut hingga indeks awal proses berikutnya. Saat memperbarui, 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 akan mewarisi format sel.

AturanValidasiData

Aturan validasi data.

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

object (BooleanCondition)

Kondisi yang sesuai dengan data dalam sel.

inputMessage

string

Pesan untuk ditampilkan kepada pengguna saat menambahkan data ke sel.

strict

boolean

True jika data yang tidak valid harus ditolak.

showCustomUi

boolean

Benar jika UI harus disesuaikan berdasarkan jenis kondisi. Jika true (benar), kondisi "List" akan menampilkan dropdown.

TabelTabel

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 tabel tabel data. Default-nya adalah SELECTED.

columns[]

object (DataSourceColumnReference)

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

filterSpecs[]

object (FilterSpec)

Filter spesifikasi di tabel sumber data.

sortSpecs[]

object (SortSpec)

Urutkan spesifikasi dalam 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 pilihan kolom tabel sumber data.

Enumerasi
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Jangan gunakan jenis pemilihan kolom default.
SELECTED Pilih kolom yang ditentukan oleh kolom columns.
SYNC_ALL

Menyinkronkan semua kolom saat ini dan mendatang di sumber data.

Jika ditetapkan, tabel sumber data akan mengambil semua kolom di sumber data pada saat memuat ulang.

Formula DataSource

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.