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]] برمی‌گردد. [[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 و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-21 بهوقت ساعت هماهنگ جهانی."],[[["`ValueRange` resource represents a range of data within a spreadsheet, including the range, dimension, and the actual values."],["The `values` field in a `ValueRange` is an array of arrays, with the outer array representing all data and inner arrays representing rows or columns."],["You can interact with spreadsheet data using a variety of methods such as `append`, `batchGet`, `batchUpdate`, `clear`, `get`, and `update`, each offering different functionalities."]]],["`ValueRange` represents spreadsheet data within a specified range, using A1 notation. It has a JSON format that includes `range`, `majorDimension` (rows or columns), and `values` (an array of arrays representing cell data). Data can be read or written to spreadsheets using the listed methods. These methods allow appending, clearing, retrieving, and updating values, either individually or in batches, with or without data filters.\n"]]
