- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- آن را امتحان کنید!
مقادیر را در یک یا چند محدوده از یک صفحه گسترده تنظیم می کند. تماس گیرنده باید شناسه صفحه گسترده، یک valueInputOption
و یک یا چند DataFilterValueRanges
را مشخص کند.
درخواست HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
spreadsheetId | شناسه صفحهگسترده برای بهروزرسانی. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "valueInputOption": enum ( |
زمینه های | |
---|---|
valueInputOption | چگونه داده های ورودی باید تفسیر شوند. |
data[] | مقادیر جدید برای اعمال به صفحه گسترده. اگر بیش از یک محدوده با |
includeValuesInResponse | تعیین می کند که آیا پاسخ به روز رسانی باید شامل مقادیر سلول هایی باشد که به روز شده اند یا خیر. به طور پیش فرض، پاسخ ها شامل مقادیر به روز شده نمی شوند. فیلد |
responseValueRenderOption | تعیین می کند که مقادیر در پاسخ چگونه باید ارائه شوند. گزینه رندر پیش فرض |
responseDateTimeRenderOption | تعیین می کند که چگونه تاریخ ها، زمان ها و مدت زمان در پاسخ باید ارائه شوند. اگر |
بدن پاسخگو
پاسخ هنگام به روز رسانی محدوده ای از مقادیر در یک صفحه گسترده.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
زمینه های | |
---|---|
spreadsheetId | صفحهگستردهای که بهروزرسانیها روی آن اعمال شد. |
totalUpdatedRows | تعداد کل ردیف هایی که حداقل یک سلول در آن ردیف به روز شده است. |
totalUpdatedColumns | تعداد کل ستون هایی که حداقل یک سلول در آن ستون به روز شده است. |
totalUpdatedCells | تعداد کل سلولها بهروزرسانی شد. |
totalUpdatedSheets | تعداد کل برگههایی که حداقل یک سلول در آن بهروزرسانی شده است. |
responses[] | پاسخ برای هر محدوده به روز شد. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
DataFilterValueRange
محدوده ای از مقادیر که مکان آنها توسط DataFilter
مشخص شده است.
نمایندگی JSON |
---|
{ "dataFilter": { object ( |
زمینه های | |
---|---|
dataFilter | فیلتر داده که مکان مقادیر را در صفحه گسترده توصیف می کند. |
majorDimension | بعد اصلی ارزش ها |
values[] | داده هایی که باید نوشته شود. اگر مقادیر ارائه شده بیشتر از هر یک از محدوده های مطابق با فیلتر داده باشد، درخواست با شکست مواجه می شود. اگر مقادیر ارائه شده کمتر از محدوده های منطبق باشند، فقط مقادیر مشخص شده نوشته می شوند، مقادیر موجود در محدوده های مطابقت داده شده بدون تأثیر باقی می مانند. |
UpdateValuesByDataFilterResponse
پاسخ هنگام به روز رسانی محدوده ای از مقادیر توسط یک فیلتر داده در یک صفحه گسترده.
نمایندگی JSON |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
زمینه های | |
---|---|
updatedRange | محدوده (در نماد A1 ) که بهروزرسانیها روی آن اعمال شد. |
updatedRows | تعداد ردیف هایی که حداقل یک سلول در آن ردیف به روز شده است. |
updatedColumns | تعداد ستون هایی که حداقل یک سلول در آن ستون به روز شده است. |
updatedCells | تعداد سلولها بهروزرسانی شد. |
dataFilter | فیلتر داده ای که محدوده به روز شده را انتخاب کرده است. |
updatedData | پس از اعمال تمام بهروزرسانیها، مقادیر سلولهای محدوده با dataFilter مطابقت دارد. این فقط در صورتی گنجانده میشود که فیلد |