لمحو نطاق أو أكثر من القيم من جدول بيانات. يجب أن يحدد المتصل رقم تعريف جدول البيانات ونطاقًا واحدًا أو أكثر. يتم محو القيم فقط، ويتم الاحتفاظ بجميع الخصائص الأخرى للخلية (مثل التنسيق والتحقق من صحة البيانات).
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات المطلوب تعديله. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "ranges": [ string ] } |
الحقول | |
---|---|
ranges[] |
النطاقات المطلوب مسحها، في تدوين A1 أو تدوين R1C1. |
نص الاستجابة
يشير ذلك المصطلح إلى الاستجابة عند محو نطاق من القيم في جدول بيانات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.