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)

Nazwane zakresy 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ódeł 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

Lokalizację 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 ma kodu 639-1;

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

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

enum (RecalculationInterval)

Czas oczekiwania przed ponownym obliczeniem funkcji zmiennych.
timeZone

string

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

object (CellFormat)

Domyślny format wszystkich komórek w arkuszu kalkulacyjnym. CellData.effectiveFormat nie zostanie ustawiony, jeśli format komórki jest równy temu domyślnemu. To pole jest tylko do odczytu.
iterativeCalculationSettings

object (IterativeCalculationSettings)

Określa, czy i jak odwołania cykliczne są rozwiązywane przy użyciu obliczeń iteracyjnych. Brak tego pola oznacza, że odwołania cykliczne powodują błędy obliczeń.
spreadsheetTheme

object (SpreadsheetTheme)

Motyw zastosowany do arkusza kalkulacyjnego.
importFunctionsExternalUrlAccessAllowed

boolean

Określa, czy funkcje importowania i obsługi obrazu mają mieć dostęp do zewnętrznych adresów URL. Tylko do odczytu, gdy jest to prawda. Jeśli jest ustawiona na wartość false, możesz ją zmienić na wartość true. Ta wartość zostanie pominięta i zawsze zwróci wartość Prawda, jeśli administrator włączył funkcję listy dozwolonych.

RecalculationInterval

Wyliczenie możliwych opcji interwału ponownego obliczania.

Wartości w polu enum
RECALCULATION_INTERVAL_UNSPECIFIED Wartość domyślna. Nie należy używać tej wartości.
ON_CHANGE Funkcje zmienne są aktualizowane przy każdej zmianie.
MINUTE Funkcje zmienne są aktualizowane przy każdej zmianie i co minutę.
HOUR Funkcje zmienne są aktualizowane przy każdej zmianie i co godzinę.

IterativeCalculationSettings

Ustawienia określające sposób 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 rund obliczeń do wykonania.
convergenceThreshold

number

Gdy włączona jest iteracyjna kalkulacja, a kolejne wyniki różnią się od siebie mniej niż o wartość progową, zaokrąglanie wyników przestaje działać.

SpreadsheetTheme

Reprezentuje motyw arkusza kalkulacyjnego

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

string

Nazwa głównej rodziny czcionek.
themeColors[]

object (ThemeColorPair)

Pary kolorów motywu arkusza kalkulacyjnego. Aby zaktualizować, musisz podać wszystkie pary kolorów motywu.

ThemeColorPair

Para, która mapuje typ koloru motywu arkusza kalkulacyjnego na konkretny kolor.

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

enum (ThemeColorType)

Typ koloru motywu arkusza kalkulacyjnego.
color

object (ColorStyle)

Kolor odpowiadający danemu typowi koloru motywu.

NamedRange

Zakres nazwany.

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

string

Identyfikator zakresu nazwanego.
name

string

Nazwa zakresu nazwanego.
range

object (GridRange)

Zakres, który reprezentuje.

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)

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

object (DataSourceColumn)

Wszystkie obliczone kolumny w źródle danych.
sheetId

integer

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

Podczas tworzenia źródła danych tworzona jest też powiązana karta DATA_SOURCE. Jeśli to pole nie zostanie określone, identyfikator utworzonej karty zostanie wygenerowany losowo.

DataSourceSpec

Wskazuje szczegóły źródła danych. W przypadku BigQuery określa on 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 tego źródła.
Pole unii spec. Rzeczywista specyfikacja dla danego typu źródła danych. spec może być tylko jednym z tych elementów:
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 każde zapytanie wykonane w źródle danych naliczana jest opłata.
Pole unii spec. Rzeczywista specyfikacja. spec może być tylko jednym z tych elementów:
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 opcji, zostanie użyta wartość domyślna projectId.
tableId

string

Identyfikator tabeli BigQuery.
datasetId

string

Identyfikator zbioru danych BigQuery.

LookerDataSourceSpec

Specyfikacja źródła danych Looker.

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

string

Adres URL instancji Lookera.
model

string

Nazwa modelu Lookera.
explore

string

Nazwa eksploracji modelu Lookera.

DataSourceParameter

Parametr w zapytaniu źródła danych. Parametr pozwala użytkownikowi przekazywać 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 unii identifier. Identyfikator parametru. identifier może być tylko jednym z tych elementów:
name

string

Parametr nazwany. Musi to być prawidłowy identyfikator DataSource, który go obsługuje. Na przykład identyfikator BigQuery.
Pole unii value. wartość parametru. value może być tylko jednym z tych elementów:
namedRangeId

string

Identyfikator 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ć czas rozpoczęcia, klikając przycisk zaplanowanego odświeżania w edytorze Arkuszy, ale interwał jest stały i wynosi 4 godziny. Jeśli np. określisz godzinę rozpoczęcia na 8:00, odświeżanie będzie odbywać się 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ść true, jeśli harmonogram odświeżania jest włączony, lub false w przeciwnym razie.
refreshScope

enum (DataSourceRefreshScope)

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

object (Interval)

Tylko dane wyjściowe. Przedział czasu do następnego uruchomienia.
Pole unii schedule_config. Konfiguracje harmonogramu schedule_config mogą mieć tylko jedną z tych wartości:
dailySchedule

object (DataSourceRefreshDailySchedule)

Harmonogram codziennego odświeżania.
weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Harmonogram odświeżania co tydzień.
monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Harmonogram odświeżania miesięcznego.

DataSourceRefreshScope

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

Wartości w polu enum
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Wartość domyślna, której nie należy używać.
ALL_DATA_SOURCES odświeża w arkuszu kalkulacyjnym wszystkie źródła danych i powiązane z nimi obiekty źródeł danych;

DataSourceRefreshDailySchedule

harmonogram odświeżania danych codziennie w określonym przedziale czasu;

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

object (TimeOfDay)

Czas rozpoczęcia przedziału czasowego, w którym zaplanowano odświeżanie źródła danych. Wykorzystywana jest tylko część hours. Rozmiar przedziału czasowego jest domyślnie ustawiany zgodnie z ustawieniami w edytorze Arkuszy.

TimeOfDay

Odpowiada on porze dnia. Strefa czasowa i data są nieistotne lub są określone gdzie indziej. Interfejs API może zezwalać na sekundy przeskoku. Powiązane typy to google.type.Date i google.protobuf.Timestamp.

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

integer

Godziny 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 przypadku scenariuszy takich jak godziny zamknięcia firmy.
minutes

integer

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

integer

sekundy, Wartość musi mieścić się w zakresie od 0 do 59. Interfejs API może zezwalać na wartość 60, jeśli zezwala na sekundy przestępne.
nanos

integer

Ułamki sekundy w nanosekundach. Należy podać wartość od 0 do 999 999 999.

DataSourceRefreshWeeklySchedule

Tygodniowy harmonogram odświeżania danych w określonych dniach w określonym przedziale czasu.

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

object (TimeOfDay)

Czas rozpoczęcia przedziału czasowego, w którym zaplanowano odświeżanie źródła danych. Wykorzystywana jest tylko część hours. Rozmiar przedziału czasowego jest domyślnie ustawiany zgodnie z ustawieniami w edytorze Arkuszy.
daysOfWeek[]

enum (DayOfWeek)

Dni tygodnia, w których ma nastąpić odświeżanie. Musisz określić co najmniej 1 dzień.

DzieńTygodnia

Reprezentuje dzień tygodnia.

Wartości w polu enum
DAY_OF_WEEK_UNSPECIFIED Dzień tygodnia jest nieokreś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ślonych dniach miesiąca w określonym przedziale czasu.

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

object (TimeOfDay)

Czas rozpoczęcia przedziału czasowego, w którym zaplanowano odświeżanie źródła danych. Wykorzystywana jest tylko część hours. Rozmiar przedziału czasowego jest domyślnie ustawiany zgodnie z ustawieniami w edytorze Arkuszy.
daysOfMonth[]

integer

Dni miesiąca, w których ma być przeprowadzane odświeżanie. Obsługiwane są tylko wartości od 1 do 28, które odpowiadają 1–28 dniom. Musisz określić co najmniej 1 dzień.

Interwał

Reprezentuje przedział czasu zakodowany jako sygnatura czasowa rozpoczęcia (włącznie) i sygnatura czasowa zakończenia (wyłącznie).

Data rozpoczęcia musi być wcześniejsza lub taka sama jak data zakończenia. Gdy początek jest równy końcowi, przedział jest pusty (nie odpowiada żadnemu czasowi). Jeśli nie określono ani początku, ani końca, przedział pasuje do dowolnego czasu.

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

string (Timestamp format)

Opcjonalnie: Początek przedziału (włącznie).

Jeśli zostanie określona, sygnatura czasowa musi być taka sama jak sygnatura czasowa rozpoczęcia lub późniejsza.
endTime

string (Timestamp format)

Opcjonalnie: Koniec przedziału (wyłącznie).

Jeśli jest podany, sygnatura czasowa musi być krótsza niż czas zakończenia.

Metody

batchUpdate

 Zastosuj co najmniej jedną aktualizację w arkuszu kalkulacyjnym.

create

 Tworzy arkusz kalkulacyjny i zwraca nowo utworzony arkusz.

get

 Zwraca arkusz kalkulacyjny o podanym identyfikatorze.

getByDataFilter

 Zwraca arkusz kalkulacyjny o podanym identyfikatorze.