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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
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. Hal ini mencakup hasil penerapan pemformatan bersyarat 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 menulis, aturan validasi data 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 ditetapkan jika userEnteredValue adalah formula yang mereferensikan beberapa sheet DATA_SOURCE, misalnya =SUM(DataSheet!Column).

chipRuns[]

object (ChipRun)

Opsional. Pengoperasian chip yang diterapkan ke subbagian sel. Properti operasi dimulai pada indeks tertentu dalam teks dan berlanjut hingga operasi berikutnya.

Saat membaca, semua run yang memiliki chip dan tidak memiliki chip akan disertakan. Run yang tidak di-chip akan memiliki Chip kosong.

Saat menulis, hanya run dengan chip yang disertakan. Run yang berisi chip memiliki panjang 1 dan direpresentasikan dalam teks yang dimasukkan pengguna dengan simbol placeholder “@”. Pengoperasian baru akan menimpa pengoperasian sebelumnya. Menulis userEnteredValue baru akan menghapus operasi sebelumnya.

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 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)

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

Enum
STYLE_UNSPECIFIED Gaya tidak ditentukan. Jangan gunakan ini.
DOTTED Batas bergaris putus-putus.
DASHED Batas putus-putus.
SOLID Batas adalah garis utuh 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 adalah dua garis solid.

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 disejajarkan ke bagian atas sel.
MIDDLE Teks secara eksplisit disejajarkan ke tengah sel.
BOTTOM Teks secara eksplisit disejajarkan ke bagian bawah sel.

WrapStrategy

Cara meringkas teks dalam sel.

Enum
WRAP_STRATEGY_UNSPECIFIED Nilai default, jangan gunakan.
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 satu baris akan digabungkan di tingkat karakter, bukan dipotong. 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 berada dalam arah berlawanan arah jarum jam, sedangkan untuk RTL, sudut positif berada 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

Pengoperasian format teks. Format operasi ini berlanjut hingga indeks awal operasi 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 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. Default-nya adalah SELECTED.

columns[]

object (DataSourceColumnReference)

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

filterSpecs[]

object (FilterSpec)

Memfilter spesifikasi di tabel sumber data.

sortSpecs[]

object (SortSpec)

Spesifikasi pengurutan 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 di 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.

ChipRun

Operasi chip. Chip akan berlanjut hingga indeks awal operasi berikutnya.

Representasi JSON 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
Kolom
startIndex

integer

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

chip

object (Chip)

Opsional. Chip dari operasi ini.

Chip

Smart Chip.

Representasi JSON 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
Kolom
Kolom gabungan properties. Properti chip. properties hanya dapat berupa salah satu dari hal berikut:
personProperties

object (PersonProperties)

Properti orang yang ditautkan.

PersonProperties

Properti khusus untuk orang yang ditautkan.

Representasi JSON 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
Kolom
email

string

Wajib. Alamat email yang ditautkan ke orang ini. Kolom ini selalu ada.

displayFormat

enum (DisplayFormat)

Opsional. Format tampilan chip orang. Jika tidak ditetapkan, format tampilan default akan digunakan.

DisplayFormat

Format tampilan pilihan jika tersedia.

Enum
DISPLAY_FORMAT_UNSPECIFIED Nilai default, jangan gunakan.
DEFAULT Format tampilan default.
LAST_NAME_COMMA_FIRST_NAME Format tampilan nama belakang, nama depan.
EMAIL Format tampilan email.

RichLinkProperties

Properti link ke referensi Google (seperti file di Drive, video YouTube, alamat Maps, atau acara Kalender). Hanya file Drive yang dapat ditulis sebagai chip. Semua jenis link kaya lainnya bersifat hanya baca.

URI tidak boleh melebihi 2.000 byte saat menulis.

CATATAN: Menulis chip file Drive memerlukan setidaknya salah satu cakupan OAuth drive.file, drive.readonly, atau drive.

Representasi JSON 
{
  "uri": string,
  "mimeType": string
}
Kolom
uri

string

Wajib. URI ke link. Ini selalu ada.

mimeType

string

Hanya output. Jenis MIME link, jika ada (misalnya, jika link tersebut adalah file di Drive).