Method: spreadsheets.values.clear

لمحو القيم من جدول بيانات. يجب أن يحدّد المتصل رقم تعريف جدول البيانات والنطاق. يتم محو القيم فقط، ويتم الاحتفاظ بجميع الخصائص الأخرى للخلية (مثل التنسيق والتحقق من صحة البيانات وما إلى ذلك).

طلب HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
spreadsheetId

string

رقم تعريف جدول البيانات المطلوب تعديله.
range

string

تدوين A1 أو تدوين R1C1 للقيم المطلوب محوها

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

يشير ذلك المصطلح إلى الاستجابة عند محو نطاق من القيم في جدول بيانات.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "spreadsheetId": string,
  "clearedRange": string
}
الحقول
spreadsheetId

string

جدول البيانات الذي تم تطبيق التعديلات عليه.
clearedRange

string

النطاق (في تدوين A1) الذي تم محوه. (إذا كان الطلب يتعلق بنطاق غير محدود أو نطاق أكبر من حدود الورقة، سيكون هذا هو النطاق الفعلي الذي تم محوه، مرتبطًا بحدود الورقة).

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

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