REST Resource: spreadsheets.values
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: ValueRange
E-tablodaki bir aralıktaki veriler.
| JSON gösterimi |
{
"range": string,
"majorDimension": enum (Dimension),
"values": [
array
]
} |
| Alanlar |
range |
string
Değerlerin kapsadığı aralık (A1 gösterimi). Çıkış için bu aralık, değerler son satırları ve sütunları hariç tutsa bile istenen aralığın tamamını gösterir. Değer eklenirken bu alan, tablo aranacak ve ardından değerlerin ekleneceği aralığı temsil eder.
|
majorDimension |
enum (Dimension)
Değerlerin ana boyutu. Çıkış için e-tablo verileri A1=1,B1=2,A2=3,B2=4 ise range=A1:B2,majorDimension=ROWS isteğinde bulunulduğunda [[1,2],[3,4]], range=A1:B2,majorDimension=COLUMNS isteğinde bulunulduğunda ise [[1,3],[2,4]] döndürülür. Giriş için range=A1:B2,majorDimension=ROWS ve ardından [[1,2],[3,4]], A1=1,B1=2,A2=3,B2=4 değerini ayarlar. range=A1:B2,majorDimension=COLUMNS ile [[1,2],[3,4]], A1=1,B1=3,A2=2,B2=4 değerini ayarlar. Yazma sırasında bu alan ayarlanmazsa varsayılan olarak SATIRLAR olur.
|
values[] |
array (ListValue format)
Okunan veya yazılacak veriler. Bu, tüm verileri temsil eden dış dizi ve her bir iç dizi ana boyutu temsil eden bir dizi dizisidir. İç dizideki her öğe bir hücreye karşılık gelir. Çıkışta, sonuna boş satırlar ve sütunlar eklenmez. Giriş için desteklenen değer türleri: boole, dize ve çift. Boş değerler atlanır. Bir hücreyi boş değere ayarlamak için dize değerini boş dize olarak ayarlayın.
|
Yöntemler |
|
|
Bir e-tabloya değer ekler. |
|
|
E-tablodaki bir veya daha fazla değer aralığını temizler. |
|
|
E-tablodaki bir veya daha fazla değer aralığını temizler. |
|
|
Bir elektronik tablodaki bir veya daha fazla değer aralığını döndürür. |
|
|
Belirtilen veri filtreleriyle eşleşen bir veya daha fazla değer aralığını döndürür. |
|
|
Bir elektronik tablonun bir veya daha fazla aralığındaki değerleri ayarlar. |
|
|
Bir elektronik tablonun bir veya daha fazla aralığındaki değerleri ayarlar. |
|
|
E-tablodaki değerleri temizler. |
|
|
Bir e-tablodaki bir değer aralığını döndürür. |
|
|
E-tablodaki bir aralıktaki değerleri ayarlar. |
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,["# REST Resource: spreadsheets.values\n\n- [Resource: ValueRange](#ValueRange)\n - [JSON representation](#ValueRange.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ValueRange\n--------------------\n\nData within a range of the spreadsheet.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"range\": string, \"majorDimension\": enum (/workspace/sheets/api/reference/rest/v4/Dimension), \"values\": [ array ] } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `range` | `string` The range the values cover, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. |\n| `majorDimension` | `enum (`[Dimension](/workspace/sheets/api/reference/rest/v4/Dimension)`)` The major dimension of the values. For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` will return `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return `[[1,3],[2,4]]`. For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]` will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS` then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`. When writing, if this field is not set, it defaults to ROWS. |\n| `values[]` | `array (`[ListValue](https://protobuf.dev/reference/protobuf/google.protobuf/#list-value)` format)` The data that was read or to be written. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell. For output, empty trailing rows and columns will not be included. For input, supported value types are: bool, string, and double. Null values will be skipped. To set a cell to an empty value, set the string value to an empty string. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| ### [append](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append) | Appends values to a spreadsheet. |\n| ### [batchClear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClear) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchClearByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClearByDataFilter) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchGet](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet) | Returns one or more ranges of values from a spreadsheet. |\n| ### [batchGetByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGetByDataFilter) | Returns one or more ranges of values that match the specified data filters. |\n| ### [batchUpdate](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate) | Sets values in one or more ranges of a spreadsheet. |\n| ### [batchUpdateByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdateByDataFilter) | Sets values in one or more ranges of a spreadsheet. |\n| ### [clear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/clear) | Clears values from a spreadsheet. |\n| ### [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) | Returns a range of values from a spreadsheet. |\n| ### [update](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update) | Sets values in a range of a spreadsheet. |"]]
