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

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

Değişken işlevlerin yeniden hesaplanmadan önce beklenmesi gereken süre.
timeZone

string

E-tablonun saat dilimi (America/New_York gibi CLDR biçiminde). Saat dilimi tanınmıyorsa bu, 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 okunur.
iterativeCalculationSettings

object (IterativeCalculationSettings)

Yinelemeli hesaplamayla döngüsel referansların çö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 neden olduğu anlamına gelir.
spreadsheetTheme

object (SpreadsheetTheme)

E-tabloya uygulanan tema.
importFunctionsExternalUrlAccessAllowed

boolean

Görsel 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 dakika güncellenir.
HOUR Değişken işlevler her değişiklikte ve saatte bir güncellenir.

IterativeCalculationSettings

Yinelemeli hesaplamayla döngüsel bağımlılıkların nasıl çözüleceğini kontrol eden ayarlar.

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

integer

Yinelemeli hesaplama etkinleştirildiğinde, yapılacak maksimum hesaplama turu sayısı.
convergenceThreshold

number

Yinelenen hesaplama etkinleştirildiğinde ve art arda gelen sonuçlar bu eşik değerinden daha az farklı 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 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ış 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)

Bu değerin temsil ettiği aralık.

DataSource

E-tablodaki harici 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 değeri.
calculatedColumns[]

object (DataSourceColumn)

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

integer

Veri kaynağına bağlı Sheet öğesinin kimliği. 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

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)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
Alanlar
parameters[]

object (DataSourceParameter)

Veri kaynağını sorgularken kullanılan veri kaynağının parametreleri.
Birlik alanı spec. Her veri kaynağı türü için geçerli 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 özellikleri.

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

Faturalandırma hesabı bağlı olan, BigQuery özellikli bir Google Cloud projesinin kimliği. Veri kaynağına karşı yürütülen tüm sorgular için projeden ücret alınır.
Birlik alanı spec. Gerçek spesifikasyon. spec yalnızca aşağıdakilerden biri olabilir:
querySpec

object (BigQueryQuerySpec)

Bir BigQueryQuerySpec.
tableSpec

object (BigQueryTableSpec)

Bir BigQueryTableSpec.

BigQueryQuerySpec

Özel bir BigQuery sorgusunu belirtir.

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

string

Ham sorgu dizesi.

BigQueryTableSpec

Bir BigQuery tablosu 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

Bir 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 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. Desteklenen DataSource için geçerli bir tanımlayıcı olmalıdır. Örneğin, BigQuery tanımlayıcısı.
Birlik alanı value. Parametre değeri. value yalnızca aşağıdakilerden biri olabilir:
namedRangeId

string

Bir 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 planı.

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ıç saati olarak 08:00'i 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)
  },

  // 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 planı etkinse doğru, aksi takdirde yanlış değerini döndürü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ğı 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 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ığı zaman aralığının başlangıç zamanı. Yalnızca hours kısmı kullanılır. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindeki boyuta ayarlanır.

TimeOfDay

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

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

integer

Günün saati, 24 saatlik biçimde. 0 ile 23 arasında olmalıdır. Bir API, işletmenin kapanma zamanı gibi senaryolar için "24:00:00" değerine izin vermeyi seçebilir.
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, saniye atlamalarına izin veriyorsa 60 değerine izin verebilir.
nanos

integer

Nanosaniye cinsinden saniye kesirlerini belirtir. 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ğı yenilemenin planlandığı zaman aralığının başlangıç zamanı. Yalnızca hours kısmı kullanılır. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindeki boyuta ayarlanı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

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ğı yenilemenin planlandığı zaman aralığının başlangıç zamanı. Yalnızca hours kısmı kullanılır. Zaman aralığı boyutu varsayılan olarak E-Tablolar düzenleyicisindeki boyuta ayarlanır.
daysOfMonth[]

integer

Yenilenecek ayın günleri. Yalnızca 1-28 arası desteklenir. Bu değerler 1. ila 28. günle 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şten küçük veya ona eşit olmalıdır. Başlangıç bitişe eşit olduğunda aralık boştur (hiçbir zamanla eşleşmez). Hem başlangıç hem de bitiş 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ı. Aranın dahili başlangıcı.

Belirtilmişse bu aralıkla eşleşen bir Zaman Damgası, başlangıçla aynı veya başlangıçtan sonra olmalıdır.
endTime

string (Timestamp format)

İsteğe bağlı. Aranın bitiş zamanı (girilen tarihler dahil değil).

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

Yöntemler

batchUpdate

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

create

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