مقادیر را از صفحه گسترده پاک می کند. تماس گیرنده باید شناسه و محدوده صفحه گسترده را مشخص کند. فقط مقادیر پاک می شوند -- تمام خصوصیات دیگر سلول (مانند قالب بندی، اعتبارسنجی داده ها و غیره) حفظ می شوند.
درخواست HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear
پاسخ هنگام پاک کردن محدوده ای از مقادیر در یک صفحه گسترده.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON
{"spreadsheetId": string,"clearedRange": string}
فیلدها
spreadsheetId
string
صفحهگستردهای که بهروزرسانیها روی آن اعمال شد.
clearedRange
string
محدوده (با نماد A1) که پاک شد. (اگر درخواست یک محدوده نامحدود یا یک رنجر بزرگتر از محدوده برگه بود، این محدوده واقعی پاک شده و محدود به محدوده برگه خواهد بود.)
تاریخ آخرین بهروزرسانی 2024-10-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 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."]]],[]]