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

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