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 nich „tabel”. Wartości zostaną dołączone do następnego wiersza tabeli, począwszy od pierwszej kolumny tabeli. Szczegółowe informacje o tym, jak wykrywane są tabele i dołączane do nich dane, znajdziesz w przewodniku oraz w przykładowym kodzie.

Rozmówca musi podać identyfikator arkusza kalkulacyjnego, zakres i valueInputOption. Zasada valueInputOption określa tylko sposób dodawania danych wejściowych do arkusza (na poziomie kolumny lub wiersza). Nie ma wpływu na komórkę, w której mają 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

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

Parametry zapytania

Parametry
valueInputOption

enum (ValueInputOption)

Sposób interpretacji danych wejściowych.
insertDataOption

enum (InsertDataOption)

Sposób wprowadzania danych wejściowych.
includeValuesInResponse

boolean

Określa, czy odpowiedź 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 wyświetlania dat, godzin i czasów 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 zostały zastosowane aktualizacje.
tableRange

string

Zakres (w notacji A1) tabeli, do której są dołączane wartości (przed dodaniem wartości). Brak wartości, jeśli nie znaleziono żadnej 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.

Opcja wstawiania danych

Określa, jak zmieniają się obecne dane w przypadku wprowadzenia nowych danych.

Wartości w polu enum
OVERWRITE Nowe dane zastępują te, które zostały zapisane. (Uwaga: dodanie danych na końcu arkusza spowoduje jeszcze wstawienie nowych wierszy lub kolumn w celu zapisania danych).
INSERT_ROWS Wstawione są wiersze nowych danych.