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)

Bir 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)

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 yerel ayarı şu biçimlerden birinde olmalıdır:

  • en gibi bir ISO 639-1 dil kodu

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

  • ISO dil kodu ile ülke kodunun birleşimi (ö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 CLDR biçimindeki saat dilimi (ör. America/New_York). 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 referansların yinelemeli hesaplamayla çözümlenip çözümlenmeyeceğini ve nasıl çözümleneceğini belirler. Bu alanın olmaması, döngüsel referansların hesaplama hatalarına yol açacağı 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. Yalnızca doğru olduğunda okunur. Yanlış değerini ise true olarak ayarlayabilirsiniz.

RecalculationInterval

Olası yeniden hesaplama aralığı seçeneklerinin numaralandırması.

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

ThemeColorPair

E-tablo tema renk türünü temsil ettiği somut renge 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 renk türüne karşılık gelen beton rengi.

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ğı 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ğı için DataSourceSpec.
calculatedColumns[]

object (DataSourceColumn)

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

integer

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

Veri kaynağı oluştururken, ilişkili bir DATA_SOURCE sayfası da oluşturulur. Alan belirtilmemişse, 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ğıyla ilgili bilgileri belirtir.

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

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

object (DataSourceParameter)

Veri kaynağı sorgulanırken kullanılan, veri kaynağı parametreleri.
Birleştirme alanı spec. Her veri kaynağı türü için gerçek spesifikasyondur. spec şunlardan yalnızca biri olabilir:
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec.

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ının ekli olduğu bir Google Cloud projesinin kimliğidir. Veri kaynağına karşı yürütülen 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 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. Belirtilmezse projectId kabul edilir.
tableId

string

BigQuery tablosu kimliği.
datasetId

string

BigQuery veri kümesi kimliği.

DataSourceParameter

Bir veri kaynağının sorgusundaki parametre. Parametre, kullanıcının e-tablodan 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. DataSource için geçerli olan ve bunu destekleyen 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 yenilenmesini planlayı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 sabitlenir. Örneğin, başlangıç saati olarak 08:00'i belirtirseniz yenileme her gün 08:00-12:00 saatleri 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 programı 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ığı.
Birleştirme alanı schedule_config. schedule_config program yapılandırmaları 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 programı.

DataSourceRefreshScope

Veri kaynağı yenileme kapsamları.

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 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ıyor. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindeki boyuta ayarlanır.

TimeOfDay

Günün saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. API'ler artık saniyeler eklemeye izin verebilir. İ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. API'ler, işletmenin kapanış saati gibi senaryolar için "24:00:00" değerine izin vermeyi tercih edebilir.
minutes

integer

Günün saati dakika cinsinden ifade edilir. 0 ile 59 arasında olmalıdır.
seconds

integer

Dakika cinsinden saniye sayısı. Normalde 0 ile 59 arasında olmalıdır. API'ler artık saniyelere izin veriyorsa 60 değerine izin verebilir.
nanos

integer

Saniyenin nanosaniye cinsinden kesirleri. 0 ile 999.999.999 arasında olmalıdır.

DataSourceRefreshWeeklySchedule

Verilerin belirli bir zaman aralığındaki 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ıyor. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindeki boyuta ayarlanır.
daysOfWeek[]

enum (DayOfWeek)

Haftanın yenileneceği günler. En az bir gün belirtilmelidir.

DayOfWeek

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

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmedi.
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 plan.

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ıyor. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindeki boyuta ayarlanır.
daysOfMonth[]

integer

Yenilenecek ayın günleri. Yalnızca 1-28 yaş aralığı desteklenmektedir. Bu sayı, 1. gün ile 28. güne eşlenir. 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şe eşit veya daha küçük olmalıdır. Başlangıç bitişi eşitse aralık boş olur (zamanla eşleşmez). Hem başlangıç hem de bitiş değeri belirtilmediğinde, 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 Zaman Damgası, başlangıçla aynı veya daha sonra olmalıdır.
endTime

string (Timestamp format)

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

Belirtilirse bu aralıkla eşleşen bir Zaman Damgası, bitiş tarihinden önce olmalıdır.

Yöntemler

batchUpdate

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

create

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

get

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

getByDataFilter

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