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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
Alanlar
userEnteredValue

object (ExtendedValue)

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

effectiveValue

object (ExtendedValue)

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

formattedValue

string

Hücrenin biçimlendirilmiş değeri. Bu, kullanıcılara 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 etkin biçim. Buna, koşullu biçimlendirme uygulamasının sonuçları ve hücrede formül varsa hesaplanan sayı biçimi dahildir. Etkili biçim, varsayılan biçimse etkili biçim yazılmaz. Bu alan salt okunurdur.

note

string

Hücreyle ilgili herhangi bir not.

textFormatRuns[]

object (TextFormatRun)

Hücrenin alt bölümlerine uygulanan zengin metin çalıştırmaları. Çalıştırmalar yalnızca kullanıcı tarafından girilen dizelerde geçerlidir. Formüllerde, boole değerlerinde veya sayılarda geçerli değildir. Bir çalıştırmanın özellikleri, metindeki belirli bir dizinden 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.

Yazma sırasında, yeni çalıştırmalar önceki çalıştırmaların üzerine yazılır. Yeni bir userEnteredValue yazarken önceki çalıştırmalar silinir.

dataValidation

object (DataValidationRule)

Hücrede veri doğrulama kuralı varsa.

Yazma sırasında yeni veri doğrulama kuralı, önceki kuralların üzerine yazar.

pivotTable

object (PivotTable)

Bu hücreye sabitlenmiş bir pivot tablo. Pivot tablonun boyutu, verilerine, gruplandırmasına, filtrelerine, değerlerine vb. göre dinamik olarak hesaplanır. Pivot tablo tanımını yalnızca pivot tablonun sol üst hücresi içerir. Diğer hücreler, pivot sonuçlarının hesaplanmış değerlerini effectiveValue alanlarında içerir.

dataSourceTable

object (DataSourceTable)

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

dataSourceFormula

object (DataSourceFormula)

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

chipRuns[]

object (ChipRun)

İsteğe bağlı. Hücrenin alt bölümlerine uygulanan çip çalıştırmaları. Bir çalıştırmanın özellikleri, metindeki belirli bir dizinden başlar ve sonraki çalıştırmaya kadar devam eder.

Okuma sırasında, çipli ve çipsiz tüm koşular dahil edilir. Çipli olmayan koşularda boş bir Chip olur.

Yazarken yalnızca çipli koşular dahil edilir. Çip içeren çalıştırmalar 1 uzunluğundadır ve kullanıcı tarafından girilen metinde "@" yer tutucu sembolüyle gösterilir. Yeni çalıştırmalar, önceki çalıştırmaların üzerine yazılır. Yeni bir userEnteredValue yazılması önceki çalıştırmaları siler.

CellFormat

Bir 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österilmesi gerektiğ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 da ayarlanmışsa 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ırması tarafından geçersiz kılınmadığı sürece). Burada hücre düzeyinde bir bağlantı ayarlamak, hücrenin mevcut bağlantılarını temizler. Bir TextFormatRun içinde 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

Bir 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. Ayarlanmamışsa, verilen tür için gerekirse e-tablonun yerel ayarına dayalı varsayılan bir desen kullanılır. Desteklenen kalıplar hakkında daha fazla bilgi için Tarih ve Sayı Biçimleri Kılavuzu'na bakın.

NumberFormatType

Hücrenin sayı biçimi. Bu dokümanda yerel ayarın en_US olduğu varsayılı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ğine göre belirleniyor. Bunu açıkça kullanmayın.
TEXT Metin biçimlendirme (ör.1000.12)
NUMBER Sayı biçimlendirmesi (ör. 1.000,00) 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, örneğin 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 kenarlığı.

left

object (Border)

Hücrenin sol kenarlığı.

right

object (Border)

Hücrenin sağ kenarlığı.

Kenarlık

Bir 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, "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ığın rengi. color da ayarlanmışsa bu alan öncelikli olur.

Stil

Kenarlığın stili.

Sıralamalar
STYLE_UNSPECIFIED Stil belirtilmemiş. Bunu kullanmayın.
DOTTED Kenarlık noktalı.
DASHED Kenarlık kesikli çizgili.
SOLID Kenarlık, ince bir düz ç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ığı silmek için güncellerken kullanılır.
DOUBLE Kenarlık iki düz çizgiden oluşur.

Dolgu

Hücrenin etrafındaki dolgu miktarı (piksel cinsinden). 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.

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, hücrenin ortasına açıkça hizalanır.
BOTTOM Metin, hücrenin en altına açıkça hizalanır.

WrapStrategy

Hücredeki metni kaydırma

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

Hücre genişliğinden uzun olan satırlar, bir sonraki hücre boş olduğu sürece bu hücreye yazılır. Bir 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 asla 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 daha uzun olan kelimelerin bölünmek yerine kırpıldığı eski Google E-Tablolar sarmalama 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 asla bir sonraki satıra kaydırılmaz. Örnek: 

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

Bir satırdan uzun 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 Kullanıcı tarafından soldan sağa metin yönü ayarlandı.
RIGHT_TO_LEFT Kullanıcı tarafından sağdan sola metin yönü ayarlandı.

HyperlinkDisplayType

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.

TextRotation

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
Birleşik 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 cinsinden ölçülür. Geçerli değerler -90 ile 90 arasındadır. Pozitif açılar yukarı, negatif açılar aşağı doğru eğimlidir.

Not: Soldan sağa metin yönü için pozitif açılar saat yönünün tersine, sağdan sola metin yönü için ise saat yönünde olur.

vertical

boolean

Doğruysa 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ıç 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 tabanlı karakter dizini.

format

object (TextFormat)

Bu çalıştırmanın biçimi. Olmayan 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

Kullanıcı hücreye veri eklerken gösterilecek mesaj.

strict

boolean

Geçersiz veriler reddedilmelidir.

showCustomUi

boolean

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

DataSourceTable

Kullanıcının DataSource verilerini E-Tablolar'a aktarmasına olanak tanıyan bir veri kaynağı tablosu. Bu işlev, 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ç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 filtre spesifikasyonları.

sortSpecs[]

object (SortSpec)

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

rowLimit

integer

Döndürülecek satır 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ğı tablo sütunu seçim türleri.

Sıralamalar
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Varsayılan sütun seçimi türü, kullanılmaz.
SELECTED columns alanı tarafından 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.

ChipRun

Bir çipin çalıştırılması. Çip, sonraki çalıştırmanın başlangıç dizinine kadar devam eder.

JSON gösterimi 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
Alanlar
startIndex

integer

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

chip

object (Chip)

İsteğe bağlı. Bu çalıştırmanın çipi.

Çip

Akıllı çip

JSON gösterimi 
{

  // 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.
}
Alanlar
Birleşik alan properties. Çipin özellikleri. properties aşağıdakilerden yalnızca biri olabilir:
personProperties

object (PersonProperties)

Bağlı bir kişinin özellikleri.

PersonProperties

Bağlı bir kişiye özgü özellikler.

JSON gösterimi 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
Alanlar
email

string

Zorunlu. Bu kişiyle bağlantılı e-posta adresi. Bu alan her zaman mevcuttur.

displayFormat

enum (DisplayFormat)

İsteğe bağlı. Kişi çipinin görüntüleme biçimi. Ayarlanmazsa varsayılan görüntüleme biçimi kullanılır.

DisplayFormat

Mevcut olduğunda tercih edilen gösterim biçimi.

Sıralamalar
DISPLAY_FORMAT_UNSPECIFIED Varsayılan değer, kullanmayın.
DEFAULT Varsayılan görüntüleme biçimi.
LAST_NAME_COMMA_FIRST_NAME Soyadı, adı görüntüleme biçimi.
EMAIL E-posta görüntüleme biçimi.

RichLinkProperties

Google kaynağına (ör. Drive'daki bir dosya, YouTube videosu, Haritalar adresi veya Takvim etkinliği) ait bağlantının özellikleri. Yalnızca Drive dosyaları çip olarak yazılabilir. Diğer tüm zengin bağlantı türleri salt okunurdur.

URI'ler yazılırken 2.000 baytı aşamaz.

NOT: Drive dosyası çipleri yazmak için en az bir drive.file, drive.readonly veya drive OAuth kapsamı gerekir.

JSON gösterimi 
{
  "uri": string,
  "mimeType": string
}
Alanlar
uri

string

Zorunlu. Bağlantının URI'si. Bu her zaman mevcuttur.

mimeType

string

Yalnızca çıkış. Bağlantının MIME türü (varsa) (örneğin, Drive'daki bir dosya söz konusu olduğunda).