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

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