Method: spreadsheets.values.append
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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/drivehttps://www.googleapis.com/auth/drive.filehttps://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. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-03-22 UTC.
[null,null,["Ostatnia aktualizacja: 2025-03-22 UTC."],[],[],null,["# Method: spreadsheets.values.append\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.AppendValuesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [InsertDataOption](#InsertDataOption)\n- [Try it!](#try-it)\n\nAppends values to a spreadsheet. The input range is used to search for existing data and find a \"table\" within that range. Values will be appended to the next row of the table, starting with the first column of the table. See the [guide](https://developers.google.com/workspace/sheets/api/guides/values#appending_values) and [sample code](https://developers.google.com/workspace/sheets/api/samples/writing#append_values) for specific details of how tables are detected and data is appended.\n\nThe caller must specify the spreadsheet ID, range, and a [valueInputOption](/workspace/sheets/api/reference/rest/v4/ValueInputOption). The `valueInputOption` only controls how the input data will be added to the sheet (column-wise or row-wise), it does not influence what cell the data starts being written to.\n\n### HTTP request\n\n`POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `spreadsheetId` | `string` The ID of the spreadsheet to update. |\n| `range` | `string` The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of a range to search for a logical table of data. Values are appended after the last row of the table. |\n\n### Query parameters\n\n| Parameters ||\n|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `valueInputOption` | `enum (`[ValueInputOption](/workspace/sheets/api/reference/rest/v4/ValueInputOption)`)` How the input data should be interpreted. |\n| `insertDataOption` | `enum (`[InsertDataOption](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append#InsertDataOption)`)` How the input data should be inserted. |\n| `includeValuesInResponse` | `boolean` Determines if the update response should include the values of the cells that were appended. By default, responses do not include the updated values. |\n| `responseValueRenderOption` | `enum (`[ValueRenderOption](/workspace/sheets/api/reference/rest/v4/ValueRenderOption)`)` Determines how values in the response should be rendered. The default render option is [FORMATTED_VALUE](/workspace/sheets/api/reference/rest/v4/ValueRenderOption). |\n| `responseDateTimeRenderOption` | `enum (`[DateTimeRenderOption](/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption)`)` Determines how dates, times, and durations in the response should be rendered. This is ignored if [responseValueRenderOption](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append#body.QUERY_PARAMETERS.response_value_render_option) is [FORMATTED_VALUE](/workspace/sheets/api/reference/rest/v4/ValueRenderOption). The default dateTime render option is [SERIAL_NUMBER](/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption). |\n\n### Request body\n\nThe request body contains an instance of [ValueRange](/workspace/sheets/api/reference/rest/v4/spreadsheets.values#ValueRange).\n\n### Response body\n\nThe response when updating a range of values in a spreadsheet.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"spreadsheetId\": string, \"tableRange\": string, \"updates\": { object (/workspace/sheets/api/reference/rest/v4/UpdateValuesResponse) } } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `spreadsheetId` | `string` The spreadsheet the updates were applied to. |\n| `tableRange` | `string` The range (in A1 notation) of the table that values are being appended to (before the values were appended). Empty if no table was found. |\n| `updates` | `object (`[UpdateValuesResponse](/workspace/sheets/api/reference/rest/v4/UpdateValuesResponse)`)` Information about the updates that were applied. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `https://www.googleapis.com/auth/drive.file`\n- `https://www.googleapis.com/auth/spreadsheets`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nInsertDataOption\n----------------\n\nDetermines how existing data is changed when new data is input.\n\n| Enums ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `OVERWRITE` | The new data overwrites existing data in the areas it is written. (Note: adding data to the end of the sheet will still insert new rows or columns so the data can be written.) |\n| `INSERT_ROWS` | Rows are inserted for the new data. |"]]
