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)
    }
  ]
}
Alanlar
spreadsheetId

string

E-tablonun kimliği. Bu alan salt okunur.

properties

object (SpreadsheetProperties)

E-tablonun genel özellikleri.

sheets[]

object (Sheet)

E-tablonun parçası olan sayfalar.

namedRanges[]

object (NamedRange)

Bir e-tabloda tanımlanan adlandırılmış aralıklar.

spreadsheetUrl

string

E-tablonun URL'si. Bu alan salt okunur.

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.

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 aşağıdaki biçimlerden birindeki yerel ayarı:

  • ISO 639-1 dil kodu (ör. en)

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

  • ISO dil kodu ve ülke kodunun bir kombinasyonu (ör. en_US)

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

autoRecalc

enum (RecalculationInterval)

Değişken işlevler yeniden hesaplanmadan önce beklenecek süre.

timeZone

string

E-tablonun saat dilimi (America/New_York gibi CLDR biçiminde). Saat dilimi tanınmazsa bu saat, 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 referansların yinelemeli hesaplamayla çözülüp çözülmeyeceğini ve nasıl çözüleceğini belirler. Bu alanın olmaması, döngüsel referansların hesaplama hatalarına yol açtığı anlamına gelir.

spreadsheetTheme

object (SpreadsheetTheme)

Tema, e-tabloya uygulandı.

importFunctionsExternalUrlAccessAllowed

boolean

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

RecalculationInterval

Olası yeniden hesaplama aralığı seçeneklerinin 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 bir 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ümleneceğini kontrol eden 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 az olduğunda 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 renk çiftleri. Güncelleme yapmak için tüm tema rengi çiftlerini sağlamanız gerekir.

ThemeColorPair

E-tablo teması renk 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ış 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 bilgi.

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 değeri.

calculatedColumns[]

object (DataSourceColumn)

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

sheetId

integer

Veri kaynağına bağlı Sheet öğesinin kimliği. Bu alan bir kez ayarlandıktan sonra değiştirilemez.

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

DataSourceSpec

Veri kaynağının ayrıntılarını belirtir. Örneğin, BigQuery için bu, BigQuery kaynağıyla ilgili bilgileri belirtir.

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

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
Alanlar
parameters[]

object (DataSourceParameter)

Veri kaynağı sorgulanırken kullanılan veri kaynağının parametreleridir.

Birlik alanı spec. Veri kaynağı türü başına gerçek spesifikasyon. spec yalnızca aşağıdakilerden biri olabilir:
bigQuery

object (BigQueryDataSourceSpec)

Bir BigQueryDataSourceSpec.

looker

object (LookerDataSourceSpec)

[LookerDatasourceSpec][].

BigQueryDataSourceSpec

Bir sayfaya bağlı BigQuery veri kaynağının spesifikasyonu.

JSON gösterimi
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
Alanlar
projectId

string

BigQuery'nin etkin olduğu ve faturalandırma hesabı eklenmiş bir Google Cloud projesinin kimliği. Veri kaynağına karşı yürütülen tüm sorgular için projeden ücret alınır.

Birleştirme alanı spec. Gerçek spesifikasyon. spec yalnızca aşağıdakilerden biri olabilir:
querySpec

object (BigQueryQuerySpec)

Bir BigQueryQuerySpec.

tableSpec

object (BigQueryTableSpec)

BigQueryTableSpec.

BigQueryQuerySpec

Özel bir BigQuery sorgusunu 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 olarak kabul edilir.

tableId

string

BigQuery tablosu kimliği.

datasetId

string

BigQuery veri kümesi kimliği.

LookerDataSourceSpec

Bir 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ğı sorgusundaki parametre. Parametre, kullanıcının e-tablodaki değerleri bir sorguya iletmesine olanak tanır.

JSON gösterimi
{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
Alanlar
Birlik alanı identifier. Parametre tanımlayıcısı. identifier yalnızca aşağıdakilerden biri olabilir:
name

string

Adlandırılmış parametre. Destekleyen DataSource için geçerli bir tanımlayıcı olmalıdır. Örneğin, BigQuery tanımlayıcısı.

Birleştirme alanı value. Parametre değeri. value şunlardan 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ın yenilenmesi için planlama yapın.

E-tablodaki veri kaynakları belirli bir zaman aralığında yenilenir. E-Tablolar düzenleyicisindeki Planlanmış Yenileme düğmesini tıklayarak başlangıç zamanını belirtebilirsiniz ancak aralık 4 saat olarak sabitlenmiştir. Örneğin, başlangıç saatini 08:00 olarak belirlerseniz 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)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
Alanlar
enabled

boolean

Yenileme planlaması etkinse doğru, etkin değilse false (yanlış) değerini alır.

refreshScope

enum (DataSourceRefreshScope)

Yenilemenin kapsamı. ALL_DATA_SOURCES olmalıdır.

nextRun

object (Interval)

Yalnızca çıkış. Sonraki çalıştırmanın zaman aralığı.

Birlik alanı schedule_config. Program yapılandırmaları schedule_config yalnızca aşağıdakilerden biri olabilir:
dailySchedule

object (DataSourceRefreshDailySchedule)

Günlük yenileme programı.

weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Haftalık yenileme programı.

monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Aylık yenileme planı.

DataSourceRefreshScope

Veri kaynağı, kapsamları yenilemelidir.

Sıralamalar
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Varsayılan değerdir, 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 program.

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

object (TimeOfDay)

Veri kaynağı yenilemenin planlandığı zaman aralığının başlangıç zamanı. Yalnızca hours bölümü kullanılır. Zaman aralığı boyutu, E-Tablolar düzenleyicisindeki varsayılan zaman aralığı değerine ayarlanır.

TimeOfDay

Günün saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. Bir API, artık saniyeye izin vermeyi seçebilir. İlgili türler: google.type.Date ve google.protobuf.Timestamp.

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

integer

24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır. Bir API, "24:00:00" değerine izin vermeyi seçebilir gibi senaryolar için oldukça yararlı olabilir.

minutes

integer

Günün saati (dakika cinsinden). 0 ile 59 arasında olmalıdır.

seconds

integer

Zamandaki dakikaların saniyeleri. Normalde 0 ile 59 arasında olmalıdır. Bir API, artık saniyeye izin veriyorsa 60 değerine izin verebilir.

nanos

integer

Nanosaniye cinsinden saniyenin kesirleri. 0 ile 999.999.999 arasında olmalıdır.

DataSourceRefreshWeeklySchedule

Belirli bir zaman aralığındaki belirli günlerde verilerin yenilenmesi için haftalık bir program.

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

object (TimeOfDay)

Veri kaynağı yenilemesinin planlandığı bir zaman aralığının başlangıç zamanı. Yalnızca hours kısmı kullanılır. Zaman aralığı boyutu, E-Tablolar düzenleyicisindeki varsayılan zaman aralığı değerine ayarlanır.

daysOfWeek[]

enum (DayOfWeek)

Haftanın yenilenecek 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

Belirli bir zaman aralığında ayın belirli günlerinde verilerin yenilenmesi için aylık bir program.

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

object (TimeOfDay)

Veri kaynağı yenilemesinin 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üzenleyicisindeki boyuta ayarlanır.

daysOfMonth[]

integer

Ayın yenilenecek günleri. Ayın 1'i ile 28. güne eşleme olmak üzere, yalnızca 1-28 grup desteklenir. En az bir gün belirtilmelidir.

Aralık

Zaman damgası başlangıcı (dahil) ve zaman damgası sonu (hariç) olarak kodlanmış bir zaman aralığını temsil eder.

Başlangıç, bitişten küçük veya bitişe eşit olmalıdır. Başlangıç, bitişle aynı olduğunda aralık boş olur (zaman ile eşleşmez). Hem başlangıç hem de bitiş belirtilmemişse aralık herhangi bir zamanla eşleşir.

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

string (Timestamp format)

İsteğe bağlı. Aralığın kapsayıcı başlangıcı.

Belirtilmişse bu aralıkla eşleşen bir Zaman Damgası'nın başlangıçla aynı veya başlangıçtan sonra olması gerekir.

endTime

string (Timestamp format)

İsteğe bağlı. Aralığın özel bitişi.

Belirtilirse bu aralıkla eşleşen bir zaman damgasının sonundan önce olması gerekir.

Yöntemler

batchUpdate

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

create

Yeni oluşturulan e-tabloyu döndürerek e-tablo oluşturur.

get

Verilen kimlikteki e-tabloyu döndürür.

getByDataFilter

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