Cells

CellData

Belirli bir hücreyle ilgili veriler.

JSON gösterimi
{
  "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)
  }
}
Alanlar
userEnteredValue

object (ExtendedValue)

Kullanıcının hücreye girdiği değer. Ör. 1234, 'Hello' veya =NOW() Not: Tarihler, Saatler ve Tarih Saatler, serial number biçiminde çift sayı olarak gösterilir.

effectiveValue

object (ExtendedValue)

Hücrenin etkili değeri. Formül içeren hücreler için bu, hesaplanan değerdir. Değişmez değer içeren hücreler için bu, userEnteredValue ile aynıdır. Bu alan salt okunur.

formattedValue

string

Hücrenin biçimlendirilmiş değeri. Bu, kullanıcıya gösterilen değerdir. Bu alan salt okunurdur.

userEnteredFormat

object (CellFormat)

Kullanıcının hücre için girdiği biçim.

Yazarken yeni biçim mevcut biçimle birleştirilir.

effectiveFormat

object (CellFormat)

Hücre tarafından kullanılan etkili biçim. Bu, herhangi bir koşullu biçimlendirme uygulamanın sonuçlarını ve hücre bir formül içeriyorsa hesaplanan sayı biçimini de içerir. Etkili biçim varsayılan biçimse etkili biçim yazılmaz. Bu alan salt okunur.

note

string

Hücreyle ilgili notlar.

textFormatRuns[]

object (TextFormatRun)

Hücrenin alt bölümlerine uygulanan zengin metin akışları. Çalıştırmalar yalnızca kullanıcı tarafından girilen dizelerde geçerlidir, formüller, doğru/yanlış değerler veya sayılarda geçerli değildir. Bir çalıştırmanın özellikleri metindeki belirli bir dizinden başlar ve bir sonraki çalıştırmaya kadar devam eder. Açıkça değiştirilmediği sürece koşullu çalıştırmalar, hücrenin özelliklerini devralır.

Yazma sırasında yeni çalıştırmalar, önceki çalıştırmaları geçersiz kılar. Yeni bir userEnteredValue yazarken önceki çalıştırmalar silinir.

dataValidation

object (DataValidationRule)

Hücredeki veri doğrulama kuralı (varsa).

Yazma işlemi sırasında yeni veri doğrulama kuralı, önceki kuralların üzerine yazılır.

pivotTable

object (PivotTable)

Bu hücreye sabitlenmiş bir pivot tablo. Pivot tablonun boyutu, ilgili veriler, gruplandırma, filtreler, değerler vb. temel alınarak dinamik olarak hesaplanır. Pivot tablonun tanımı, yalnızca sol üstteki hücrede yer alır. Diğer hücreler, pivot sonuçlarının hesaplanmış değerlerini kendi effectiveValue alanlarında içerir.

dataSourceTable

object (DataSourceTable)

Bu hücreye sabitlenmiş bir veri kaynağı tablosu. Veri kaynağı tablosunun boyutu, yapılandırmasına bağlı olarak dinamik olarak hesaplanır. Veri kaynağı tablosunun yalnızca ilk hücresi veri kaynağı tablosu tanımını içerir. Diğer hücreler, effectiveValue alanlarında veri kaynağı tablosu sonucunun görünen değerlerini içerir.

dataSourceFormula

object (DataSourceFormula)

Yalnızca çıkış. Hücredeki veri kaynağı formülü hakkında bilgi. userEnteredValue, bir DATA_SOURCE sayfasına (ör. =SUM(DataSheet!Column)) referans veren bir formül ise alan ayarlanır.

CellFormat

Hücrenin biçimi.

JSON gösterimi
{
  "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)
  }
}
Alanlar
numberFormat

object (NumberFormat)

Sayı değerlerinin kullanıcıya nasıl gösterileceğini açıklayan bir biçim.

backgroundColor
(deprecated)

object (Color)

Hücrenin arka plan rengi. Desteği sonlandırıldı: backgroundColorStyle kullanın.

backgroundColorStyle

object (ColorStyle)

Hücrenin arka plan rengi. backgroundColor politikası da ayarlanmışsa bu alan öncelikli olur.

borders

object (Borders)

Hücrenin kenarları.

padding

object (Padding)

Hücrenin dolgusu.

horizontalAlignment

enum (HorizontalAlign)

Hücredeki değerin yatay hizalaması.

verticalAlignment

enum (VerticalAlign)

Hücredeki değerin dikey hizalaması.

wrapStrategy

enum (WrapStrategy)

Hücredeki değer için sarma stratejisi.

textDirection

enum (TextDirection)

Hücredeki metnin yönü.

textFormat

object (TextFormat)

Hücredeki metnin biçimi (bir biçimlendirme çalıştırması tarafından geçersiz kılınmadığı sürece). Burada hücre düzeyinde bir bağlantı ayarladığınızda hücrenin mevcut bağlantıları silinir. TextFormatRun öğesinde bağlantı alanının ayarlanması, hücre düzeyindeki bağlantıya göre önceliklidir.

textRotation

object (TextRotation)

Hücredeki metne uygulanan döndürme.

NumberFormat

Hücrenin sayı biçimi.

JSON gösterimi
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Alanlar
type

enum (NumberFormatType)

Sayı biçiminin türü. Yazarken bu alan ayarlanmalıdır.

pattern

string

Biçimlendirme için kullanılan desen dizesi. Politika ayarlanmazsa belirtilen tür için gerekiyorsa kullanıcının yerel ayarına dayalı varsayılan bir kalıp kullanılır. Desteklenen kalıplar hakkında daha fazla bilgi için Tarih ve Sayı Biçimlendirme Kılavuzu'na bakın.

NumberFormatType

Hücrenin sayı biçimi. Bu dokümanda yerel dilin en_US olduğu varsayılır ancak gerçek biçim, e-tablonun yerel diline bağlıdır.

Sıralamalar
NUMBER_FORMAT_TYPE_UNSPECIFIED Sayı biçimi belirtilmez ve hücrenin içeriğine bağlıdır. Bunu açıkça kullanmayın.
TEXT Metin biçimlendirmesi (ör.1000.12
NUMBER Sayı biçimlendirmesi (ör.1,000.12
PERCENT Yüzde biçimlendirmesi, ör.10.12%
CURRENCY Para birimi biçimlendirmesi, ör.$1,000.12
DATE Tarih biçimlendirmesi (ör.9/26/2008)
TIME Saat biçimlendirmesi, ör.3:59:00 PM
DATE_TIME Tarih+Saat biçimlendirmesi, ör.9/26/08 15:59:00
SCIENTIFIC Bilimsel sayı biçimlendirmesi (ör.1.01E+03)

Kenarlıklar

Hücrenin kenarları.

JSON gösterimi
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Alanlar
top

object (Border)

Hücrenin üst kenarlığı.

bottom

object (Border)

Hücrenin alt kenarlığı.

left

object (Border)

Hücrenin sol kenarlığı.

right

object (Border)

Hücrenin sağ kenarlığı.

Kenarlık

Hücre kenarı.

JSON gösterimi
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Alanlar
style

enum (Style)

Kenarlığın stili.

width
(deprecated)

integer

Kenarlığın piksel cinsinden genişliği. Desteği sonlandırıldı; genişlik "style" alanına göre belirlenir.

color
(deprecated)

object (Color)

Kenarlığın rengi. Desteği sonlandırıldı: colorStyle kullanın.

colorStyle

object (ColorStyle)

Kenarlık rengi. color de ayarlanırsa bu alan öncelikli olur.

Stil

Kenarlık stili.

Sıralamalar
STYLE_UNSPECIFIED Stil belirtilmemiş. Bunu kullanmayın.
DOTTED Kenarlık noktalı.
DASHED Kenarlık noktalı.
SOLID Kenarlık ince, düz bir çizgidir.
SOLID_MEDIUM Kenarlık, orta kalınlıkta düz bir çizgidir.
SOLID_THICK Kenarlık kalın bir düz çizgidir.
NONE Kenarlık yok. Yalnızca bir kenarlığı güncellerken silmek için kullanılır.
DOUBLE Kenarlık iki düz çizgiden oluşur.

Dolgu

Hücrenin çevresindeki dolgunun piksel cinsinden miktarı. Dolguyu güncellerken her alan belirtilmelidir.

JSON gösterimi
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Alanlar
top

integer

Hücrenin üst dolgusu.

right

integer

Hücrenin sağdaki dolgusu.

bottom

integer

Hücrenin alt dolgusu.

left

integer

Hücrenin sol dolgusu.

VerticalAlign

Hücredeki metnin dikey hizalaması.

Sıralamalar
VERTICAL_ALIGN_UNSPECIFIED Dikey hizalama belirtilmemiş. Bunu kullanmayın.
TOP Metin, hücrenin üst kısmına açıkça hizalanır.
MIDDLE Metin, açıkça hücrenin ortasına hizalanır.
BOTTOM Metin, hücrenin alt kısmına hizalanır.

WrapStrategy

Hücredeki metni kaydırma.

Sıralamalar
WRAP_STRATEGY_UNSPECIFIED Varsayılan değerdir, kullanmayın.
OVERFLOW_CELL

Hücre genişliğinden uzun olan satırlar, boş olduğu sürece bir sonraki hücreye yazılır. Sonraki hücre boş değilse bu işlev CLIP ile aynı şekilde çalışır. Kullanıcı manuel olarak yeni bir satır eklemediği sürece metin hiçbir zaman sonraki satıra kaydırılmaz. Örnek:

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

Bu satır sonlandırma stratejisi, bir satırdan uzun kelimelerin bölünmek yerine kırpıldığı eski Google E-Tablolar satır sonlandırma stratejisini temsil eder. Bu strateji tüm platformlarda desteklenmez ve kullanımdan kaldırılmaktadır. Örnek:

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

Hücre genişliğinden uzun olan satırlar kırpılır. Kullanıcı manuel olarak yeni bir satır eklemediği sürece metin hiçbir zaman bir sonraki satıra sarmalanmaz. Örnek:

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

Satırdan uzun olan kelimeler kırpılmak yerine karakter düzeyinde kaydırılır. Örnek:

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

TextDirection

Hücredeki metnin yönü.

Sıralamalar
TEXT_DIRECTION_UNSPECIFIED Metin yönü belirtilmemiş. Bunu kullanmayın.
LEFT_TO_RIGHT Metin yönü soldan sağa, kullanıcı tarafından ayarlandı.
RIGHT_TO_LEFT Metin yönü sağdan sola olarak kullanıcı tarafından ayarlandı.

HyperlinkDisplayType

Bir köprünün açıkça oluşturulup oluşturulmayacağı. Belirtilmemişse köprü bağlanır.

Sıralamalar
LINKED Köprüler açıkça oluşturulmalıdır.
PLAIN_TEXT Köprü oluşturulmamalıdır.

TextRotation

Bir hücredeki metne uygulanan döndürme.

JSON gösterimi
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Alanlar
Birlik alanı type. Dönüş türü (dikey veya açılı). type aşağıdakilerden yalnızca biri olabilir:
angle

integer

Standart yön ile istenen yön arasındaki açı. Derece olarak ölçülür. Geçerli değerler -90 ile 90 arasındadır. Pozitif açılar yukarı, negatif açılar aşağı doğru açılır.

Not: LTR metin yönü için pozitif açılar saat yönünün tersine, sağdan sola yönündedir.

vertical

boolean

Doğru ise metin yukarıdan aşağıya doğru okunur ancak tek tek karakterlerin yönü değişmez. Örneğin:

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

TextFormatRun

Metin biçiminin bir çalışması. Bu çalıştırmanın biçimi, sonraki çalıştırmanın başlangıç dizine kadar devam eder. Güncelleme yapılırken tüm alanlar ayarlanmalıdır.

JSON gösterimi
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
Alanlar
startIndex

integer

Bu çalıştırmanın başladığı sıfır tabanlı karakter dizini (UTF-16 kod birimleri).

format

object (TextFormat)

Bu çalıştırmanın biçimi. Eksik değerler, hücrenin biçimini devralır.

DataValidationRule

Veri doğrulama kuralı.

JSON gösterimi
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Alanlar
condition

object (BooleanCondition)

Hücredeki verilerin eşleşmesi gereken koşul.

inputMessage

string

Hücreye veri eklerken kullanıcıya gösterilen bir mesaj.

strict

boolean

Geçersiz verilerin reddedilmesi gerekiyorsa doğru değerini alır.

showCustomUi

boolean

Kullanıcı arayüzü, koşulun türüne göre özelleştirilecekse doğru değerini döndürür. Doğru ise "Liste" koşulları için bir açılır menü gösterilir.

DataSourceTable

Kullanıcının DataSource veri kaynağından E-Tablolar'a statik bir veri tablosu aktarmasına olanak tanıyan veri kaynağı tablosu. Bu işlem, E-Tablolar düzenleyicisinde "Ayıkla" olarak da bilinir.

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

string

Veri kaynağı tablosunun ilişkili olduğu veri kaynağının kimliği.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Veri kaynağı tablosu için sütun seçilecek tür. Varsayılan olarak SELECTED değerine ayarlanır.

columns[]

object (DataSourceColumnReference)

Veri kaynağı tablosu için seçilen sütunlar. columnSelectionType olmalıdır. SELECTED

filterSpecs[]

object (FilterSpec)

Veri kaynağı tablosundaki özellikleri filtreleyin.

sortSpecs[]

object (SortSpec)

Veri kaynağı tablosundaki özellikleri sıralama Veri kaynağı tablosunun sonucu, sıralama özelliklerine göre sıralanır.

rowLimit

integer

Döndürülecek satır sayısı sınırı. Ayarlanmazsa varsayılan bir sınır uygulanır. Varsayılan ve maksimum sınır için lütfen E-Tablolar düzenleyicisine bakın.

dataExecutionStatus

object (DataExecutionStatus)

Yalnızca çıkış. Veri yürütme durumu.

DataSourceTableColumnSelectionType

Veri kaynağı tablosu sütun seçim türleri.

Sıralamalar
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Varsayılan sütun seçimi türü. Kullanmayın.
SELECTED columns alanına göre belirtilen sütunları seçin.
SYNC_ALL

Veri kaynağındaki mevcut ve gelecekteki tüm sütunları senkronize edin.

Ayarlanırsa veri kaynağı tablosu, yenileme sırasında veri kaynağındaki tüm sütunları getirir.

DataSourceFormula

Veri kaynağı formülü.

JSON gösterimi
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Alanlar
dataSourceId

string

Formülün ilişkili olduğu veri kaynağının kimliği.

dataExecutionStatus

object (DataExecutionStatus)

Yalnızca çıkış. Veri yürütme durumu.