Method: spreadsheets.values.clear
مقادیر را از صفحه گسترده پاک می کند. تماس گیرنده باید شناسه و محدوده صفحه گسترده را مشخص کند. فقط مقادیر پاک می شوند -- تمام خصوصیات دیگر سلول (مانند قالب بندی، اعتبارسنجی داده ها و غیره) حفظ می شوند.
درخواست HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
spreadsheetId | string شناسه صفحه‌گسترده برای به‌روزرسانی. |
range | string نماد A1 یا نماد R1C1 از مقادیر برای پاک کردن. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ هنگام پاک کردن محدوده ای از مقادیر در یک صفحه گسترده.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"spreadsheetId": string,
"clearedRange": string
} |
| فیلدها |
|---|
spreadsheetId | string صفحه‌گسترده‌ای که به‌روزرسانی‌ها روی آن اعمال شد. |
clearedRange | string محدوده (با نماد A1) که پاک شد. (اگر درخواست یک محدوده نامحدود یا یک رنجر بزرگتر از محدوده برگه بود، این محدوده واقعی پاک شده و محدود به محدوده برگه خواهد بود.) |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.file -
https://www.googleapis.com/auth/spreadsheets
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2024-10-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2024-10-25 بهوقت ساعت هماهنگ جهانی."],[[["Clears values from a specified spreadsheet and range while preserving formatting and other cell properties."],["Requires the spreadsheet ID and range in the request URL."],["Sends an empty request body and receives a response indicating the spreadsheet ID and cleared range."],["Needs authorization with specific OAuth scopes like `https://www.googleapis.com/auth/spreadsheets` or similar."]]],["To clear values in a spreadsheet, send a `POST` request to `https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear`. Include the `spreadsheetId` and `range` as path parameters. The request body must be empty. A successful response will contain the `spreadsheetId` and the `clearedRange` in the response body. This operation requires specific authorization scopes like `drive`, `drive.file`, or `spreadsheets`.\n"]]
