Sayfa
E-tablodaki bir sayfa.
| JSON gösterimi |
|---|
{ "properties": { object ( |
| Alanlar | |
|---|---|
properties
|
Sayfanın özellikleri. |
data[]
|
Izgara tablosuysa ızgaradaki veriler.
Döndürülen GridData nesnelerinin sayısı, bu sayfada istenen aralıkların sayısına bağlıdır. Örneğin, bu
|
merges[]
|
Birleştirilen aralıklar. |
conditionalFormats[]
|
Bu sayfadaki koşullu biçimlendirme kuralları. |
filterViews[]
|
Bu sayfadaki filtre görünümleri. |
protectedRanges[]
|
Bu sayfadaki korunan aralıklar. |
basicFilter
|
Bu sayfadaki filtre (varsa). |
charts[]
|
Bu sayfadaki her grafiğin özellikleri. |
bandedRanges[]
|
Bu sayfadaki bantlı (alternatif renkler) aralıklar. |
developerMetadata[]
|
Bir sayfayla ilişkili geliştirici meta verileri. |
rowGroups[]
|
Bu sayfadaki tüm satır grupları, önce artan aralık başlangıç dizinine, ardından grup derinliğine göre sıralanır. |
columnGroups[]
|
Bu sayfadaki tüm sütun grupları, önce artan aralık başlangıç dizinine, ardından grup derinliğine göre sıralanır. |
slicers[]
|
Bu sayfadaki dilimleyiciler. |
tables[]
|
Bu sayfadaki tablolar. |
SheetProperties
Sayfanın özellikleri.
| JSON gösterimi |
|---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
| Alanlar | |
|---|---|
sheetId
|
Sayfanın kimliği. Negatif olmamalıdır. Bu alan, ayarlandıktan sonra değiştirilemez. |
title
|
Sayfanın adı. |
index
|
E-tablodaki sayfanın dizini. Sayfa özellikleri eklenirken veya güncellenirken bu alan hariç tutulursa sayfa, sayfa listesinin sonuna eklenir veya taşınır. Sayfa dizinleri güncellenirken veya sayfalar eklenirken hareket, "taşımadan önceki" dizinlerde dikkate alınır. Örneğin, üç sayfa (S1, S2, S3) varsa S1'i S2'nin önüne taşımak için dizinin 2 olarak ayarlanması gerekir. İstenen dizin, mevcut sayfa diziniyle aynıysa veya istenen yeni dizin, mevcut sayfa dizini + 1'e eşitse sayfa dizini güncelleme isteği yoksayılır. |
sheetType
|
Sayfanın türü. Varsayılan olarak |
gridProperties
|
Bu sayfa bir kılavuzsa sayfanın ek özellikleri. (Sayfa, grafik veya resim içeren bir nesne sayfasıysa bu alan bulunmaz.) Yazarken, ızgara olmayan sayfalarda ızgara özelliklerini ayarlamak hatadır.
Bu sayfa bir |
tabColor
|
Kullanıcı arayüzünde sekmenin rengi. Desteği sonlandırıldı: |
tabColorStyle
|
Kullanıcı arayüzünde sekmenin rengi. |
rightToLeft
|
Sayfa soldan sağa yerine sağdan sola ise doğru. |
dataSourceSheetProperties
|
Yalnızca çıkış. Varsa alan, |
SheetType
Sayfanın türü.
| Sıralamalar | |
|---|---|
SHEET_TYPE_UNSPECIFIED
|
Varsayılan değer, kullanmayın. |
GRID
|
Sayfa bir ızgaradır. |
OBJECT
|
Sayfada ızgara yoktur ve bunun yerine grafik veya resim gibi bir nesne vardır. |
DATA_SOURCE
|
Sayfa harici bir
DataSource
ile bağlanır ve verilerin önizlemesini gösterir.
|
GridProperties
Izgaranın özellikleri.
| JSON gösterimi |
|---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
| Alanlar | |
|---|---|
rowCount
|
Tablodaki satır sayısı. |
columnCount
|
Tablodaki sütun sayısı. |
frozenRowCount
|
Tabloda dondurulan satır sayısı. |
frozenColumnCount
|
Tabloda dondurulmuş sütun sayısı. |
hideGridlines
|
Izgara, kullanıcı arayüzünde kılavuz çizgilerini göstermiyorsa doğru değerini döndürür. |
rowGroupControlAfter
|
Satır gruplandırma kontrolü açma/kapatma düğmesi gruptan sonra gösteriliyorsa doğru. |
columnGroupControlAfter
|
Sütun gruplandırma denetimi açma/kapatma düğmesi gruptan sonra gösteriliyorsa doğru. |
DataSourceSheetProperties
Bir DATA_SOURCE
sayfasının ek özellikleri.
| JSON gösterimi |
|---|
{ "dataSourceId": string, "columns": [ { object ( |
| Alanlar | |
|---|---|
dataSourceId
|
Sayfanın bağlı olduğu
|
columns[]
|
E-tabloda gösterilen sütunlar, |
dataExecutionStatus
|
Veri yürütme durumu. |
GridData
Izgaradaki verilerin yanı sıra boyutlarla ilgili meta veriler.
| JSON gösterimi |
|---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
| Alanlar | |
|---|---|
startRow
|
Bu GridData'nın başvurduğu ilk satır (sıfır tabanlı). |
startColumn
|
Bu GridData'nın başvurduğu ilk sütun (sıfır tabanlı). |
rowData[]
|
Izgaradaki veriler. startRow satırından başlayarak her satırda bir giriş bulunur. RowData'daki değerler, |
rowMetadata[]
|
Izgaradaki istenen satırlarla ilgili meta veriler. |
columnMetadata[]
|
Izgaradaki istenen sütunlarla ilgili meta veriler ( |
RowData
Bir satırdaki her hücreyle ilgili veriler.
| JSON gösterimi |
|---|
{
"values": [
{
object ( |
| Alanlar | |
|---|---|
values[]
|
Satırdaki değerler (sütun başına bir değer). |
DimensionProperties
Bir boyutla ilgili özellikler.
| JSON gösterimi |
|---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
| Alanlar | |
|---|---|
pixelSize
|
Boyutun piksel cinsinden yüksekliği (satırsa) veya genişliği (sütunsa). |
developerMetadata[]
|
Tek bir satır veya sütunla ilişkili geliştirici meta verileri. |
dataSourceColumnReference
|
Yalnızca çıkış. Ayarlanmışsa bu, bir veri kaynağı sayfasındaki sütundur. |
ConditionalFormatRule
Koşullu biçimi açıklayan bir kural.
| JSON gösterimi |
|---|
{ "ranges": [ { object ( |
| Alanlar | |
|---|---|
ranges[]
|
Koşul doğruysa biçimlendirilen aralıklar. Tüm aralıklar aynı kılavuzda olmalıdır. |
Birleşik alan
rule. Bu koşullu biçimi kontrol eden kural. Tam olarak bir tane ayarlanmalıdır.
rule
aşağıdakilerden yalnızca biri olabilir:
|
|
booleanRule
|
Biçimlendirme, kurala göre "açık" veya "kapalı" olur. |
gradientRule
|
Biçimlendirme, kuraldaki gradyanlara göre değişir. |
BooleanRule
Koşula bağlı olarak eşleşebilen veya eşleşemeyen bir kural.
| JSON gösterimi |
|---|
{ "condition": { object ( |
| Alanlar | |
|---|---|
condition
|
Kuralın durumu. Koşul doğru olarak değerlendirilirse biçim uygulanır. |
format
|
Uygulanacak biçim. Koşullu biçimlendirme yalnızca biçimlendirmenin bir alt kümesini uygulayabilir:
|
GradientRule
Listelenen enterpolasyon noktalarına göre gradyan renk ölçeği biçimi uygulayan bir kural. Bir hücrenin biçimi, enterpolasyon noktalarının değerlerine kıyasla içeriğine göre değişir.
| JSON gösterimi |
|---|
{ "minpoint": { object ( |
| Alanlar | |
|---|---|
minpoint
|
Başlangıç interpolasyon noktası. |
midpoint
|
İsteğe bağlı bir ara enterpolasyon noktası. |
maxpoint
|
Son enterpolasyon noktası. |
InterpolationPoint
Gradyan koşullu biçimindeki tek bir enterpolasyon noktası. Bu seçenekler, seçilen renge, türe ve değere göre gradyan renk ölçeğini sabitler.
| JSON gösterimi |
|---|
{ "color": { object ( |
| Alanlar | |
|---|---|
color
|
Bu enterpolasyon noktasının kullanması gereken renk. Desteği sonlandırıldı: |
colorStyle
|
Bu enterpolasyon noktasının kullanması gereken renk. |
type
|
Değerin nasıl yorumlanması gerektiği. |
value
|
Bu interpolasyon noktasının kullandığı değer. Formül olabilir. |
InterpolationPointType
İnterpolasyon noktasının türü.
| Sıralamalar | |
|---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Varsayılan değerdir, kullanılmaz. |
MIN
|
İnterpolasyon noktası, koşullu biçimin aralığındaki hücrelerdeki minimum değeri kullanır. |
MAX
|
İnterpolasyon noktası, koşullu biçim aralığındaki hücrelerdeki maksimum değeri kullanır. |
NUMBER
|
İnterpolasyon noktası, InterpolationPoint.value içindeki değeri tam olarak kullanır.
|
PERCENT
|
İnterpolasyon noktası, koşullu biçim aralığındaki tüm hücreler için verilen yüzdedir. Bu, değer:
|
PERCENTILE
|
İnterpolasyon noktası, koşullu biçim aralığındaki tüm hücreler için verilen yüzdelik dilimdir. Bu, değer şu olduğunda:
NUMBER
=PERCENTILE(FLATTEN(range), value / 100)
ile eşdeğerdir (aralıktaki hatalar düzleştirme sırasında yoksayılır).
|
FilterView
Filtre görünümü Daha fazla bilgi için Filtrelerle veri görünürlüğünü yönetme başlıklı makaleyi inceleyin.
| JSON gösterimi |
|---|
{ "filterViewId": integer, "title": string, "range": { object ( |
| Alanlar | |
|---|---|
filterViewId
|
Filtre görünümünün kimliği. |
title
|
Filtre görünümünün adı. |
range
|
Bu filtre görünümünün kapsadığı aralık.
Yazarken yalnızca |
namedRangeId
|
Bu filtre görünümünün desteklediği adlandırılmış aralık (varsa).
Yazarken yalnızca |
tableId
|
Bu filtre görünümünün desteklendiği tablo (varsa).
Yazarken yalnızca |
sortSpecs[]
|
Sütun başına sıralama düzeni. Önceki spesifikasyonlardaki değerler eşit olduğunda sonraki spesifikasyonlar kullanılır. |
criteria
|
Sütun başına değerleri gösterme/gizleme ölçütleri. Haritanın anahtarı sütun dizini, değeri ise ilgili sütunun ölçütüdür.
Bu alan kullanımdan kaldırılmış, yerine |
filterSpecs[]
|
Sütun başına değerleri gösterme veya gizleme için kullanılan filtre ölçütleri.
Yanıtlar hem
|
ProtectedRange
Korumalı aralık
| JSON gösterimi |
|---|
{ "protectedRangeId": integer, "range": { object ( |
| Alanlar | |
|---|---|
protectedRangeId
|
Korumalı aralığın kimliği. Bu alan salt okunurdur. |
range
|
Korunan aralık. Aralık tamamen sınırsız olabilir. Bu durumda, aralık korumalı sayfa olarak kabul edilir.
Yazarken yalnızca |
namedRangeId
|
Bu korumalı aralığın desteklediği adlandırılmış aralık (varsa).
Yazarken yalnızca |
tableId
|
Bu korumalı aralığın desteklediği tablo (varsa).
Yazarken yalnızca |
description
|
Bu korumalı aralığın açıklaması. |
warningOnly
|
Bu korumalı aralık düzenlenirken uyarı gösterilecekse doğru (True). Uyarı tabanlı koruma, korunan aralıktaki verilerin her kullanıcı tarafından düzenlenebileceği anlamına gelir. Ancak düzenleme işlemi, kullanıcıdan düzenlemeyi onaylamasını isteyen bir uyarıya neden olur.
Yazma sırasında: Bu alan doğruysa |
requestingUserCanEdit
|
Bu korunan aralığı isteyen kullanıcının korunan alanı düzenleyebilmesi durumunda doğru. Bu alan salt okunurdur. |
unprotectedRanges[]
|
Korumalı bir sayfadaki korumasız aralıkların listesi. Korumalı olmayan aralıklar yalnızca korumalı sayfalarda desteklenir. |
editors
|
Korumalı aralığa düzenleme erişimi olan kullanıcılar ve gruplar. Bu alan yalnızca korumalı aralığa ve belgeye düzenleme erişimi olan kullanıcılar tarafından görülebilir. Düzenleyiciler, |
Editörler
Korumalı aralığın düzenleyicileri.
| JSON gösterimi |
|---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
| Alanlar | |
|---|---|
users[]
|
Korumalı aralığı düzenleme erişimi olan kullanıcıların e-posta adresleri. |
groups[]
|
Korunan aralığı düzenleme erişimi olan grupların e-posta adresleri. |
domainUsersCanEdit
|
Belgenin alanındaki herhangi bir kullanıcının korunan aralığa düzenleme erişimi varsa DOĞRU. Alan koruması yalnızca bir alan içindeki dokümanlarda desteklenir. |
BasicFilter
Bir sayfayla ilişkili varsayılan filtre. Daha fazla bilgi için Filtrelerle veri görünürlüğünü yönetme başlıklı makaleyi inceleyin.
| JSON gösterimi |
|---|
{ "range": { object ( |
| Alanlar | |
|---|---|
range
|
Filtrenin kapsadığı aralık. |
tableId
|
Bu filtrenin desteklendiği tablo (varsa). Yazarken yalnızca |
sortSpecs[]
|
Sütun başına sıralama düzeni. Önceki spesifikasyonlardaki değerler eşit olduğunda sonraki spesifikasyonlar kullanılır. |
criteria
|
Sütun başına değerleri gösterme/gizleme ölçütleri. Haritanın anahtarı sütun dizini, değeri ise ilgili sütunun ölçütüdür.
Bu alan kullanımdan kaldırılmış, yerine |
filterSpecs[]
|
Sütun başına filtre ölçütleri.
Yanıtlar hem
|
BandedRange
Bir sayfada bantlanmış (alternatif renkler) bir aralık.
| JSON gösterimi |
|---|
{ "bandedRangeId": integer, "bandedRangeReference": string, "range": { object ( |
| Alanlar | |
|---|---|
bandedRangeId
|
Bantlı aralığın kimliği. Ayarlanmamışsa |
bandedRangeReference
|
Yalnızca çıkış. |
range
|
Bu özelliklerin uygulandığı aralık. |
rowProperties
|
Satır bantlarının özellikleri. Bu özellikler, aralıktaki tüm satırlarda satır satır uygulanır. En az bir |
columnProperties
|
Sütun bantlarının özellikleri. Bu özellikler, aralıktaki tüm sütunlarda sütun sütun uygulanır. En az bir |
BandingProperties
Tek bir boyuta (satır veya sütun) başvuran özellikler. Hem BandedRange.row_properties hem de BandedRange.column_properties ayarlanırsa dolgu renkleri, hücrelere aşağıdaki kurallara göre uygulanır:
-
headerColorvefooterColorbant renklerine göre önceliklidir. -
firstBandColor,secondBandColoröğesine göre önceliklidir. -
rowProperties,columnPropertiesöğesine göre önceliklidir.
Örneğin, ilk satır rengi ilk sütun rengine göre önceliklidir ancak ilk sütun rengi ikinci satır rengine göre önceliklidir. Benzer şekilde, sol üstteki hücrede satır başlığı sütun başlığına göre önceliklidir ancak satır başlığı ayarlanmamışsa sütun başlığı ilk satır rengine göre önceliklidir.
| JSON gösterimi |
|---|
{ "headerColor": { object ( |
| Alanlar | |
|---|---|
headerColor
|
İlk satırın veya sütunun rengi. Bu alan ayarlanırsa ilk satır veya sütun bu renkle doldurulur ve renkler ikinci satır veya sütundan başlayarak |
headerColorStyle
|
İlk satırın veya sütunun rengi. Bu alan ayarlanırsa ilk satır veya sütun bu renkle doldurulur ve renkler ikinci satır veya sütundan başlayarak |
firstBandColor
|
Değişen ilk renk. (Zorunlu) Kullanımdan kaldırıldı: |
firstBandColorStyle
|
Değişen ilk renk. (Zorunlu) Eğer
|
secondBandColor
|
Alternatif olarak kullanılan ikinci renk. (Zorunlu) Kullanımdan kaldırıldı: |
secondBandColorStyle
|
Alternatif olarak kullanılan ikinci renk. (Zorunlu) Eğer
|
footerColor
|
Son satır veya sütunun rengi. Bu alan ayarlanmazsa son satır veya sütun, önceki satırın ya da sütunun rengine bağlı olarak |
footerColorStyle
|
Son satır veya sütunun rengi. Bu alan ayarlanmazsa son satır veya sütun, önceki satırın ya da sütunun rengine bağlı olarak |
DimensionGroup
Bir sayfadaki satır veya sütun aralığında bulunan ve diğer grupları içerebilen ya da diğer gruplar tarafından kapsanabilen bir grup. Bir grup, sayfada bir birim olarak daraltılabilir veya genişletilebilir.
| JSON gösterimi |
|---|
{
"range": {
object ( |
| Alanlar | |
|---|---|
range
|
Bu grubun var olduğu aralık. |
depth
|
Grubun derinliği. Bu grubun aralığını tamamen içeren kaç grup olduğunu gösterir. |
collapsed
|
Bu grup daraltılmışsa bu alan true olur. Daha az derinlikte bulunan, çakışan bir grup genişletilse bile daraltılmış bir grup daraltılmış olarak kalır. Bir boyutun görünürlüğü bu grup özelliğinden bağımsız olarak değişebileceğinden, doğru değer, gruptaki tüm boyutların gizlendiği anlamına gelmez. Ancak bu özellik güncellendiğinde, bu alan doğruysa içindeki tüm boyutlar gizli, yanlışsa görünür olarak ayarlanır. |
Dilimleyici
Bir sayfadaki dilimleyici.
| JSON gösterimi |
|---|
{ "slicerId": integer, "spec": { object ( |
| Alanlar | |
|---|---|
slicerId
|
Dilimleyicinin kimliği. |
spec
|
Dilimleyicinin özellikleri. |
position
|
Dilimleyicinin konumu. Dilimleyicinin yalnızca mevcut sayfaya yerleştirilebileceğini unutmayın. Ayrıca, dilimleyicinin genişliği ve yüksekliği, izin verilen sınırlar içinde kalması için otomatik olarak ayarlanabilir. |
SlicerSpec
Dilimleyicinin özellikleri.
| JSON gösterimi |
|---|
{ "dataRange": { object ( |
| Alanlar | |
|---|---|
dataRange
|
Dilimleyicinin veri aralığı. |
filterCriteria
|
Dilimleyicinin filtreleme ölçütleri. |
columnIndex
|
Filtrenin uygulandığı veri tablosundaki sıfır tabanlı sütun dizini. |
applyToPivotTables
|
Filtrenin pivot tablolara uygulanması gerekiyorsa doğru (True) değerini alır. Ayarlanmamışsa varsayılan olarak |
title
|
Dilimleyicinin başlığı. |
textFormat
|
Dilimleyicideki başlığın metin biçimi. Bağlantı alanı desteklenmiyor. |
backgroundColor
|
Dilimleyicinin arka plan rengi. Desteği sonlandırıldı: |
backgroundColorStyle
|
Dilimleyicinin arka plan rengi. |
horizontalAlignment
|
Dilimleyicideki başlığın yatay hizalaması. Belirtilmemişse varsayılan olarak
|
Tablo
Tablo.
| JSON gösterimi |
|---|
{ "tableId": string, "name": string, "range": { object ( |
| Alanlar | |
|---|---|
tableId
|
Tablonun kimliği. |
name
|
Tablo adı. Bu, aynı e-tablodaki tüm tablolar için benzersizdir. |
range
|
Tablo aralığı. |
rowsProperties
|
Tablo satırları özellikleri. |
columnProperties[]
|
Tablo sütunu özellikleri. |
TableRowsProperties
Tablo satırı özellikleri.
| JSON gösterimi |
|---|
{ "headerColorStyle": { object ( |
| Alanlar | |
|---|---|
headerColorStyle
|
Başlık satırının rengi. Bu alan ayarlanırsa başlık satırı belirtilen renkle doldurulur. Aksi takdirde, başlık satırı varsayılan bir renkle doldurulur. |
firstBandColorStyle
|
Değişen ilk renk. Bu alan ayarlanırsa ilk bantlı satır belirtilen renkle doldurulur. Aksi takdirde, ilk bantlı satır varsayılan bir renkle doldurulur. |
secondBandColorStyle
|
Alternatif olarak kullanılan ikinci renk. Bu alan ayarlanırsa ikinci bantlı satır, belirtilen renkle doldurulur. Aksi takdirde, ikinci bantlı satır varsayılan bir renkle doldurulur. |
footerColorStyle
|
Son satırın rengi. Bu alan ayarlanmazsa altbilgi eklenmez ve son satır, önceki satırın rengine bağlı olarak |
TableColumnProperties
Tablo sütunu.
| JSON gösterimi |
|---|
{ "columnIndex": integer, "columnName": string, "columnType": enum ( |
| Alanlar | |
|---|---|
columnIndex
|
0 tabanlı sütun dizini. Bu dizin, tablodaki konumuna göre belirlenir ve sayfadaki sütun diziniyle aynı olması gerekmez. |
columnName
|
Sütun adı. |
columnType
|
Sütun türü. |
dataValidationRule
|
Sütun veri doğrulama kuralı. Yalnızca açılır liste sütun türü için ayarlanır. |
ColumnType
Tablodaki belirli bir sütunun sütun türü.
| Sıralamalar | |
|---|---|
COLUMN_TYPE_UNSPECIFIED
|
Belirtilmeyen sütun türü. |
DOUBLE
|
Sayı sütunu türü. |
CURRENCY
|
Para birimi sütun türü. |
PERCENT
|
Yüzde sütunu türü. |
DATE
|
Tarih sütunu türü. |
TIME
|
Saat sütunu türü. |
DATE_TIME
|
Tarih ve saat sütunu türü. |
TEXT
|
Metin sütunu türü. |
BOOLEAN
|
Boole sütunu türü. |
DROPDOWN
|
Açılır liste sütunu türü. |
FILES_CHIP
|
Dosya çipi sütun türü |
PEOPLE_CHIP
|
Kişi çipi sütun türü |
FINANCE_CHIP
|
Finans çipi sütun türü |
PLACE_CHIP
|
Yer çipi sütunu türü |
RATINGS_CHIP
|
Puan çipi sütun türü |
TableColumnDataValidationRule
Tablodaki bir sütun için veri doğrulama kuralı.
| JSON gösterimi |
|---|
{
"condition": {
object ( |
| Alanlar | |
|---|---|
condition
|
Hücredeki verilerin eşleşmesi gereken koşul. Yalnızca [BooleanCondition.type] değeri ONE_OF_LIST ise geçerlidir. |