Method: spreadsheets.values.batchClearByDataFilter

تمحو هذه الدالة نطاقًا واحدًا أو أكثر من القيم من جدول بيانات. لمزيد من المعلومات، يُرجى الاطّلاع على قراءة البيانات الوصفية وكتابتها والبحث فيها.

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

طلب HTTP

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

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

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

المعلمات
spreadsheetId

string

معرّف جدول البيانات المطلوب تعديله.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
الحقول
dataFilters[]

object (DataFilter)

تمثّل هذه السمة DataFilters المستخدَمة لتحديد النطاقات التي سيتم محوها.

نص الاستجابة

الردّ عند محو نطاق من القيم تم اختياره باستخدام DataFilters في جدول بيانات

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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

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