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

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