Method: spreadsheets.values.append

Dodaje wartości do arkusza kalkulacyjnego. Zakres wejściowy służy do wyszukiwania istniejących danych i znajdowania „tabeli” w tym zakresie. Wartości zostaną dodane do następnego wiersza tabeli, zaczynając od pierwszej kolumny tabeli. Szczegółowe informacje o sposobie wykrywania tabel i dołączania danych znajdziesz w przewodniku i w przykładowym kodzie.

Element wywołujący musi podać identyfikator arkusza kalkulacyjnego, zakres i valueInputOption. Zasada valueInputOption decyduje tylko o sposobie dodawania danych wejściowych do arkusza (według kolumny lub wiersza). Nie ma wpływu na to, w której komórce zaczną być zapisywane dane.

Żą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 do zaktualizowania.
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 dołączonych komórek. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości.
responseValueRenderOption

enum (ValueRenderOption)

Określa sposób renderowania wartości w odpowiedzi. Domyślna opcja renderowania to FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Określa sposób renderowania dat, godzin i czasu trwania odpowiedzi. Ta wartość jest ignorowana, jeśli responseValueRenderOption ma wartość FORMATTED_VALUE. Domyślna opcja renderowania dateTime to SERIAL_NUMBER.

Treść żądania

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

Treść odpowiedzi

Odpowiedź podczas aktualizowania 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, do którego zastosowano zmiany.
tableRange

string

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

object (UpdateValuesResponse)

Informacje o zastosowanych aktualizacjach.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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 na temat autoryzacji.

InsertDataOption

Określa, jak istniejące dane są zmieniane po wprowadzeniu nowych danych.

Wartości w polu enum
OVERWRITE Nowe dane zastępują dane istniejące w zapisanych obszarach. (Uwaga: dodanie danych na końcu arkusza spowoduje wstawienie nowych wierszy lub kolumn, dzięki czemu będzie można je zapisać).
INSERT_ROWS Wiersze z nowymi danymi zostaną wstawione.