يؤدي إلى محو القيم من جدول بيانات. يجب أن يحدد المتصل معرِّف جدول البيانات والنطاق. يتم محو القيم فقط -- يتم الاحتفاظ بجميع خصائص الخلية الأخرى (مثل التنسيق والتحقق من صحة البيانات وما إلى ذلك).
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.