Method: spreadsheets.values.batchClear

یک یا چند محدوده از مقادیر را از یک صفحه گسترده پاک می کند. تماس گیرنده باید شناسه صفحه گسترده و یک یا چند محدوده را مشخص کند. فقط مقادیر پاک می شوند -- تمام خصوصیات دیگر سلول (مانند قالب بندی و اعتبارسنجی داده ها) حفظ می شوند.

درخواست HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear

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

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

پارامترها
spreadsheetId

string

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

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "ranges": [
    string
  ]
}
فیلدها
ranges[]

string

محدوده برای پاک کردن، در نماد A1 یا نماد R1C1 .

بدن پاسخگو

پاسخ هنگام پاک کردن محدوده ای از مقادیر در یک صفحه گسترده.

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

نمایندگی JSON 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
فیلدها
spreadsheetId

string

صفحه‌گسترده‌ای که به‌روزرسانی‌ها روی آن اعمال شد.

clearedRanges[]

string

محدوده هایی که پاک شدند، با نماد A1. اگر درخواست‌ها برای یک محدوده نامحدود یا یک رنجر بزرگتر از محدوده صفحه باشد، این محدوده‌های واقعی پاک شده و محدود به محدودیت‌های برگه است.

محدوده مجوز

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

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

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