مقادیر را از صفحه گسترده پاک می کند. تماس گیرنده باید شناسه و محدوده صفحه گسترده را مشخص کند. فقط مقادیر پاک می شوند -- تمام خصوصیات دیگر سلول (مانند قالب بندی، اعتبارسنجی داده ها و غیره) حفظ می شوند.
درخواست HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
spreadsheetId | شناسه صفحهگسترده برای بهروزرسانی. |
range | نماد A1 یا نماد R1C1 از مقادیر برای پاک کردن. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ هنگام پاک کردن محدوده ای از مقادیر در یک صفحه گسترده.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "spreadsheetId": string, "clearedRange": string } |
فیلدها | |
---|---|
spreadsheetId | صفحهگستردهای که بهروزرسانیها روی آن اعمال شد. |
clearedRange | محدوده (با نماد A1) که پاک شد. (اگر درخواست یک محدوده نامحدود یا یک رنجر بزرگتر از محدوده برگه بود، این محدوده واقعی پاک شده و محدود به محدوده برگه خواهد بود.) |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.