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 verileri çift duyarlıklı sayı olarak gösterilir. serial number biçimindedir.

effectiveValue

object (ExtendedValue)

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

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çimlendirmenin ve hücrenin formül içeriyorsa hesaplanan sayı biçiminin uygulanmasının sonuçlarını içerir. Etkili biçim varsayılan biçimse etkili biçim yazılmaz. Bu alan salt okunurdur.

note

string

Hücredeki 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üller, bool'lar veya sayılar için geçerli değildir. Bir çalıştırmanın özellikleri, metindeki belirli bir dizinde başlar ve bir sonraki çalıştırmaya kadar devam eder. Çalıştırmalar, açıkça değiştirilmediği sürece hücrenin özelliklerini devralır.

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

dataValidation

object (DataValidationRule)

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

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

pivotTable

object (PivotTable)

Bu hücreye bağlı 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 tablo sonuçlarının hesaplanmış değerlerini effectiveValue. alanları.

dataSourceTable

object (DataSourceTable)

Bu hücreye bağlı 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ücresinde veri kaynağı tablosu tanımı bulunur. Diğer hücreler, effectiveValue. alanları.

dataSourceFormula

object (DataSourceFormula)

Yalnızca çıkış. Hücredeki bir veri kaynağı formülüyle ilgili bilgiler. Bu alan, şu durumlarda ayarlanır: userEnteredValue. bir formül olabilir DATA_SOURCE e-tablo, ör. =SUM(DataSheet!Column).

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

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

Hücrenin arka plan rengi. Eğer backgroundColor. ayarlandığında 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ğere ilişkin sarmalama stratejisi.

textDirection

enum (TextDirection)

Hücredeki metnin yönü.

textFormat

object (TextFormat)

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

textRotation

object (TextRotation)

Hücredeki metne uygulanan rotasyon.

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 kalıp 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. Bkz. Tarih ve Sayı Biçimleri kılavuzu bakın.

NumberFormatType

Hücrenin sayı biçimi. Bu dokümantasyonda 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ştir 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 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

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" girin.

color
(deprecated)

object (Color)

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

colorStyle

object (ColorStyle)

Kenarlığın rengi. Eğer color. ayarlandığında bu alan öncelikli olur.

Stil

Kenarlığın stili.

Sıralamalar
STYLE_UNSPECIFIED Stil belirtilmedi. Bunu kullanmayın.
DOTTED Kenarlık noktalı.
DASHED Kenarlık kesik çizgilidir.
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, düz bir çizgidir.
NONE Kenarlık yok. Yalnızca bir kenarlığı silmek amacıyla güncellenirken kullanılır.
DOUBLE Kenarlık iki düz çizgiden oluşuyor.

Dolgu

Hücrenin etrafındaki 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ğ 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ına açıkça hizalanır.

WrapStrategy

Hücredeki metin nasıl kaydırılır?

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

Hücre genişliğinden daha uzun olan satırlar, bir sonraki hücrede boş olduğu sürece, sonraki hücrede yazılır. Bir sonraki hücrenin üzerindeki hücre boş değilse bu, aşağıdaki gibi davranır: CLIP 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 kaydırma stratejisi, bir satırdan uzun olan kelimelerin bölünmek yerine kırpıldığı eski Google E-Tablolar kaydırma stratejisini temsil eder. Bu strateji tüm platformlarda desteklenmediği için kullanımdan kaldırılıyor. Ö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 hiçbir zaman sonraki satıra kaydırılmaz. Ö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 Sağdan sola metnin yönü kullanıcı tarafından ayarlandı.

HyperlinkDisplayType

Bir köprünün açıkça oluşturulup oluşturulmayacağı. Belirtilmezse köprüye bağlantı verilir.

Sıralamalar
LINKED Köprüler açık bir şekilde 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 Dikey veya açılı dönüş türü. 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ı doğru, negatif açılar aşağı doğru açıdı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

True (doğru) değerine ayarlanırsa 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 çalışması. 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

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

format

object (TextFormat)

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

Hücreye veri eklerken kullanıcıya gösterilen bir 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, "Listele" bir açılır liste görüntülenir.

DataSourceTable

Kullanıcının DataSource. E-Tablolar'a gönderebilirsiniz. Bu işlem "çıkarma" olarak da bilinir. açın.

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çilecek tür. Varsayılan değer: SELECTED

columns[]

object (DataSourceColumnReference)

Veri kaynağı tablosu için seçilen sütunlar. İlgili içeriği oluşturmak için kullanılan columnSelectionType. olmalıdır SELECTED.

filterSpecs[]

object (FilterSpec)

Veri kaynağı tablosundaki spesifikasyonları filtreleyin.

sortSpecs[]

object (SortSpec)

Veri kaynağı tablosundaki spesifikasyonları sıralayın. Veri kaynağı tablosunun sonucu, sıralama özelliklerine göre sıralı olarak 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 göz atın.

dataExecutionStatus

object (DataExecutionStatus)

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

DataSourceTableColumnSelectionType

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

Sıralamalar
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Varsayılan sütun seçimi türü; bunu kullanmayın.
SELECTED Belirtilen sütunları seç columns. girin.
SYNC_ALL

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

Bu parametre 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şkilendirildiği veri kaynağının kimliği.

dataExecutionStatus

object (DataExecutionStatus)

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