Method: spreadsheets.values.batchClear

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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

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