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

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