يؤدي هذا الإجراء إلى محو نطاق واحد أو أكثر من القيم من جدول بيانات. يجب أن يحدّد المتصل معرّف جدول البيانات وعنصر DataFilters
واحدًا أو أكثر. سيتم محو النطاقات التي تطابق أيًا من فلاتر البيانات المحدّدة. يتم محو القيم فقط -- يتم الاحتفاظ بجميع خصائص الخلية الأخرى (مثل التنسيق والتحقق من صحة البيانات وما إلى ذلك).
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات المطلوب تعديله. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"dataFilters": [
{
object ( |
الحقول | |
---|---|
dataFilters[] |
يتم استخدام |
نص الاستجابة
الرد عند محو نطاق من القيم المحدّدة باستخدام DataFilters
في جدول بيانات
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
الحقول | |
---|---|
spreadsheetId |
جدول البيانات الذي تم تطبيق التعديلات عليه. |
clearedRanges[] |
النطاقات التي تم محوها، في تدوين A1. إذا كانت الطلبات متعلّقة بنطاق غير محدود أو نطاق أوسع من حدود ورقة البيانات، هذه هي النطاقات الفعلية التي تم محوها والمرتبطة بحدود ورقة البيانات. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.