REST Resource: spreadsheets

Kaynak: E-tablo

Bir 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 okunurdur.
properties

object (SpreadsheetProperties)

Bir 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 okunurdur.
developerMetadata[]

object (DeveloperMetadata)

Bir e-tablo ile 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 programları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 America/New_York gibi CLDR biçimindeki saat dilimi. 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ümleneceğini belirler. Bu alanın eksik olması, döngüsel referansların hesaplama hatalarına neden olacağı anlamına gelir.
spreadsheetTheme

object (SpreadsheetTheme)

E-tabloya uygulanan tema.
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 değeri doğru olarak ayarlayabilirsiniz.

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 teması renk çiftleri. Güncellemek için tüm tema renk çiftlerini sağlamanız gerekir.

ThemeColorPair

Bir 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 bir veri kaynağıyla ilgili 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 öğesi.
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.

Veri kaynağı oluşturulurken ilişkili bir DATA_SOURCE sayfası da oluşturulur. Alan belirtilmemişse 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.
Birleştirme alanı spec. Veri kaynağı türü başına gerçek spesifikasyon. spec şunlardan yalnızca biri olabilir:
bigQuery

object (BigQueryDataSourceSpec)

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 şunlardan yalnızca biri olabilir:
querySpec

object (BigQueryQuerySpec)

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. Belirtilmezse projectId varsayılır.
tableId

string

BigQuery tablosunun 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. Bu parametre, kullanıcının e-tablodan bir sorguya değer aktarmasına 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
Birleştirme alanı identifier. Parametre tanımlayıcısı. identifier şunlardan yalnızca 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 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üzenleyicisinde Planlı Yenileme düğmesini tıklayarak başlangıç zamanını belirtebilirsiniz, ancak aralık 4 saat olarak sabittir. Ö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ış. Bir sonraki çalıştırmanın zaman aralığı.
Birleştirme alanı schedule_config. schedule_config program yapılandırmaları aşağıdakilerden yalnızca biri olabilir:
dailySchedule

object (DataSourceRefreshDailySchedule)

Günlük yenileme planı.
weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Haftalık yenileme planı.
monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Aylık yenileme planı.

DataSourceRefreshScope

Veri kaynağı, kapsamları yenilemelidir.

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 yenilenmesiyle ilgili program.

JSON gösterimi 
{
  "startTime": {
    object (TimeOfDay)
  }
}
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, 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 saatindeki dakikalar. 0 ile 59 arasında olmalıdır.
seconds

integer

Saniye cinsinden dakika. 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

Verilerin belirli bir zaman aralığında belirli günlerde yenilenmesi için haftalık 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 bölümü 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

Verilerin belirli bir zaman aralığında ayın belirli günlerinde yenilenmesi için aylık 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, E-Tablolar düzenleyicisindeki varsayılan zaman aralığı değerine 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ı.

Belirtilirse 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

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