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

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