Method: spreadsheets.values.append

Dodaje wartości do arkusza kalkulacyjnego. Zakres wejściowy służy do wyszukiwania istniejących danych i znalezienia „tabeli” z tego zakresu. Wartości zostaną dołączone do następnego wiersza tabeli, zaczynając od pierwszej kolumny tabeli. Szczegółowe informacje o wykrywaniu tabel i dołączaniu danych znajdziesz w przewodniku i przykładowym kodzie.

Element wywołujący musi określić identyfikator arkusza kalkulacyjnego, zakres i valueInputOption. Pole valueInputOption określa tylko sposób dodawania danych wejściowych do arkusza (według kolumn lub wierszy). Nie ma wpływu na to, w której komórce będą 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

Zapis A1 zakresu służący do wyszukiwania tabeli logicznej danych. Wartości są dodawane po ostatnim wierszu tabeli.

Parametry zapytania

Parametry
valueInputOption

enum (ValueInputOption)

Jak należy interpretować dane wejściowe.
insertDataOption

enum (InsertDataOption)

Sposób wstawiania danych wejściowych.
includeValuesInResponse

boolean

Określa, czy odpowiedź aktualizacji powinna zawierać wartości z 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ślną opcją renderowania jest 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ślną opcją renderowania daty i godziny jest SERIAL_NUMBER.

Treść żądania

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

Treść odpowiedzi

Odpowiedź wyświetlana 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 wartości są dołączane (przed dołączeniem wartości). Puste, 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 po autoryzacji.

InsertDataOption

Określa, jak istniejące dane zmieniają się po wprowadzeniu nowych danych.

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