Method: spreadsheets.values.append

Dodaje wartości do arkusza kalkulacyjnego. Zakres danych wejściowych służy do wyszukiwania istniejących danych i znajdowania w tym zakresie „tabeli”. Wartości zostaną dołączone do następnego wiersza tabeli, zaczynając od pierwszej kolumny tabeli. Szczegółowe informacje o tym, jak wykrywane są tabele i jak dodawane są dane, znajdziesz w przewodniku i przykładowym kodzie.

Rozmówca musi podać identyfikator arkusza kalkulacyjnego, zakres i valueInputOption. Argument valueInputOption określa tylko, jak dane wejściowe mają być dodawane do arkusza (w wierszach czy kolumnach), ale nie ma wpływu na to, do której komórki mają być zapisywane.

Żądanie HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego, który chcesz zaktualizować.
range

string

Notacja A1 zakresu do wyszukiwania logicznej tabeli danych. Wartości są dołączane po ostatnim wierszu tabeli.

Parametry zapytania

Parametry
valueInputOption

enum (ValueInputOption)

Sposób interpretacji danych wejściowych.
insertDataOption

enum (InsertDataOption)

Sposób wstawiania danych wejściowych.
includeValuesInResponse

boolean

Określa, czy odpowiedź na aktualizację powinna zawierać wartości komórek, które zostały dołączone. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości.
responseValueRenderOption

enum (ValueRenderOption)

Określa sposób wyświetlania wartości w odpowiedzi. Domyślną opcją renderowania jest FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Określa sposób wyświetlania dat, godzin i czasów trwania w odpowiedzi. Jest on ignorowany, jeśli responseValueRenderOption ma wartość FORMATTED_VALUE. Domyślną opcją renderowania daty i czasu jest SERIAL_NUMBER.

Treść żądania

Treść żądania zawiera wystąpienie elementu ValueRange.

Treść odpowiedzi

Odpowiedź po zaktualizowaniu zakresu wartości w arkuszu kalkulacyjnym.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
Pola
spreadsheetId

string

Arkusz kalkulacyjny, w którym zastosowano aktualizacje.
tableRange

string

Zakres (w notacji A1) tabeli, do której są dołączane wartości (przed dołączeniem wartości). Pusty, jeśli nie znaleziono tabeli.
updates

object (UpdateValuesResponse)

Informacje o zastosowanych aktualizacjach.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

InsertDataOption

Określa, jak istniejące dane są zmieniane, gdy wprowadzasz nowe dane.

Wartości w polu enum
OVERWRITE Nowe dane zastąpią istniejące dane w obszarach, w których są zapisywane. (Uwaga: dodanie danych na końcu arkusza spowoduje wstawienie nowych wierszy lub kolumn, aby można było zapisać dane).
INSERT_ROWS Wstawiane są wiersze dla nowych danych.