Method: spreadsheets.values.append
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir e-tabloya değer ekler. Giriş aralığı, mevcut verileri aramak ve bu aralıktaki bir "tabloyu" bulmak için kullanılır. Değerler, tablonun ilk sütunundan başlayarak tablonun sonraki satırına eklenir. Tabloların nasıl algılandığı ve verilerin nasıl eklendiğiyle ilgili ayrıntılı bilgi için kılavuzu ve örnek kodu inceleyin.
Arayan, e-tablo kimliğini, aralığı ve bir valueInputOption belirtmelidir. valueInputOption yalnızca giriş verilerinin e-tabloya nasıl ekleneceğini (sütun veya satır bazında) kontrol eder, verilerin hangi hücreye yazılmaya başlanacağını etkilemez.
HTTP isteği
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
spreadsheetId |
string
Güncellenecek e-tablonun kimliği.
|
range |
string
Mantıksal bir veri tablosu aramak için bir aralığın A1 gösterimi. Değerler, tablonun son satırından sonra eklenir.
|
Sorgu parametreleri
| Parametreler |
valueInputOption |
enum (ValueInputOption)
Giriş verilerinin nasıl yorumlanması gerektiği.
|
insertDataOption |
enum (InsertDataOption)
Giriş verilerinin nasıl ekleneceği.
|
includeValuesInResponse |
boolean
Güncelleme yanıtının, eklenen hücrelerin değerlerini içerip içermeyeceğini belirler. Yanıtlar varsayılan olarak güncellenmiş değerleri içermez.
|
responseValueRenderOption |
enum (ValueRenderOption)
Yanıttaki değerlerin nasıl oluşturulacağını belirler. Varsayılan oluşturma seçeneği FORMATTED_VALUE'tür.
|
responseDateTimeRenderOption |
enum (DateTimeRenderOption)
Yanıttaki tarih, saat ve sürelerin nasıl oluşturulacağını belirler. responseValueRenderOption FORMATTED_VALUE ise bu yoksayılır. Varsayılan dateTime oluşturma seçeneği SERIAL_NUMBER'tür.
|
İstek içeriği
İstek metni, ValueRange öğesinin bir örneğini içerir.
Yanıt gövdesi
E-tabloda bir değer aralığı güncellendiğinde verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object (UpdateValuesResponse)
}
} |
| Alanlar |
spreadsheetId |
string
Güncellemelerin uygulandığı e-tablo.
|
tableRange |
string
Değerlerin ekleneceği tablonun (A1 gösterimindeki) aralığı (değerlerin eklenmesinden önce). Tablo bulunamadıysa boştur.
|
updates |
object (UpdateValuesResponse)
Uygulanan güncellemeler hakkında bilgi.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
InsertDataOption
Yeni veriler girildiğinde mevcut verilerin nasıl değiştirileceğini belirler.
| Sıralamalar |
OVERWRITE |
Yeni veriler, yazıldığı alanlarda mevcut verilerin üzerine yazılır. (Not: E-tablonun sonuna veri eklediğinizde, verilerin yazılabilmesi için yeni satırlar veya sütunlar eklenir.) |
INSERT_ROWS |
Yeni veriler için satırlar eklenir. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-03-22 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]
