Method: spreadsheets.values.update

مقادیر را در محدوده ای از صفحه گسترده تنظیم می کند. تماس گیرنده باید شناسه صفحه گسترده، محدوده و یک valueInputOption مشخص کند.

درخواست HTTP

PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
spreadsheetId

string

شناسه صفحه‌گسترده برای به‌روزرسانی.

range

string

نماد A1 از مقادیر برای به روز رسانی.

پارامترهای پرس و جو

پارامترها
valueInputOption

enum ( ValueInputOption )

چگونه داده های ورودی باید تفسیر شوند.

includeValuesInResponse

boolean

تعیین می کند که آیا پاسخ به روز رسانی باید شامل مقادیر سلول هایی باشد که به روز شده اند یا خیر. به طور پیش فرض، پاسخ ها شامل مقادیر به روز شده نمی شوند. اگر محدوده برای نوشتن بزرگتر از محدوده واقعی نوشته شده بود، پاسخ شامل تمام مقادیر در محدوده درخواستی می شود (به استثنای ردیف ها و ستون های خالی دنباله دار).

responseValueRenderOption

enum ( ValueRenderOption )

تعیین می کند که مقادیر در پاسخ چگونه باید ارائه شوند. گزینه رندر پیش فرض FORMATTED_VALUE است.

responseDateTimeRenderOption

enum ( DateTimeRenderOption )

تعیین می کند که چگونه تاریخ ها، زمان ها و مدت زمان در پاسخ باید ارائه شوند. اگر responseValueRenderOption FORMATTED_VALUE باشد، نادیده گرفته می شود. گزینه پیش‌فرض render dateTime SERIAL_NUMBER است.

درخواست بدن

بدنه درخواست شامل یک نمونه از ValueRange است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از UpdateValuesResponse است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.