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