REST Resource: spreadsheets

Zasób: Arkusz kalkulacyjny

Zasób reprezentujący arkusz kalkulacyjny.

Zapis JSON 
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
Pola
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego. To pole jest tylko do odczytu.
properties

object (SpreadsheetProperties)

Ogólne właściwości arkusza kalkulacyjnego.
sheets[]

object (Sheet)

Arkusze, które są częścią arkusza kalkulacyjnego.
namedRanges[]

object (NamedRange)

Zakresy nazwane zdefiniowane w arkuszu kalkulacyjnym.
spreadsheetUrl

string

Adres URL arkusza kalkulacyjnego. To pole jest tylko do odczytu.
developerMetadata[]

object (DeveloperMetadata)

Metadane dewelopera powiązane z arkuszem kalkulacyjnym.
dataSources[]

object (DataSource)

Lista zewnętrznych źródeł danych połączonych z arkuszem kalkulacyjnym.
dataSourceSchedules[]

object (DataSourceRefreshSchedule)

Tylko dane wyjściowe. Lista harmonogramów odświeżania źródła danych.

SpreadsheetProperties

Właściwości arkusza kalkulacyjnego.

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

string

Tytuł arkusza kalkulacyjnego.
locale

string

Ustawienia regionalne arkusza kalkulacyjnego w jednym z tych formatów:

  • kod języka ISO 639-1, np. en

  • kod języka ISO 639-2, np. fil, jeśli nie istnieje kod 639-1;

  • kombinację kodu języka ISO i kodu kraju, np. en_US

Uwaga: podczas aktualizowania tego pola nie wszystkie języki są obsługiwane.
autoRecalc

enum (RecalculationInterval)

Czas oczekiwania przed ponownym obliczeniem funkcji zmiennych.
timeZone

string

Strefa czasowa arkusza kalkulacyjnego podana w formacie CLDR, np. America/New_York. Jeśli strefa czasowa nie zostanie rozpoznana, może to być niestandardowa strefa czasowa, np. GMT-07:00.
defaultFormat

object (CellFormat)

Domyślny format wszystkich komórek w arkuszu kalkulacyjnym. Ustawienie CellData.effectiveFormat nie zostanie ustawione, jeśli komórka ma taki sam format jak ten domyślny. To pole jest tylko do odczytu.
iterativeCalculationSettings

object (IterativeCalculationSettings)

Określa, czy i w jaki sposób odwołania cykliczne są rozstrzygane za pomocą obliczeń iteracyjnych. Brak tego pola oznacza, że odwołania cykliczne powodują błędy obliczeniowe.
spreadsheetTheme

object (SpreadsheetTheme)

Motyw został zastosowany do arkusza kalkulacyjnego.
importFunctionsExternalUrlAccessAllowed

boolean

Określa, czy zezwolić funkcjom obrazów i importowania na dostęp do zewnętrznych adresów URL. Tylko do odczytu, jeśli ma wartość true (prawda). Jeśli ustawisz wartość Fałsz, możesz ustawić wartość true (prawda). Ta wartość będzie pomijana i zawsze będzie zwracać wartość „prawda”, jeśli administrator włączył funkcję dodawania do listy dozwolonych.

RecalculationInterval

Lista możliwych opcji interwału ponownego obliczania.

Wartości w polu enum
RECALCULATION_INTERVAL_UNSPECIFIED Wartość domyślna. Tej wartości nie można używać.
ON_CHANGE Funkcje zmienne są aktualizowane po każdej zmianie.
MINUTE Funkcje zmienne są aktualizowane po każdej zmianie i co minutę.
HOUR Funkcje niezmienne są aktualizowane po każdej zmianie i co godzinę.

IterativeCalculationSettings

Ustawienia sterujące sposobem rozwiązywania zależności cyklicznych za pomocą obliczeń iteracyjnych.

Zapis JSON 
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Pola
maxIterations

integer

Gdy włączone są obliczenia iteracyjne, maksymalna liczba powtórzeń do wykonania.
convergenceThreshold

number

Gdy włączone są obliczenia iteracyjne, a kolejne wyniki różnią się o mniej niż ta wartość progowa, zaokrąglanie obliczeń zostanie zatrzymane.

SpreadsheetTheme

Reprezentuje motyw arkusza kalkulacyjnego

Zapis JSON 
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Pola
primaryFontFamily

string

Nazwa podstawowej rodziny czcionek.
themeColors[]

object (ThemeColorPair)

Pary kolorów motywu w arkuszu kalkulacyjnym. Aby przeprowadzić aktualizację, musisz podać wszystkie pary kolorów motywu.

ThemeColorPair

Para mapująca typ koloru motywu arkusza kalkulacyjnego na kolor betonowy, który reprezentuje.

Zapis JSON 
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Pola
colorType

enum (ThemeColorType)

Typ koloru motywu arkusza kalkulacyjnego.
color

object (ColorStyle)

Kolor betonu odpowiadający typowi koloru motywu.

NamedRange

Zakres nazwany.

Zapis JSON 
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Pola
namedRangeId

string

Identyfikator zakresu nazwanego.
name

string

Nazwa nazwanego zakresu.
range

object (GridRange)

Zakres reprezentowany przez tę wartość.

DataSource

Informacje o zewnętrznym źródle danych w arkuszu kalkulacyjnym.

Zapis JSON 
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Pola
dataSourceId

string

Unikalny identyfikator ograniczony do arkusza kalkulacyjnego, który identyfikuje źródło danych. Przykład: 1080547365.
spec

object (DataSourceSpec)

Pole DataSourceSpec źródła danych połączonego z tym arkuszem kalkulacyjnym.
calculatedColumns[]

object (DataSourceColumn)

Wszystkie obliczone kolumny w źródle danych.
sheetId

integer

Identyfikator elementu Sheet połączonego ze źródłem danych. Po ustawieniu pola nie można go zmienić.

Podczas tworzenia źródła danych tworzony jest też powiązany arkusz DATA_SOURCE. Jeśli pole nie jest określone, identyfikator utworzonego arkusza zostanie wygenerowany losowo.

DataSourceSpec

Podaje szczegóły źródła danych. Na przykład w BigQuery określa się informacje o źródle BigQuery.

Zapis JSON 
{
  "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.
}
Pola
parameters[]

object (DataSourceParameter)

Parametry źródła danych używane podczas wysyłania zapytań do źródła danych.
Pole sumy spec. Rzeczywista specyfikacja według typu źródła danych. spec może mieć tylko jedną z tych wartości:
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec.
looker

object (LookerDataSourceSpec)

[LookerDatasourceSpec][].

BigQueryDataSourceSpec

Specyfikacja źródła danych BigQuery połączonego z arkuszem.

Zapis JSON 
{
  "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.
}
Pola
projectId

string

Identyfikator projektu Google Cloud z włączoną usługą BigQuery, z dołączonym kontem rozliczeniowym. Za zapytania wykonywane w odniesieniu do źródła danych naliczana jest opłata za projekt.
Pole sumy spec. Rzeczywista specyfikacja. spec może mieć tylko jedną z tych wartości:
querySpec

object (BigQueryQuerySpec)

BigQueryQuerySpec.
tableSpec

object (BigQueryTableSpec)

BigQueryTableSpec.

BigQueryQuerySpec

Określa niestandardowe zapytanie BigQuery.

Zapis JSON 
{
  "rawQuery": string
}
Pola
rawQuery

string

Nieprzetworzony ciąg zapytania.

BigQueryTableSpec

Określa definicję tabeli BigQuery. Dozwolone są tylko tabele natywne.

Zapis JSON 
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
Pola
tableProjectId

string

Identyfikator projektu BigQuery, do którego należy tabela. Jeśli nie podasz żadnej wartości, zostanie domyślnie przyjęta wartość projectId.
tableId

string

Identyfikator tabeli BigQuery.
datasetId

string

Identyfikator zbioru danych BigQuery.

LookerDataSourceSpec

Specyfikacja źródła danych Lookera.

Zapis JSON 
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
Pola
instanceUri

string

Adres URL instancji Lookera.
model

string

Nazwa modelu Lookera.
explore

string

Nazwa wglądu w model Lookera.

DataSourceParameter

Parametr w zapytaniu do źródła danych. Ten parametr umożliwia użytkownikowi przekazywanie wartości z arkusza kalkulacyjnego do zapytania.

Zapis JSON 
{

  // 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.
}
Pola
Pole sumy identifier. Identyfikator parametru. identifier może mieć tylko jedną z tych wartości:
name

string

Nazwany parametr. Musi być prawidłowym identyfikatorem elementu DataSource, który go obsługuje. Na przykład identyfikator BigQuery.
Pole sumy value. Wartość parametru. value może mieć tylko jedną z tych wartości:
namedRangeId

string

Identyfikator elementu NamedRange. Jego rozmiar musi wynosić 1 x 1.
range

object (GridRange)

Zakres zawierający wartość parametru. Jego rozmiar musi wynosić 1 x 1.

DataSourceRefreshSchedule

Harmonogram odświeżania źródła danych.

Źródła danych w arkuszu kalkulacyjnym są odświeżane w określonym przedziale czasu. Możesz określić godzinę rozpoczęcia, klikając przycisk Zaplanowane odświeżenie w edytorze Arkuszy, ale jest on ustalony na 4 godziny. Jeśli na przykład ustawisz godzinę rozpoczęcia o 8:00, odświeżanie nastąpi codziennie między 8:00 a 12:00.

Zapis JSON 
{
  "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.
}
Pola
enabled

boolean

Wartość prawda, jeśli harmonogram odświeżania jest włączony, albo wartość Fałsz, jeśli jest włączony.
refreshScope

enum (DataSourceRefreshScope)

Zakres odświeżania. Musi to być wartość ALL_DATA_SOURCES.
nextRun

object (Interval)

Tylko dane wyjściowe. Przedział czasu następnego uruchomienia.
Pole sumy schedule_config. schedule_config może mieć tylko jedną z tych konfiguracji harmonogramu:
dailySchedule

object (DataSourceRefreshDailySchedule)

Dzienny harmonogram odświeżania.
weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Cotygodniowy harmonogram odświeżania.
monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Comiesięczny harmonogram odświeżania.

DataSourceRefreshScope

Zakresy odświeżania źródła danych.

Wartości w polu enum
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Wartość domyślna, nie używaj.
ALL_DATA_SOURCES Odświeża wszystkie źródła danych i powiązane z nimi obiekty w arkuszu kalkulacyjnym.

DataSourceRefreshDailySchedule

Harmonogram odświeżania danych codziennie w określonym przedziale czasu.

Zapis JSON 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Pola
startTime

object (TimeOfDay)

Godzina rozpoczęcia przedziału czasu, w którym zaplanowano odświeżenie źródła danych. Wykorzystana jest tylko część hours. Domyślny rozmiar przedziału czasu jest ustawiany na wartość domyślną w edytorze Arkuszy.

TimeOfDay

Przedstawia porę dnia. Data i strefa czasowa są nieistotne lub zostały określone w innym miejscu. Interfejs API może zezwolić na sekundy przestępne. Podobne typy to google.type.Date i google.protobuf.Timestamp.

Zapis JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Pola
hours

integer

Godziny dnia w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23. Interfejs API może zezwolić na wartość „24:00:00” w takich sytuacjach jak zamknięcie firmy.
minutes

integer

Minuty dnia. Wartość musi mieścić się w przedziale od 0 do 59.
seconds

integer

Sekundy czasu trwania. Zwykle musi mieścić się w zakresie od 0 do 59. Interfejs API może akceptować wartość 60, jeśli zezwala na użycie sekund przestępnych.
nanos

integer

Ułamki sekund w nanosekundach. Musi mieścić się w przedziale od 0 do 999 999 999.

DataSourceRefreshWeeklySchedule

Tygodniowy harmonogram odświeżania danych w określone dni w danym przedziale czasu.

Zapis JSON 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Pola
startTime

object (TimeOfDay)

Godzina rozpoczęcia przedziału czasu, w którym zaplanowano odświeżenie źródła danych. Wykorzystana jest tylko część hours. Domyślny rozmiar przedziału czasu jest ustawiany na wartość domyślną w edytorze Arkuszy.
daysOfWeek[]

enum (DayOfWeek)

Dni tygodnia do odświeżenia. Musisz określić co najmniej jeden dzień.

DzieńTygodnia

Przedstawia dzień tygodnia.

Wartości w polu enum
DAY_OF_WEEK_UNSPECIFIED Dzień tygodnia nie jest określony.
MONDAY Poniedziałek
TUESDAY Tuesday (wtorek)
WEDNESDAY Wednesday (środa)
THURSDAY Thursday (czwartek)
FRIDAY Friday (piątek)
SATURDAY Saturday (sobota)
SUNDAY niedziela

DataSourceRefreshMonthlySchedule

Miesięczny harmonogram odświeżania danych w określone dni miesiąca w wybranym przedziale czasu.

Zapis JSON 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Pola
startTime

object (TimeOfDay)

Godzina rozpoczęcia przedziału czasu, w którym zaplanowano odświeżenie źródła danych. Wykorzystana jest tylko część hours. Domyślny rozmiar przedziału czasu jest ustawiany na wartość domyślną w edytorze Arkuszy.
daysOfMonth[]

integer

Dni miesiąca, w których ma zostać odświeżona. Obsługiwane są tylko wartości od 1 do 28, przyporządkowane do okresu od 1 do 28 dnia. Musisz określić co najmniej jeden dzień.

Interwał

Reprezentuje przedział czasu zakodowany jako początek sygnatury czasowej (włącznie) i koniec sygnatury czasowej (bez jej uwzględnienia).

Początek nie może być dłuższy niż koniec. Gdy początek jest równy końcowi, interwał jest pusty (nie wskazuje czasu). Jeśli zarówno początek, jak i koniec nie są określone, interwał pasuje w dowolnym momencie.

Zapis JSON 
{
  "startTime": string,
  "endTime": string
}
Pola
startTime

string (Timestamp format)

Opcjonalnie: Rozpoczęcie uwzględniania przedziału czasowego.

Jeśli podasz sygnaturę czasową pasującą do tego interwału, będzie ona taka sama lub po jego rozpoczęciu.
endTime

string (Timestamp format)

Opcjonalnie: Wyłączny koniec interwału.

Jeśli określisz sygnaturę czasową pasującą do tego interwału, musi ona przypadać przed jego końcem.

Metody

batchUpdate

 Powoduje zastosowanie do arkusza kalkulacyjnego co najmniej jednej aktualizacji.

create

 Tworzy arkusz kalkulacyjny i zwraca nowo utworzony arkusz kalkulacyjny.

get

 Zwraca arkusz kalkulacyjny o podanym identyfikatorze.

getByDataFilter

 Zwraca arkusz kalkulacyjny o podanym identyfikatorze.