Sayfa
E-tablodaki bir sayfa.
JSON gösterimi |
---|
{ "properties": { object ( |
Alanlar | |
---|---|
properties
|
E-tablonun özellikleri. |
data[]
|
Tablodaki veriler (bu bir tablo sayfasıysa).
Döndürülen GridData nesnelerinin sayısı, bu sayfada istenen aralıkların sayısına bağlıdır. Örneğin, bu
Bir |
merges[]
|
Birleştirilen aralıklar. |
conditionalFormats[]
|
Bu sayfadaki koşullu biçimlendirme kuralları. |
filterViews[]
|
Bu sayfadaki filtre görünümleri. |
protectedRanges[]
|
Bu sayfadaki korumalı 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ı, artan aralık başlangıç dizine ve ardından grup derinliğine göre sıralanır. |
columnGroups[]
|
Bu sayfadaki tüm sütun grupları, aralık başlangıç dizini artırılarak ve ardından grup derinliği artırılarak sıralanır. |
slicers[]
|
Bu sayfada bulunan dilimleyiciler. |
SheetProperties
E-tablonun özellikleri.
JSON gösterimi |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Alanlar | |
---|---|
sheetId
|
E-tablonun kimliği. Negatif olmamalıdır. Bu alan bir kez ayarlandıktan sonra değiştirilemez. |
title
|
Sayfanın adı. |
index
|
E-tablodaki sayfanın dizini. E-tablo özelliklerini eklerken veya güncellerken, bu alan hariç tutulduğunda sayfa eklenir veya sayfa listesinin sonuna taşınır. E-tablo dizinleri güncellenirken veya e-tablo eklenirken hareket, "taşımadan önce" dizinlerinde 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, e-tablonun mevcut diziniyle aynıysa veya istenen yeni dizin, mevcut e-tablo dizini + 1'e eşitse e-tablo dizini güncelleme isteği yoksayılacaktır. |
sheetType
|
Sayfanın türü. Varsayılan olarak |
gridProperties
|
Bu sayfa bir ızgaraysa sayfanın ek özellikleri. (Sayfa, grafik veya resim içeren bir nesne sayfasıysa bu alan bulunmaz.) Yazarken ızgara olmayan sayfalarda ızgara özelliklerini ayarlamak hatalıdır.
Bu e-tablo bir |
tabColor
|
Kullanıcı arayüzündeki sekmenin rengi. Desteği sonlandırıldı: |
tabColorStyle
|
Kullanıcı arayüzündeki sekmenin rengi. |
rightToLeft
|
Sayfa, LTR sayfası yerine sağdan sola yazılan bir sayfaysa doğru değerini alır. |
dataSourceSheetProperties
|
Yalnızca çıkış. Mevcutsa alan, |
SheetType
Sayfanın türü.
Sıralamalar | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Varsayılan değerdir, kullanmayın. |
GRID
|
Sayfa bir ızgaradır. |
OBJECT
|
E-tabloda ızgara yerine grafik veya resim gibi bir nesne vardır. |
DATA_SOURCE
|
E-tablo, harici bir DataSource ile bağlanır ve verilerin önizlemesini gösterir.
|
GridProperties
Tablonun ö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
|
Izgarada dondurulan satırların sayısı. |
frozenColumnCount
|
Tabloda dondurulan sütun sayısı. |
hideGridlines
|
Izgara, kullanıcı arayüzünde kılavuz çizgileri göstermiyorsa doğru değerini döndürür. |
rowGroupControlAfter
|
Satır gruplandırma kontrolünü açma/kapatma düğmesi gruptan sonra gösteriliyorsa doğru değerini döndürür. |
columnGroupControlAfter
|
Sütun gruplandırma kontrol düğmesi gruptan sonra gösteriliyorsa doğru değerini alır. |
DataSourceSheetProperties
Bir sayfanın ek özellikleri.
DATA_SOURCE
JSON gösterimi |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Alanlar | |
---|---|
dataSourceId
|
E-tablonun bağlı olduğu |
columns[]
|
Sayfada gösterilen ve |
dataExecutionStatus
|
Veri yürütme durumu. |
GridData
Izgaradaki veriler ve boyutlarla ilgili meta veriler.
JSON gösterimi |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Alanlar | |
---|---|
startRow
|
Bu GridData öğesinin atıfta bulunduğu ilk satır (sıfır tabanlı). |
startColumn
|
Bu GridData nesnesinin referans verdiği ilk sütun (sıfır tabanlı). |
rowData[]
|
startRow parametresindeki satırdan başlayarak her satırda bir giriş olacak şekilde ızgaradaki veriler. RowData'daki değerler, |
rowMetadata[]
|
|
columnMetadata[]
|
|
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ış. Ayarlanırsa bu, veri kaynağı sayfasında yer alan bir 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ı ızgarada olmalıdır. |
Birlik alanı
rule . Bu koşullu biçimi kontrol eden kural. Tam olarak bir kural ayarlanmalıdır.
rule
yalnızca aşağıdakilerden 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şebilecek veya eşleşmeyebilecek 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, biçimlendirmenin yalnızca bir alt kümesini uygulayabilir:
|
GradientRule
Listelenen interpolasyon noktalarına dayalı olarak bir gradyan renk skalası biçimi uygulayan bir kural. Bir hücrenin biçimi, içeriğine ve bu içeriğin, enterpolasyon noktalarının değerlerine kıyasla nasıl olduğuna göre değişir.
JSON gösterimi |
---|
{ "minpoint": { object ( |
Alanlar | |
---|---|
minpoint
|
Başlangıç noktaları için kullanılan nokta. |
midpoint
|
İsteğe bağlı orta nokta interpolasyon noktası. |
maxpoint
|
Son enterpolasyon noktası. |
InterpolationPoint
Gradyan koşullu biçimlendirmede tek bir enterpolasyon noktası. Bunlar, seçilen renge, türe ve değere göre gradyan renk skalasını sabitler.
JSON gösterimi |
---|
{ "color": { object ( |
Alanlar | |
---|---|
color
|
Bu kesme noktasının kullanacağı renk. Desteği sonlandırıldı: |
colorStyle
|
Bu kesme noktasının kullanacağı renk. |
type
|
Değerin nasıl yorumlanması gerektiği. |
value
|
Bu enterpolasyon noktasının kullandığı değer. Bir formül olabilir. |
InterpolationPointType
İnterpolasyon noktasının türü.
Sıralamalar | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Varsayılan değerdir, kullanmayın. |
MIN
|
Eşleme noktası, koşullu biçim aralığındaki hücrelerdeki minimum değeri kullanır. |
MAX
|
Eşleme noktası, koşullu biçim aralığındaki hücrelerdeki maksimum değeri kullanır. |
NUMBER
|
Doğrusal olmayan ara değer noktası tam olarak InterpolationPoint.value 'teki değeri kullanır.
|
PERCENT
|
Düzenleme noktası, koşullu biçim aralığındaki tüm hücreler için verilen yüzdedir. Değer şu şekildeyse bu, |
PERCENTILE
|
Eşleme noktası, koşullu biçim aralığındaki tüm hücreler için belirtilen yüzdelik dilimdir. Değer şu şekildeyse bu, NUMBER ile aynıdır:
=PERCENTILE(FLATTEN(range), value / 100)
(düzeltme işlemi sırasında aralıktaki hatalar göz ardı edilir).
|
FilterView
Filtre görünümü.
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
|
Varsa bu filtre görünümünün dayandığı adlandırılmış aralık.
Yazarken |
sortSpecs[]
|
Sütun başına sıralama düzeni. Daha sonraki spesifikasyonlar, değerler önceki spesifikasyonlarda eşit olduğunda kullanılır. |
criteria
|
Sütun başına değerleri gösterme/gizleme ölçütleri. Haritanın anahtarı sütun dizinidir, değer de bu sütunun ölçütüdür.
Bu alan kullanımdan kaldırılarak yerine |
filterSpecs[]
|
Sütun başına değerleri göstermek/gizlemek için filtre ölçütleri.
Yanıtlarda hem |
ProtectedRange
Korumalı aralık.
JSON gösterimi |
---|
{ "protectedRangeId": integer, "range": { object ( |
Alanlar | |
---|---|
protectedRangeId
|
Korunan aralığın kimliği. Bu alan salt okunur. |
range
|
Korunan aralık. Aralık tamamen sınırsız olabilir. Bu durumda, bu sayfa korunan bir sayfa olarak kabul edilir.
Yazarken yalnızca |
namedRangeId
|
Bu korunan aralığın desteklediği adlandırılmış aralık (varsa).
Yazarken |
description
|
Bu korumalı aralığın açıklaması. |
warningOnly
|
Bu korumalı aralık düzenlenirken uyarı gösterilecekse doğru değerini alır. Uyarı tabanlı koruma, her kullanıcının korumalı aralıktaki verileri düzenleyebileceği anlamına gelir. Ancak düzenleme işlemi, kullanıcıdan düzenlemeyi onaylamasını isteyen bir uyarı gösterir.
Yazarken: Bu alan doğruysa |
requestingUserCanEdit
|
Bu korumalı aralığı isteyen kullanıcı korumalı alanı düzenleyebiliyorsa doğru değerini döndürür. Bu alan salt okunurdur. |
unprotectedRanges[]
|
Korunan bir sayfadaki korumasız aralıkların listesi. Korumalı olmayan aralıklar yalnızca korumalı sayfalarda desteklenir. |
editors
|
Korunan alana düzenleme erişimi olan kullanıcılar ve gruplar. Bu alan yalnızca korunan alana ve belgeye düzenleme erişimi olan kullanıcılar tarafından görülebilir. Düzenleyiciler, |
Editörler
Korunan bir aralığın düzenleyicileri.
JSON gösterimi |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
Alanlar | |
---|---|
users[]
|
Korunan alana düzenleme erişimi olan kullanıcıların e-posta adresleri. |
groups[]
|
Korunan alana düzenleme erişimi olan grupların e-posta adresleri. |
domainUsersCanEdit
|
Belgenin alanındaki herhangi bir kullanıcının, korumalı alana düzenleme erişimi varsa doğru değerini döndürür. Alan koruması yalnızca bir alan içindeki dokümanlarda desteklenir. |
BasicFilter
Bir sayfayla ilişkili varsayılan filtre.
JSON gösterimi |
---|
{ "range": { object ( |
Alanlar | |
---|---|
range
|
Filtrenin kapsadığı aralık. |
sortSpecs[]
|
Sütun başına sıralama düzeni. Önceki spesifikasyonlardaki değerler eşit olduğunda, daha 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 söz konusu sütun için ölçüttür.
Bu alan kullanımdan kaldırılarak yerine |
filterSpecs[]
|
Sütun başına filtre ölçütleri.
Hem
|
BandedRange
Bir sayfada şeritli (alternatif renkler) aralık.
JSON gösterimi |
---|
{ "bandedRangeId": integer, "range": { object ( |
Alanlar | |
---|---|
bandedRangeId
|
Gruplandırılmış aralığın kimliği. |
range
|
Bu özelliklerin uygulandığı aralık. |
rowProperties
|
Satır bantları için özellikler. Bu özellikler, aralıktaki tüm satırlara satır bazında uygulanır. |
columnProperties
|
Sütun bantları için özellikler. Bu özellikler, aralıktaki tüm sütunlara sütun bazında uygulanır. |
BandingProperties
Tek bir boyuta (satır veya sütun) atıfta bulunan özellikler. Hem BandedRange.row_properties
hem de BandedRange.column_properties
ayarlanırsa dolgu renkleri hücrelere aşağıdaki kurallara göre uygulanır:
-
headerColor
vefooterColor
bant renklerine göre önceliklidir. -
firstBandColor
secondBandColor
'a göre daha önceliklidir. -
rowProperties
columnProperties
'a göre daha ö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, satır başlığı sol üst hücredeki sütun başlığı üzerinde önceliğe sahiptir ancak satır başlığı ayarlanmamışsa sütun başlığı ilk satır rengi üzerinde önceliğe sahiptir.
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 itibaren |
firstBandColor
|
Değişen ilk renk. (Zorunlu) Desteği sonlandırıldı: |
firstBandColorStyle
|
Değişen ilk renk. (Zorunlu) |
secondBandColor
|
Değişen ikinci renk. (Zorunlu) Desteği sonlandırıldı: |
secondBandColorStyle
|
Alternatif olan ikinci renk. (Zorunlu) |
footerColor
|
Son satırın veya sütunun rengi. Bu alan ayarlanmamışsa son satır veya sütun, önceki satırın ya da sütunun rengine bağlı olarak |
footerColorStyle
|
Son satırın veya sütunun rengi. Bu alan ayarlanmazsa son satır veya sütun, önceki satırın veya sütunun rengine bağlı olarak |
DimensionGroup
Bir sayfadaki satır veya sütun aralığı üzerinde yer alan ve başka grupları içerebilen ya da başka gruplar tarafından içerlenebilen bir grup. Gruplar, sayfa üzerinde bir birim olarak daraltılabilir veya genişletilebilir.
JSON gösterimi |
---|
{
"range": {
object ( |
Alanlar | |
---|---|
range
|
Bu grubun bulunduğu aralık. |
depth
|
Grubun derinliği. Bu gruptaki aralığı tamamen kapsayan kaç grup olduğunu gösterir. |
collapsed
|
Bu grup daraltılmışsa bu alan doğru değerini alır. Daraltılmış grup, daha sığ bir derinlikte çakışan bir grup genişletilirse 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 gizli olduğu anlamına gelmez. Ancak bu özellik güncellendiğinde, bu alan doğruysa içindeki tüm boyutlar gizli olarak, yanlışsa görünür olarak ayarlanır. |
Dilimleyici
Bir sayfada dilimleyici.
JSON gösterimi |
---|
{ "slicerId": integer, "spec": { object ( |
Alanlar | |
---|---|
slicerId
|
Dilimleyicinin kimliği. |
spec
|
Dilimleyicinin spesifikasyonu. |
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 kalacak şekilde 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
|
Filtre pivot tablolara uygulanacaksa doğru değerini alır. Ayarlanmamışsa varsayılan olarak |
title
|
Bölme aracının başlığı. |
textFormat
|
Dilimleyicideki başlığın metin biçimi. Bağlantı alanı desteklenmez. |
backgroundColor
|
Dilimleyicinin arka plan rengi. Desteği sonlandırıldı: |
backgroundColorStyle
|
Dilimleyicinin arka plan rengi. |
horizontalAlignment
|
Dilimleyicideki başlığın yatay hizalaması. Belirtilmezse varsayılan olarak |