REST Resource: spreadsheets

Kaynak: E-tablo

E-tabloyu temsil eden kaynak.

JSON gösterimi 
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
Alanlar
spreadsheetId

string

E-tablonun kimliği. Bu alan salt okunurdur.
properties

object (SpreadsheetProperties)

E-tablonun genel özellikleri.
sheets[]

object (Sheet)

Bir e-tablonun parçası olan sayfalar.
namedRanges[]

object (NamedRange)

E-tabloda tanımlanan adlandırılmış aralıklar.
spreadsheetUrl

string

E-tablonun URL'si. Bu alan salt okunurdur.
developerMetadata[]

object (DeveloperMetadata)

Bir e-tabloyla ilişkili geliştirici meta verileri.
dataSources[]

object (DataSource)

E-tabloya bağlı harici veri kaynaklarının listesi.
dataSourceSchedules[]

object (DataSourceRefreshSchedule)

Yalnızca çıkış. Veri kaynağı yenileme planlarının listesi.
comments[]

object (CommentThread)

E-tabloyla ilişkili yorum ileti dizileri.

commentsViewMode

enum (CommentsViewMode)

Yalnızca çıkış. E-tabloya uygulanan yorum görüntüleme modu.

SpreadsheetProperties

E-tablonun özellikleri.

JSON gösterimi 
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
Alanlar
title

string

E-tablonun başlığı.
locale

string

E-tablonun yerel ayarı. Aşağıdaki biçimlerden biri kullanılarak belirtilir:

  • en gibi bir ISO 639-1 dil kodu

  • 639-1 kodu yoksa fil gibi bir ISO 639-2 dil kodu

  • ISO dil kodu ve ülke kodunun birleşimi (ör. en_US)

Not: Bu alan güncellenirken tüm yerel ayarlar/diller desteklenmez.
autoRecalc

enum (RecalculationInterval)

Geçici işlevlerin yeniden hesaplanmasından önce beklenecek süre.
timeZone

string

E-tablonun saat dilimi (ör. America/New_York gibi CLDR biçiminde). Saat dilimi tanınmıyorsa GMT-07:00 gibi özel bir saat dilimi olabilir.
defaultFormat

object (CellFormat)

E-tablodaki tüm hücrelerin varsayılan biçimi. Hücrenin biçimi bu varsayılan biçime eşitse CellData.effectiveFormat ayarlanmaz. Bu alan salt okunurdur.
iterativeCalculationSettings

object (IterativeCalculationSettings)

Döngüsel başvuruların yinelemeli hesaplamayla çözülüp çözülmeyeceğini ve nasıl çözüleceğini belirler. Bu alanın olmaması, döngüsel başvuruların hesaplama hatalarına yol açtığı anlamına gelir.
spreadsheetTheme

object (SpreadsheetTheme)

E-tabloya tema uygulandı.
importFunctionsExternalUrlAccessAllowed

boolean

Resim ve içe aktarma işlevleri için harici URL erişimine izin verilip verilmeyeceği. Yalnızca doğru olduğunda okunur. Yanlış olduğunda doğru olarak ayarlayabilirsiniz. Yönetici izin verilenler listesi özelliğini etkinleştirdiyse bu değer atlanır ve her zaman doğru (true) değeri döndürülür.

RecalculationInterval

Olası yeniden hesaplama aralığı seçeneklerinin numaralandırılmış listesi.

Sıralamalar
RECALCULATION_INTERVAL_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamalıdır.
ON_CHANGE Değişken işlevler her değişiklikte güncellenir.
MINUTE Değişken işlevler, her değişiklikte ve her dakikada güncellenir.
HOUR Değişken işlevler, her değişiklikte ve saatte bir güncellenir.

IterativeCalculationSettings

Döngüsel bağımlılıkların yinelemeli hesaplamayla nasıl çözüleceğini kontrol etmeye yönelik ayarlar.

JSON gösterimi 
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Alanlar
maxIterations

integer

Yinelemeli hesaplama etkinleştirildiğinde gerçekleştirilecek maksimum hesaplama turu sayısı.
convergenceThreshold

number

Yinelemeli hesaplama etkinleştirildiğinde ve ardışık sonuçlar bu eşik değerinden daha az farklılık gösterdiğinde hesaplama turları durur.

SpreadsheetTheme

E-tablo temasını temsil eder.

JSON gösterimi 
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Alanlar
primaryFontFamily

string

Birincil yazı tipi ailesinin adı.
themeColors[]

object (ThemeColorPair)

E-tablo tema rengi çiftleri. Güncelleme yapmak için tüm tema rengi çiftlerini sağlamanız gerekir.

ThemeColorPair

Bir e-tablo tema rengi türünü temsil ettiği somut renkle eşleyen bir çift.

JSON gösterimi 
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Alanlar
colorType

enum (ThemeColorType)

E-tablo tema renginin türü.
color

object (ColorStyle)

Tema rengi türüne karşılık gelen somut renk.

NamedRange

Adlandırılmış bir aralık.

JSON gösterimi 
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Alanlar
namedRangeId

string

Adlandırılmış aralığın kimliği.
name

string

Adlandırılmış aralığın adı.
range

object (GridRange)

Bunun temsil ettiği aralık.

DataSource

E-tablodaki harici veri kaynağı hakkında bilgiler.

JSON gösterimi 
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Alanlar
dataSourceId

string

Veri kaynağını tanımlayan, e-tablo kapsamlı benzersiz kimlik. Örnek: 1080547365.
spec

object (DataSourceSpec)

Bu e-tabloya bağlı veri kaynağının DataSourceSpec.
calculatedColumns[]

object (DataSourceColumn)

Veri kaynağındaki tüm hesaplanmış sütunlar.
sheetId

integer

Veri kaynağına bağlı Sheet kimliği. Alan, ayarlandıktan sonra değiştirilemez.

Veri kaynağı oluştururken ilişkili bir DATA_SOURCE sayfası da oluşturulur. Alan belirtilmezse oluşturulan sayfanın kimliği rastgele oluşturulur.

DataSourceSpec

Bu, veri kaynağının ayrıntılarını belirtir. Örneğin, BigQuery için bu, BigQuery kaynağı hakkındaki bilgileri belirtir.

JSON gösterimi 
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
}
Alanlar
parameters[]

object (DataSourceParameter)

Veri kaynağını sorgularken kullanılan veri kaynağı parametreleri.
spec birleşik alanı. Veri kaynağı türü başına gerçek spesifikasyon. spec aşağıdakilerden yalnızca biri olabilir:
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec.
looker

object (LookerDataSourceSpec)

[LookerDatasourceSpec][]

BigQueryDataSourceSpec

Bir sayfaya bağlı olan BigQuery veri kaynağının belirtimi.

JSON gösterimi 
{
  "projectId": string,

  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
}
Alanlar
projectId

string

Faturalandırma hesabı eklenmiş, BigQuery'nin etkin olduğu bir Google Cloud projesinin kimliği. Veri kaynağına karşı yürütülen tüm sorgular için projeden ücret alınır.
spec birleşik alanı. Gerçek spesifikasyon. spec aşağıdakilerden yalnızca biri olabilir:
querySpec

object (BigQueryQuerySpec)

BigQueryQuerySpec.
tableSpec

object (BigQueryTableSpec)

BigQueryTableSpec.

BigQueryQuerySpec

Özel bir BigQuery sorgusu belirtir.

JSON gösterimi 
{
  "rawQuery": string
}
Alanlar
rawQuery

string

Ham sorgu dizesi.

BigQueryTableSpec

BigQuery tablo tanımını belirtir. Yalnızca yerel tablolara izin verilir.

JSON gösterimi 
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
Alanlar
tableProjectId

string

Tablonun ait olduğu BigQuery projesinin kimliği. Belirtilmediği takdirde projectId değeri varsayılır.
tableId

string

BigQuery tablosu kimliği.
datasetId

string

BigQuery veri kümesi kimliği.

LookerDataSourceSpec

Looker veri kaynağının spesifikasyonu.

JSON gösterimi 
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
Alanlar
instanceUri

string

Looker örneği URL'si.
model

string

Looker modelinin adı.
explore

string

Looker model keşfinin adı.

DataSourceParameter

Bir veri kaynağının sorgusundaki parametre. Parametre, kullanıcının e-tablodaki değerleri sorguya aktarmasına olanak tanır.

JSON gösterimi 
{

  "name": string

  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
}
Alanlar
identifier birleşik alanı. Parametre tanımlayıcısı. identifier aşağıdakilerden yalnızca biri olabilir:
name

string

Adlandırılmış parametre. DataSource için geçerli bir tanımlayıcı olmalıdır. Örneğin, BigQuery tanımlayıcısı.
value birleşik alanı. Parametre değeri. value aşağıdakilerden yalnızca biri olabilir:
namedRangeId

string

NamedRange kimliği. Boyutu 1x1 olmalıdır.
range

object (GridRange)

Parametrenin değerini içeren bir aralık. Boyutu 1x1 olmalıdır.

DataSourceRefreshSchedule

Veri kaynağını yenileme zamanlaması.

E-tablodaki veri kaynakları belirli bir zaman aralığında yenilenir. E-Tablolar düzenleyicisindeki Planlanmış Yenileme düğmesini tıklayarak başlangıç zamanını belirleyebilirsiniz ancak aralık 4 saat olarak sabittir. Örneğin, başlangıç saati olarak 08:00'ı belirtirseniz yenileme her gün 08:00 ile 12:00 arasında gerçekleşir.

JSON gösterimi 
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
}
Alanlar
enabled

boolean

Yenileme planı etkinse doğru, aksi takdirde yanlış.
refreshScope

enum (DataSourceRefreshScope)

Yenilemenin kapsamı. ALL_DATA_SOURCES olmalıdır.
nextRun

object (Interval)

Yalnızca çıkış. Sonraki çalıştırmanın zaman aralığı.
schedule_config birleşik alanı. Program yapılandırmaları schedule_config aşağıdakilerden yalnızca biri olabilir:
dailySchedule

object (DataSourceRefreshDailySchedule)

Günlük yenileme planı.
weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Haftalık yenileme programı.
monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Aylık yenileme programı.

DataSourceRefreshScope

Veri kaynağı yenileme kapsamları.

Sıralamalar
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Varsayılan değer, kullanmayın.
ALL_DATA_SOURCES E-tablodaki tüm veri kaynaklarını ve bunlarla ilişkili veri kaynağı nesnelerini yeniler.

DataSourceRefreshDailySchedule

Verilerin belirli bir zaman aralığında her gün yenilenmesi için bir plan.

JSON gösterimi 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Alanlar
startTime

object (TimeOfDay)

Veri kaynağı yenilemenin planlandığı bir zaman aralığının başlangıç zamanı. Yalnızca hours bölümü kullanılır. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindekiyle aynıdır.

TimeOfDay

Günün bir saatini gösterir. Tarih ve saat dilimi önemli değildir veya başka bir yerde belirtilmiştir. Bir API, artık saniyelere izin vermeyi seçebilir. İlgili türler google.type.Date ve google.protobuf.Timestamp'dir.

JSON gösterimi 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Alanlar
hours

integer

Bir günün saatleri (24 saatlik biçimde). 0'dan büyük veya 0'a eşit olmalı ve genellikle 23'ten küçük veya 23'e eşit olmalıdır. Bir API, işletmenin kapanış saati gibi senaryolarda "24:00:00" değerine izin vermeyi seçebilir.
minutes

integer

Saatin dakikası. 0'dan büyük veya 0'a eşit ve 59'dan küçük veya 59'a eşit olmalıdır.
seconds

integer

Bir dakikanın saniyeleri. 0'dan büyük veya 0'a eşit olmalı ve genellikle 59'dan küçük veya 59'a eşit olmalıdır. Bir API, artık saniyelere izin veriyorsa 60 değerine izin verebilir.
nanos

integer

Saniyenin kesirleri (nanosaniye cinsinden). 0'dan büyük veya 0'a eşit ve 999.999.999'dan küçük veya 999.999.999'a eşit olmalıdır.

DataSourceRefreshWeeklySchedule

Verilerin belirli bir zaman aralığında belirli günlerde yenilenmesi için haftalık bir plan.

JSON gösterimi 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Alanlar
startTime

object (TimeOfDay)

Veri kaynağı yenilemenin planlandığı bir zaman aralığının başlangıç zamanı. Yalnızca hours bölümü kullanılır. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindekiyle aynıdır.
daysOfWeek[]

enum (DayOfWeek)

Yenilenecek haftanın günleri. En az bir gün belirtilmelidir.

HaftanınGünü

Haftanın bir gününü temsil eder.

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmemiş.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

DataSourceRefreshMonthlySchedule

Verilerin belirli bir zaman aralığında ayın belirli günlerinde yenilenmesi için aylık bir plan.

JSON gösterimi 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Alanlar
startTime

object (TimeOfDay)

Veri kaynağı yenilemenin planlandığı bir zaman aralığının başlangıç zamanı. Yalnızca hours bölümü kullanılır. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindekiyle aynıdır.
daysOfMonth[]

integer

Yenilenecek ayın günleri. Yalnızca 1-28 arası desteklenir ve 1. ile 28. gün arasında eşleme yapılır. En az bir gün belirtilmelidir.

Aralık

Bir zaman aralığını, Başlangıç zaman damgası (dahil) ve Bitiş zaman damgası (hariç) olarak kodlanmış şekilde gösterir.

Başlangıç değeri, bitiş değerinden küçük veya ona eşit olmalıdır. Başlangıç ve bitiş zamanı aynı olduğunda aralık boştur (hiçbir zamanla eşleşmez). Hem başlangıç hem de bitiş belirtilmediğinde aralık herhangi bir zamana karşılık gelir.

JSON gösterimi 
{
  "startTime": string,
  "endTime": string
}
Alanlar
startTime

string (Timestamp format)

İsteğe bağlıdır. Aralığın başlangıç zamanı dahildir.

Bu aralıkla eşleşen bir zaman damgası belirtilirse başlangıçla aynı veya başlangıçtan sonra olmalıdır.
endTime

string (Timestamp format)

İsteğe bağlı. Aralığın bitiş zamanı dahil değildir.

Bu aralıkla eşleşen bir zaman damgası belirtilirse bitişten önce olmalıdır.

CommentThread

E-tablodaki tek bir yorum dizisini temsil eder.

JSON gösterimi 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
Alanlar
commentId

string

Yorum dizisinin benzersiz kimliği.
anchorId

string

Bu ileti dizisinin bağlı olduğu sayfadaki CommentAnchor kimliği.
headPost

object (Post)

İleti dizisindeki ilk yayın.
replies[]

object (Post)

Ana yayına verilen yanıtlar.
status

enum (Status)

İleti dizisinin açık mı yoksa çözüme kavuşturulmuş mu olduğu
quote birleşik alanı. Yorum oluşturulduğunda dokümandaki alıntılanan metin. quote aşağıdakilerden yalnızca biri olabilir:
plainTextQuote

string

Yorum oluşturulduğunda e-tablodan alıntılanan metin, düz metin olarak biçimlendirilmiş.

Gönderi

Yorum dizisindeki tek bir gönderiyi temsil eder.

JSON gösterimi 
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedSpreadsheet": boolean,
  "fromCopiedSpreadsheet": boolean,
  "assigneeEmail": string,
  "commentAction": enum (CommentActionType)
}
Alanlar
postId

string

Yalnızca çıkış. Yayının benzersiz kimliği.
content

string

Yayının içeriği.

commentAction, RESOLVE veya REOPEN değilse boş bırakılmamalıdır.

Bu metin içeriği, E-Tablolar düzenleyicisinde oluşturulan yorumlara benzer şekilde işlenir. Biçimlendirme, bildirimler vb. için benzer davranışlar gösterir.

2048 UTF-8 kod birimini aşamaz.
contentHtml

string

Yalnızca çıkış. Yayının HTML olarak içeriği.
author

object (PostAuthor)

Yalnızca çıkış. Yayını oluşturan kullanıcı.
createTime

string (Timestamp format)

Yalnızca çıkış. Yayının oluşturulduğu zaman.
updateTime

string (Timestamp format)

Yalnızca çıkış. Yayın son güncellenme zamanı.
deleted

boolean

Yalnızca çıkış. Yayının silinip silinmediği. true, content ve author alanları boş olur.
fromImportedSpreadsheet

boolean

Yalnızca çıkış. Gönderinin içe aktarılan bir e-tablodan olup olmadığı. Bu alan, arayanlar tarafından doğrudan ayarlanamaz.
fromCopiedSpreadsheet

boolean

Yalnızca çıkış. Gönderinin kopyalanmış bir e-tablodan olup olmadığı. Bu alan, arayanlar tarafından doğrudan ayarlanamaz.
assigneeEmail

string

İsteğe bağlı. Bu gönderi kapsamında ileti dizisine yeni atanan kullanıcının e-posta adresi.

Aşağıdaki durumlarda 400 hatalı istek hatası döndürür:

  • Üst ileti dizisi, CommentThread olan ve headPost için atananı olmayan bir öğe.

  • commentAction, RESOLVE veya REOPEN olarak belirtilmişse.

  • assigneeEmail, 2048 UTF-8 kod birimini aşıyor.
commentAction

enum (CommentActionType)

Yayın oluşturma kapsamında gerçekleştirilen işlem.

PostAuthor

Yorum yayını oluşturan bir kullanıcıyı temsil eder.

JSON gösterimi 
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
Alanlar
displayName

string

Kullanıcının görünen adı. Yazar anonimse bu özellik bulunmayabilir.
me

boolean

Kullanıcının, isteği gönderen kimliği doğrulanmış kullanıcı olup olmadığı.
anonymous

boolean

Kullanıcının anonim olup olmadığı.
user

string

Gönderi yazarının kaynak adı. Bu ad, Google People API'de kullanıcıyı tanımlamak için de kullanılabilir. Biçim: users/{user}. Anonim alan true ise veya gönderi içe aktarılan bir e-tablodan geliyorsa doldurulmaz.

CommentActionType

Yorum dizisine verilen bu yanıtta gerçekleştirilen işlem.

Sıralamalar
COMMENT_ACTION_TYPE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
NO_COMMENT_ACTION_CHANGE Bu yayında işlem değişikliği yok.
RESOLVE Bu yayın, ileti dizisini çözüme ulaştırır.
REOPEN Bu yayın, ileti dizisini yeniden açar.

Durum

Yorum dizisinin durum seçenekleri.

Sıralamalar
STATUS_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
OPEN Yorum dizisi açıktır.
RESOLVED Yorum dizisi çözümlenir.

CommentsViewMode

E-tabloya uygulanan yorum görüntüleme modu (yorumların dahil edilip edilmediğini gösterir). E-tabloyu yorumlarla veya yorumlar ve yorum bağlantıları olmadan okuma seçenekleri sunar.

Sıralamalar
COMMENTS_VIEW_MODE_UNSPECIFIED CommentsViewMode belirtilmediyse COMMENTS_VIEW_MODE_OMITTED uygulanır.
COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS Döndürülen e-tabloya uygulanan CommentsViewMode, kullanıcının mevcut erişim düzeyine bağlıdır. Kullanıcının yalnızca görüntüleme erişimi varsa COMMENTS_VIEW_MODE_OMITTED uygulanır. Aksi takdirde COMMENTS_VIEW_MODE_INCLUDED uygulanır.
COMMENTS_VIEW_MODE_OMITTED Döndürülen e-tabloda yorumlar atlanmış.
COMMENTS_VIEW_MODE_INCLUDED

Döndürülen e-tabloda yorumlar yer alır.

Bu modu kullanarak e-tablo alma istekleri, kullanıcının yorumları görüntüleme izni yoksa 403 hatası döndürür.

Yöntemler

batchUpdate

 E-tabloya bir veya daha fazla güncelleme uygular.

create

 E-tablo oluşturur ve yeni oluşturulan e-tabloyu döndürür.

get

 Belirtilen kimliğe sahip e-tabloyu döndürür.

getByDataFilter

 Belirtilen kimliğe sahip e-tabloyu döndürür.