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

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