Cells

Hücresel Veri

Belirli bir hücreyle ilgili verilerdir.

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 olarak gösterilir.

effectiveValue

object (ExtendedValue)

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

formattedValue

string

Hücrenin biçimlendirilmiş değeri. Bu, kullanıcıya gösterildiği değerdir. Bu alan salt okunur durumdadır.

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ücrenin kullandığı etkin biçim. Bu, koşullu biçimlendirme uygulama ve hücrede formül bulunuyorsa hesaplanan sayı biçimini içerir. Geçerli biçim varsayılan biçimdeyse geçerli biçim yazılmaz. Bu alan salt okunur durumdadır.

note

string

Hücredeki herhangi bir not.

textFormatRuns[]

object (TextFormatRun)

Hücrenin alt bölümlerine uygulanan zengin metin çalıştırma işlemleri. Çalıştırmalar yalnızca kullanıcı tarafından girilen dizelerde geçerlidir; formüller, Boole'lar veya sayılar için geçerli değildir. Bir çalıştırmanın özellikleri, metindeki belirli bir dizinde başlar ve sonraki çalıştırmaya kadar devam eder. Çalıştırmalar, açıkça değiştirilmediği sürece hücrenin özelliklerini devralır.

Yeni çalıştırmalar yazılırken önceki çalıştırmaların üzerine yazılır. Yeni bir userEnteredValue yazılırken önceki çalıştırmalar silinir.

dataValidation

object (DataValidationRule)

Varsa hücredeki bir veri doğrulama kuralı.

Yeni veri doğrulama kuralı yazılırken önceki kuralların üzerine yazılır.

pivotTable

object (PivotTable)

Bu hücreye sabitlenmiş bir pivot tablo. Pivot tablonun boyutu, verileri, gruplaması, filtreleri, değerleri vb. temel alınarak dinamik olarak hesaplanır. Pivot tablonun yalnızca sol üst tarafındaki hücre, pivot tablonun tanımını içerir. Diğer hücreler, effectiveValue alanlarında pivot sonuçlara ait hesaplanan değerleri 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 bir şekilde hesaplanır. Veri kaynağı tablo tanımının yalnızca veri kaynağı tablosunun ilk hücresi vardır. Diğer hücreler, effectiveValue alan sonuçlarıyla sonuçlanan veri kaynağı tablosunun görüntüleme değerlerini içerir.

dataSourceFormula

object (DataSourceFormula)

Yalnızca çıkış. Hücredeki bir veri kaynağı formülü hakkında bilgi. Bu alan, userEnteredValue alanının bazı DATA_SOURCE sayfalarına (ör. =SUM(DataSheet!Column)) başvuruda bulunan bir formül olması durumunda ayarlanır.

Hücre Biçimi

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 sunulması gerektiğini açıklayan biçim.

backgroundColor
(deprecated)

object (Color)

Hücrenin arka plan rengi. Kullanımdan kaldırıldı: backgroundColorStyle özelliğini kullanın.

backgroundColorStyle

object (ColorStyle)

Hücrenin arka plan rengi. backgroundColor değeri de ayarlanırsa bu alan öncelikli olur.

borders

object (Borders)

Hücrenin kenarlıkları.

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 sarmalama stratejisi.

textDirection

enum (TextDirection)

Hücredeki metnin yönü.

textFormat

object (TextFormat)

Hücredeki metnin biçimi (biçim çalıştırma tarafından geçersiz kılınmadığı sürece). Burada hücre düzeyinde bir bağlantı belirlediğinizde hücrenin mevcut bağlantıları temizlenir. TextFormatRun içindeki bağlantı alanı, hücre düzeyindeki bağlantıya göre önceliklidir.

textRotation

object (TextRotation)

Hücredeki metne uygulanan döndürme.

Sayı Biçimi

Hücrenin sayı biçimi.

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

enum (NumberFormatType)

Sayı biçiminin türü. Yazma sırasında bu alan ayarlanmalıdır.

pattern

string

Biçimlendirme için kullanılan kalıp dizesi. Ayarlanmazsa belirli bir tür için gerekirse 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çimleri kılavuzuna bakın.

SayıBiçimTürü

Hücrenin sayı biçimi. Bu dokümanda yerel ayarın en_US olduğu varsayılmıştır, ancak gerçek biçim e-tablonun yerel ayarına bağlıdır.

Sıralamalar
NUMBER_FORMAT_TYPE_UNSPECIFIED Sayı biçimi belirtilmemiş ve hücrenin içeriğini temel alıyor. Bunu açıkça kullanmayın.
TEXT Metin biçimlendirme, ör.1000.12
NUMBER Sayı biçimlendirme, ör.1,000.12
PERCENT Yüzde biçimlendirme, ö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 kenarlıkları.

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 sınırı.

left

object (Border)

Hücrenin sol kenarlığı.

right

object (Border)

Hücrenin sağ kenarlığı.

Sınır

Hücre boyunca kenarlık.

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. Kullanımdan kaldırıldı. Genişlik "stil" alanına göre belirlenir.

color
(deprecated)

object (Color)

Kenarlık rengi. Kullanımdan kaldırıldı: colorStyle özelliğini kullanın.

colorStyle

object (ColorStyle)

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

Stil

Bir kenarlığın stili.

Sıralamalar
STYLE_UNSPECIFIED Stil belirtilmemiş. Bunu kullanmayın.
DOTTED Kenarlık noktalı.
DASHED Kenarlıklar kesikli.
SOLID Kenarlık ince bir düz çizgidir.
SOLID_MEDIUM Kenarlık orta kalınlıkta bir çizgidir.
SOLID_THICK Kenarlık kalın bir çizgiden oluşur.
NONE Kenarlık yok. Yalnızca bir kenarlık güncellenirken silinecek.
DOUBLE Kenarlık iki düz çizgiden oluşur.

Dolgu

Hücrenin etrafındaki piksel cinsinden dolgu miktarı. Dolgu güncellenirken 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ğ dolgusu.

bottom

integer

Hücrenin alt dolgusu.

left

integer

Hücrenin sol dolgusu.

Dikey Hizalama

Hücredeki metnin dikey hizalaması.

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

Sarmalama Stratejisi

Hücredeki metni kaydırma.

Sıralamalar
WRAP_STRATEGY_UNSPECIFIED Varsayılan değer, kullanılmaz.
OVERFLOW_CELL

Hücre genişliğinden uzun satırlar bir sonraki hücreye yazılır. Ancak söz konusu hücre boş olmalıdır. Bir sonraki hücre boş değilse bu davranış CLIP ile aynı şekilde davranır. Kullanıcı manuel olarak yeni bir satır eklemediği sürece metin bir 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 sarmalama stratejisi, bir satırdan uzun olan kelimeleri kırık yerine kısaltmak için kullanılan eski Google E-Tablolar sarmalama stratejisini temsil ediyor. Bu strateji tüm platformlarda desteklenmemektedir ve aşamalı olarak kullanımdan kaldırılmaktadır. Örnek:

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

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

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

Bir satırdan uzun olan kelimeler kesilerek değil karakter düzeyinde sarmalanır. Örnek:

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

Metin Yönü

Hücredeki metnin yönü.

Sıralamalar
TEXT_DIRECTION_UNSPECIFIED Metin yönü belirtilmedi. Bunu kullanmayın.
LEFT_TO_RIGHT Soldan sağa metin yönü kullanıcı tarafından ayarlandı.
RIGHT_TO_LEFT Sağdan sola metin yönü kullanıcı tarafından ayarlandı.

Köprü

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

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

Metin Rotasyonu

Hücredeki metne uygulanan rotasyon.

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. Dikey veya açılı rotasyon türü. type aşağıdakilerden yalnızca biri olabilir:
angle

integer

Standart yön ve 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ı doğru, negatif açı ise aşağı doğrudur.

Not: LTR metin yönü için pozitif açılar saat yönünün tersine, RTL için ise saat yönündedir

vertical

boolean

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

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

Metin Biçimi Çalıştır

Bir metin biçimi. Bu çalıştırmanın biçimi, bir sonraki çalıştırmanın başlangıç dizinine kadar devam eder. Güncelleme sırasında tüm alanlar ayarlanmalıdır.

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

integer

Bu çalıştırmanın başladığı, UTF-16 kod birimlerindeki sıfır karakterli karakter dizini.

format

object (TextFormat)

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

VeriGeçerliliği Kuralı

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ıyı gösteren mesaj.

strict

boolean

Geçersiz verilerin reddedilmesi gerekiyorsa doğru değerini döndürür.

showCustomUi

boolean

Kullanıcı arayüzünün koşul türüne göre özelleştirilmesi gerekiyorsa doğru değerini döndürür. Doğru ise "Liste" koşullarında bir açılır liste gösterilir.

Veri KaynağıTablosu

Kullanıcının DataSource tablosundaki verileri E-Tablolar'a aktarmasına olanak tanıyan bir veri kaynağı tablosu. Bu, E-Tablolar düzenleyicisinde "Çıkar" 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şkilendirildiği veri kaynağının kimliği.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

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

columns[]

object (DataSourceColumnReference)

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

filterSpecs[]

object (FilterSpec)

Veri kaynağı tablosundaki özellikleri filtreleyin.

sortSpecs[]

object (SortSpec)

Veri kaynağı tablosundaki spesifikasyonları sıralayın. Veri kaynağı tablosu, sıralama ölçütüne göre sıralanır.

rowLimit

integer

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

dataExecutionStatus

object (DataExecutionStatus)

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

Veri KaynağıTabloSütun Seçimi Türü

Veri kaynağı tablo sütunu seçim türleri.

Sıralamalar
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Varsayılan sütun seçimi türü; kullanma.
SELECTED columns alanı tarafından belirtilen sütunları seçin.
SYNC_ALL

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

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

Veri KaynağıFormülü

Veri kaynağı formülü.

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

string

Formülün ilişkilendirildiği veri kaynağının kimliği.

dataExecutionStatus

object (DataExecutionStatus)

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