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 dalam sel. Misalnya, 1234, 'Hello', atau =NOW() Catatan: Tanggal, Waktu, dan TanggalWaktu ditampilkan sebagai 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 format 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)

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

Saat menulis, operasi baru akan menggantikan 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 menggantikan aturan sebelumnya.

pivotTable

object (PivotTable)

Tabel pivot yang ditambatkan 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 masing-masing.

dataSourceTable

object (DataSourceTable)

Tabel sumber data yang ditambatkan 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 masing-masing.

dataSourceFormula

object (DataSourceFormula)

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

chipRuns[]

object (ChipRun)

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

Saat membaca, semua lari yang menggunakan chip dan tidak menggunakan chip disertakan. Lari tanpa chip akan memiliki Chip kosong.

Saat menulis, hanya lari dengan chip yang disertakan. Chip yang berisi kata memiliki panjang 1 dan direpresentasikan dalam teks yang dimasukkan pengguna dengan simbol placeholder “@”. Run baru akan menggantikan run sebelumnya. Menulis yang baru userEnteredValue akan menghapus proses 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 harus 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 pelengkapan untuk nilai dalam sel.

textDirection

enum (TextDirection)

Arah teks dalam sel.

textFormat

object (TextFormat)

Format teks dalam sel (kecuali diganti oleh operasi format). Menetapkan link tingkat sel di sini akan menghapus link sel yang ada. Menetapkan kolom link di TextFormatRun lebih diprioritaskan 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 spreadsheet akan digunakan jika diperlukan untuk jenis yang diberikan. 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 menggunakannya 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 Pemformatan 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 Batasnya berupa titik-titik.
DASHED Garis batas putus-putus.
SOLID Batas adalah garis utuh tipis.
SOLID_MEDIUM Batasnya adalah garis utuh sedang.
SOLID_THICK Batas adalah garis utuh tebal.
NONE Tanpa 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 diratakan ke bagian atas sel.
MIDDLE Teks secara eksplisit diratakan ke tengah sel.
BOTTOM Teks secara eksplisit diratakan ke bagian bawah sel.

WrapStrategy

Cara merapikan 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, perilaku ini sama dengan CLIP. Teks tidak akan pernah di-wrap ke baris berikutnya kecuali pengguna memasukkan baris baru secara manual. Contoh: 

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

Strategi pengepasan ini merepresentasikan strategi pengepasan Google Spreadsheet lama yang memotong kata-kata yang lebih panjang dari satu baris, bukan memecahnya. Strategi ini tidak didukung di semua platform dan akan dihentikan. Contoh: 

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

Baris yang lebih panjang dari lebar sel akan dipangkas. Teks tidak akan pernah di-wrap ke baris berikutnya kecuali pengguna memasukkan baris baru secara manual. Contoh: 

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

Kata-kata yang lebih panjang dari satu baris akan di-wrap di tingkat karakter, bukan dipangkas. 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 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 gabungan 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 mengarah ke atas, sudut negatif mengarah 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

Jalankan format teks. Format run ini berlanjut hingga indeks awal run berikutnya. Saat memperbarui, semua kolom harus ditetapkan.

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

integer

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

format

object (TextFormat)

Format run ini. Nilai yang tidak ada akan 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 dipenuhi oleh data dalam sel.

inputMessage

string

Pesan untuk ditampilkan kepada pengguna saat menambahkan data ke sel.

strict

boolean

Benar (True) jika data yang tidak valid harus ditolak.

showCustomUi

boolean

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

DataSourceTable

Tabel sumber data, yang memungkinkan pengguna mengimpor tabel data statis dari DataSource ke dalam Spreadsheet. Fitur 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 terkait 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)

Filter spesifikasi dalam tabel sumber data.

sortSpecs[]

object (SortSpec)

Urutkan spesifikasi dalam tabel sumber data. Hasil tabel sumber data diurutkan berdasarkan spesifikasi pengurutan dalam urutan.

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 pilihan kolom default, jangan gunakan.
SELECTED Pilih kolom yang ditentukan oleh columns kolom.
SYNC_ALL

Sinkronkan semua kolom saat ini dan mendatang di sumber data.

Jika disetel, 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

Jalannya chip. Chip berlanjut hingga indeks awal proses berikutnya.

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

integer

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

chip

object (Chip)

Opsional. Chip untuk proses 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 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 disetel, 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 resource Google (seperti file di Drive, video YouTube, alamat Maps, atau acara Kalender). Hanya file Drive yang dapat ditulis sebagai chip. Semua jenis link multimedia lainnya bersifat hanya baca.

URI tidak boleh melebihi 2.000 byte saat menulis.

CATATAN: Penulisan 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).