این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

REST Resource: spreadsheets.values

منبع: ValueRange
- نمایندگی JSON
روش ها

منبع: 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. مقادیر تهی نادیده گرفته خواهند شد. برای تنظیم یک سلول روی یک مقدار خالی، مقدار رشته را روی یک رشته خالی قرار دهید.

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. مقادیر تهی نادیده گرفته خواهند شد. برای تنظیم یک سلول روی یک مقدار خالی، مقدار رشته را روی یک رشته خالی قرار دهید.

روش ها
`append`	مقادیر را به صفحه گسترده اضافه می کند.
`batchClear`	یک یا چند محدوده از مقادیر را از یک صفحه گسترده پاک می کند.
`batchClearByDataFilter`	یک یا چند محدوده از مقادیر را از یک صفحه گسترده پاک می کند.
`batchGet`	یک یا چند محدوده از مقادیر را از یک صفحه‌گسترده برمی‌گرداند.
`batchGetByDataFilter`	یک یا چند محدوده از مقادیر را برمی‌گرداند که با فیلترهای داده مشخص‌شده مطابقت دارند.
`batchUpdate`	مقادیر را در یک یا چند محدوده از یک صفحه گسترده تنظیم می کند.
`batchUpdateByDataFilter`	مقادیر را در یک یا چند محدوده از یک صفحه گسترده تنظیم می کند.
`clear`	مقادیر را از صفحه گسترده پاک می کند.
`get`	محدوده ای از مقادیر را از یک صفحه گسترده برمی گرداند.
`update`	مقادیر را در محدوده ای از صفحه گسترده تنظیم می کند.

REST Resource: spreadsheets.values

منبع: ValueRange

روش ها

`append`

`batchClear`

`batchClearByDataFilter`

`batchGet`

`batchGetByDataFilter`

`batchUpdate`

`batchUpdateByDataFilter`

`clear`

`get`

`update`