Method: spreadsheets.values.clear

تمحو القيم من جدول بيانات. على المتصل تحديد رقم تعريف جدول البيانات ونطاقه. يتم محو القيم فقط، ويتم الاحتفاظ بجميع الخصائص الأخرى للخلية (مثل التنسيق والتحقّق من صحة البيانات وما إلى ذلك).

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.