REST Resource: spreadsheets.values
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع: ValueRange
داده ها در محدوده ای از صفحه گسترده.
| نمایندگی JSON |
|---|
{
"range": string,
"majorDimension": enum (Dimension),
"values": [
array
]
} |
| فیلدها |
|---|
range | string محدوده ای که مقادیر در نماد A1 پوشش می دهند. برای خروجی، این محدوده کل محدوده درخواستی را نشان می‌دهد، حتی اگر مقادیر ردیف‌ها و ستون‌های انتهایی را حذف کنند. هنگام اضافه کردن مقادیر، این فیلد محدوده جستجوی جدول را نشان می دهد و پس از آن مقادیر اضافه می شوند. |
majorDimension | enum ( Dimension ) بعد اصلی ارزش ها برای خروجی، اگر داده‌های صفحه‌گسترده عبارتند از: A1=1,B1=2,A2=3,B2=4 , آنگاه درخواست range=A1:B2,majorDimension=ROWS برمی‌گردد [[1,2],[3,4]] ، در حالی که range=A1:B2,majorDimension=COLUMNS [[1,3],[2,4]] برمی‌گردد. برای ورودی، با range=A1:B2,majorDimension=ROWS سپس [[1,2],[3,4]] A1=1,B1=2,A2=3,B2=4 تنظیم می شود. با range=A1:B2,majorDimension=COLUMNS سپس [[1,2],[3,4]] A1=1,B1=3,A2=2,B2=4 تنظیم می شود. هنگام نوشتن، اگر این فیلد تنظیم نشده باشد، به طور پیش فرض روی ROWS قرار می گیرد. |
values[] | array ( ListValue format) داده هایی که خوانده شده یا نوشته می شود. این آرایه ای از آرایه ها است، آرایه بیرونی نشان دهنده تمام داده ها و هر آرایه داخلی نشان دهنده یک بعد اصلی است. هر آیتم در آرایه داخلی با یک سلول مطابقت دارد. برای خروجی، ردیف‌ها و ستون‌های انتهایی خالی گنجانده نمی‌شوند. برای ورودی، انواع مقادیر پشتیبانی شده عبارتند از: bool، string و double. مقادیر تهی نادیده گرفته خواهند شد. برای تنظیم یک سلول روی یک مقدار خالی، مقدار رشته را روی یک رشته خالی قرار دهید. |
روش ها |
|---|
| مقادیر را به صفحه گسترده اضافه می کند. |
| یک یا چند محدوده از مقادیر را از یک صفحه گسترده پاک می کند. |
| یک یا چند محدوده از مقادیر را از یک صفحه گسترده پاک می کند. |
| یک یا چند محدوده از مقادیر را از یک صفحه‌گسترده برمی‌گرداند. |
| یک یا چند محدوده از مقادیر را برمی‌گرداند که با فیلترهای داده مشخص‌شده مطابقت دارند. |
| مقادیر را در یک یا چند محدوده از یک صفحه گسترده تنظیم می کند. |
| مقادیر را در یک یا چند محدوده از یک صفحه گسترده تنظیم می کند. |
| مقادیر را از صفحه گسترده پاک می کند. |
| محدوده ای از مقادیر را از یک صفحه گسترده برمی گرداند. |
| مقادیر را در محدوده ای از صفحه گسترده تنظیم می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-03-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-03-21 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
