- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- InsertDataOption
- Wypróbuj
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 |
Identyfikator arkusza kalkulacyjnego do zaktualizowania. |
range |
Zapis A1 zakresu służący do wyszukiwania tabeli logicznej danych. Wartości są dodawane po ostatnim wierszu tabeli. |
Parametry zapytania
Parametry | |
---|---|
valueInputOption |
Jak należy interpretować dane wejściowe. |
insertDataOption |
Sposób wstawiania danych wejściowych. |
includeValuesInResponse |
Określa, czy odpowiedź aktualizacji powinna zawierać wartości z dołączonych komórek. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości. |
responseValueRenderOption |
Określa sposób renderowania wartości w odpowiedzi. Domyślną opcją renderowania jest |
responseDateTimeRenderOption |
Określa sposób renderowania dat, godzin i czasu trwania odpowiedzi. Ta wartość jest ignorowana, jeśli |
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 ( |
Pola | |
---|---|
spreadsheetId |
Arkusz kalkulacyjny, do którego zastosowano zmiany. |
tableRange |
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 |
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. |