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. Ör. 1234, 'Hello' veya =NOW() Not: Tarihler, saatler ve tarih/saatler serial number biçiminde çift değer olarak temsil edilir.

effectiveValue

object (ExtendedValue)

Hücrenin etkin değeri. Formül içeren hücreler için bu, hesaplanan değerdir. Değişken olmayan değerler içeren hücreler için bu değer, 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 okunur.

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, koşullu biçimlendirmenin uygulanmasının sonuçları ve hücre bir formül içeriyorsa hesaplanan sayı biçimini 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 işlemi sırasında yeni çalıştırmalar, önceki çalıştırmaları geçersiz kılar. Yeni bir userEnteredValue yazılırken önceki çalıştırmalar silinir.

dataValidation

object (DataValidationRule)

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

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, verilerine, gruplandırmasına, filtrelerine, değerlerine vb. göre dinamik olarak hesaplanır. Pivot tablo tanımı yalnızca pivot tablonun sol üst hücresinde bulunur. 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 göre dinamik olarak hesaplanır. Veri kaynağı tablosunun tanımı yalnızca tablonun ilk hücresinde bulunur. Diğer hücreler, veri kaynağı tablosunun sonucunun görüntüleme değerlerini kendi effectiveValue alanlarında içerir.

dataSourceFormula

object (DataSourceFormula)

Yalnızca çıkış. Hücredeki bir 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.

chipRuns[]

object (ChipRun)

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

Okuma sırasında, çipli ve çipsiz tüm koşular dahil edilir. Çip takılı olmayan koşular için Chip boş olur.

Yazarken yalnızca çip içeren koşular dahil edilir. Çip içeren koşular 1 uzunluktadır ve kullanıcı tarafından girilen metinde "@" yer tutucu simgesiyle temsil edilir. Yeni çalıştırmalar, önceki çalıştırmaları geçersiz kılar. Yeni bir userEnteredValue yazdırıldığında önceki çalıştırmalar silinir.

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. Kullanımdan kaldırıldı: backgroundColorStyle kullanın.

backgroundColorStyle

object (ColorStyle)

Hücrenin arka plan rengi. backgroundColor parametresi de 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. Bağlantı alanını bir TextFormatRun hücresinde ayarlamak, 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. Ayarlanmazsa belirli bir tür için gerekli olduğunda kullanıcının yerel ayarına göre 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ık rengi. Kullanımdan kaldırıldı: colorStyle kullanın.

colorStyle

object (ColorStyle)

Kenarlık rengi. color parametresi de ayarlanmışsa 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 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ığı güncellerken silmek için kullanılır.
DOUBLE Kenarlık iki düz çizgiden oluşur.

Dolgu

Hücrenin etrafındaki dolgu miktarı (piksel cinsinden). 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ğ 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 hizalanır.
MIDDLE Metin, 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 bir sonraki satıra sarmalanmaz. Ö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

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 Metin yönü soldan sağa olarak 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

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 yalnızca aşağıdakilerden 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 açılır.

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ü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 eklenirken kullanıcıya gösterilecek 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çerken kullanılacak 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 özellikleri. 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 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.

ChipRun

Bir çipin çalışması. Çip, sonraki çalıştırmanın başlangıç dizine kadar devam eder.

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

integer

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

chip

object (Chip)

İsteğe bağlıdır. Bu koşunun ç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
Birlik alanı properties. Çipin özellikleri. properties yalnızca aşağıdakilerden 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şiye bağlı e-posta adresi. Bu alan her zaman mevcuttur.

displayFormat

enum (DisplayFormat)

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

DisplayFormat

Mümkün olduğunda tercih edilen görüntüleme biçimi.

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

RichLinkProperties

Bir 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 dosya çipleri yazmak için drive.file, drive.readonly veya drive OAuth kapsamlarından en az biri gereklidir.

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ış. Varsa bağlantının MIME türü (ör. Drive'daki bir dosya olduğunda).