REST Resource: spreadsheets

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

string

Identyfikator arkusza kalkulacyjnego. To pole jest tylko do odczytu.

object (SpreadsheetProperties)

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

object (Sheet)

Arkusze będące częścią arkusza kalkulacyjnego.

object (NamedRange)

Zakresy nazwane zdefiniowane w arkuszu kalkulacyjnym.

string

Adres URL arkusza kalkulacyjnego. To pole jest tylko do odczytu.

object (DeveloperMetadata)

Metadane dewelopera powiązane z arkuszem kalkulacyjnym.

object (DataSource)

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

object (DataSourceRefreshSchedule)

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

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

string

Tytuł arkusza kalkulacyjnego.

string

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

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

• kod języka w formacie 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 języki są obsługiwane.

enum (RecalculationInterval)

Czas oczekiwania na ponowne obliczenie funkcji zmiennych.

string

Strefa czasowa arkusza kalkulacyjnego 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.

object (CellFormat)

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

object (IterativeCalculationSettings)

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

object (SpreadsheetTheme)

Motyw zastosowany do arkusza kalkulacyjnego.

{
  "maxIterations": integer,
  "convergenceThreshold": number
}

integer

Gdy włączone jest obliczenia iteracyjne, maksymalna liczba powtórzeń podczas obliczeń.

number

Gdy obliczenia iteracyjne są włączone, a wyniki po kolei różnią się od tej wartości progowej, cykle obliczania są zatrzymane.

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

string

Nazwa głównej rodziny czcionek.

object (ThemeColorPair)

Pary kolorystyczne motywu arkusza kalkulacyjnego. Aby przeprowadzić aktualizację, musisz podać wszystkie pary kolorów motywu.

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

enum (ThemeColorType)

Typ koloru motywu arkusza kalkulacyjnego.

object (ColorStyle)

Betonowy kolor odpowiadający typowi koloru motywu.

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

string

Identyfikator zakresu nazwanego.

string

Nazwa zakresu nazwanego.

object (GridRange)

Zakres, który reprezentuje.

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

string

Unikalny identyfikator ograniczony do arkusza kalkulacyjnego identyfikujący źródło danych. Przykład: 1080547365.

object (DataSourceSpec)

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

object (DataSourceColumn)

Wszystkie obliczone kolumny w źródle danych.

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 powiązany arkusz DATA_SOURCE. Jeśli nie określisz wartości pola, identyfikator utworzonego arkusza zostanie wygenerowany losowo.

{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  }
}

object (DataSourceParameter)

Parametry źródła danych używane podczas wysyłania zapytań do źródła danych.

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec

{
  "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.
}

string

Identyfikator projektu GCP obsługującego BigQuery z dołączonym kontem rozliczeniowym. Opłata zostanie naliczona za każde zapytanie wykonane na źródle danych.

object (BigQueryQuerySpec)

BigQueryQuerySpec

object (BigQueryTableSpec)

BigQueryTableSpec

{
  "rawQuery": string
}

string

Nieprzetworzony ciąg zapytania.

{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}

string

Identyfikator projektu BigQuery, do którego należy tabela. Jeśli nie zostanie podany, przyjmuje się wartość projectId.

string

Identyfikator tabeli BigQuery.

string

Identyfikator zbioru danych BigQuery.

{
  "name": string,

  // 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.
}

string

Parametr nazwany. Musi być prawidłowym identyfikatorem zasobu DataSource, który go obsługuje. Na przykład Identyfikator BigQuery.

string

Identyfikator elementu NamedRange. Jej rozmiar musi wynosić 1 x 1.

object (GridRange)

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

{
  "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.
}

boolean

Wartość to „prawda”, jeśli harmonogram odświeżania jest włączony, lub „fałsz”, jeśli nie.

enum (DataSourceRefreshScope)

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

object (Interval)

Tylko dane wyjściowe. Przedział czasu następnego uruchomienia.

object (DataSourceRefreshDailySchedule)

Dzienny harmonogram odświeżania.

object (DataSourceRefreshWeeklySchedule)

Cotygodniowy harmonogram odświeżania.

object (DataSourceRefreshMonthlySchedule)

Harmonogram odświeżania miesięcznego.

{
  "startTime": {
    object (TimeOfDay)
  }
}

object (TimeOfDay)

Godzina rozpoczęcia przedziału czasu, w którym zaplanowane jest odświeżenie źródła danych. Użyta jest tylko część hours. Domyślny odstęp czasu jest taki sam w edytorze Arkuszy.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

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

integer

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

integer

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

integer

Ułamki sekund w nanosekundach. Wartość musi mieścić się w zakresie od 0 do 999 999 999.

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

object (TimeOfDay)

Godzina rozpoczęcia przedziału czasu, w którym zaplanowane jest odświeżenie źródła danych. Użyta jest tylko część hours. Domyślny odstęp czasu jest taki sam w edytorze Arkuszy.

enum (DayOfWeek)

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

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

object (TimeOfDay)

Godzina rozpoczęcia przedziału czasu, w którym zaplanowane jest odświeżenie źródła danych. Użyta jest tylko część hours. Domyślny odstęp czasu jest taki sam w edytorze Arkuszy.

integer

Dni miesiąca do odświeżenia. Obsługiwane jest tylko 1–28 mapowań z 1 na 28 dnia. Należy określić co najmniej jeden dzień.

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

Opcjonalnie. Początek przedziału czasu.

Jeśli zostanie określona, sygnatura czasowa pasująca do tego interwału musi być taka sama lub po rozpoczęciu.

string (Timestamp format)

Opcjonalnie. Wyłączny koniec przedziału czasu.

Jeśli podasz wartość, sygnatura czasowa pasująca do tego interwału będzie musiała przypadać przed końcem.