Method: spreadsheets.values.clear

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
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

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